Keithley 2461 Reference Manual

Keithley 2461 Reference Manual

1kw pulse mode interactive sourcemeter instrument
Table of Contents

Advertisement

Quick Links

Model 2461 1 kW Pulse Mode
Interactive SourceMeter
Reference Manual
2461-901-01 Rev. A / November 2015
*P246190101A*
2461-901-01A
A Great er Me as u r e of C o nf i d en c e
Instrument
www.keithley.com

Advertisement

Table of Contents
loading

Summary of Contents for Keithley 2461

  • Page 1 Model 2461 1 kW Pulse Mode Interactive SourceMeter Instrument  Reference Manual 2461-901-01 Rev. A / November 2015 *P246190101A* 2461-901-01A A Great er Me as u r e of C o nf i d en c e...
  • Page 2 , and TSP-Net are trademarks of Keithley Instruments. All Keithley Instruments product names are trademarks or registered trademarks of Keithley Instruments. Other brand names are trademarks or registered trademarks of their respective holders. The Lua 5.0 software and associated documentation files are copyright © 1994-2015, Tecgraf, PUC-Rio.
  • Page 3: Safety Precautions

    Keithley Instruments products are designed for use with electrical signals that are measurement, control, and data I/O connections, with low transient overvoltages, and must not be directly connected to mains voltage or to voltage sources with high transient overvoltages.
  • Page 4 (note that selected parts should be purchased only through Keithley 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 5: Table Of Contents

    General operation ..................... 2-1 Power the instrument on or off ..................... 2-2 Front-panel overview ......................2-3 Turn the Model 2461 output on or off ................... 2-6 Rear panel overview ......................2-7 Touchscreen display ......................2-8 Select items on the touchscreen ....................2-9 Scroll bars ..........................
  • Page 6 Model 2461 Interactive SourceMeter® Instrument Reference Manual Model 2461 web interface ....................... 2-73 How to install the Keithley I/O Layer ..................2-79 Modifying, repairing, or removing Keithley I/O Layer software ..........2-80 Determining the command set you will use ............... 2-80 System information ......................2-81 Instrument sounds ......................
  • Page 7 Model 2461 Interactive SourceMeter® Instrument Reference Manual Table of Contents Setting up the Histogram ....................... 2-136 Saving setups ........................2-137 Save a user setup to internal memory ................... 2-137 Save a user setup to a USB flash drive ................. 2-138 Copy a user setup .........................
  • Page 8 Sending commands to TSP-Link nodes ................3-154 Using the reset() command ....................3-154 Terminating scripts on the TSP-Link system ................. 3-155 Triggering using TSP-Link synchronization lines..............3-155 Running simultaneous test scripts ..................3-155 Using Model 2461 TSP-Link commands with other TSP-Link products ........ 3-161...
  • Page 9 Model 2461 Interactive SourceMeter® Instrument Reference Manual Table of Contents TSP-Net ........................... 3-162 Using TSP-Net with any ethernet-enabled instrument ............3-163 Remote instrument events ....................3-164 TSP-Net instrument commands: General device control ............3-164 TSP-Net instrument commands: TSP-enabled device control ..........3-164 Example: Using tspnet commands ..................
  • Page 10 Table of Contents Model 2461 Interactive SourceMeter® Instrument Reference Manual Introduction to SCPI commands ................5-1 Introduction to SCPI ......................5-1 Command execution rules......................5-1 Command messages ........................ 5-1 SCPI command programming notes ..................5-3 SCPI command formatting ......................5-3 Using the SCPI command reference ..................
  • Page 11 Model 2461 Interactive SourceMeter® Instrument Reference Manual Table of Contents OUTPut subsystem ......................6-47 :OUTPut[1]:<function>:SMODe ....................6-47 :OUTPut[1]:INTerlock:TRIPped? ..................... 6-49 :OUTPut[1][:STATe] ........................ 6-49 ROUTe subsystem ......................6-50 :ROUTe:TERMinals ........................ 6-50 SCRipt subsystem ......................6-51 SCRipt:RUN ..........................6-51 SENSe1 subsystem ......................6-52 [:SENSe[1]]:<function>:APERture ...................
  • Page 12 Table of Contents Model 2461 Interactive SourceMeter® Instrument Reference Manual :SOURce[1]:<function>:RANGe:AUTO ................... 6-98 :SOURce[1]:<function>:READ:BACK ..................6-99 :SOURce[1]:LIST:<function> ....................6-101 :SOURce[1]:LIST:<function>:APPend ................... 6-102 :SOURce[1]:LIST:<function>:POINts? .................. 6-103 :SOURce[1]:PULSe:<function>:<x>LIMit[:LEVel] ..............6-104 :SOURce[1]:PULSe:<function>[:LEVel][:IMMediate][:AMPLitude] ........6-105 :SOURce[1]:PULSe:LIST:<function> ..................6-107 :SOURce[1]:PULSe:LIST:<function>:APPend ..............6-108 :SOURce[1]:PULSe:LIST:<function>:POINts? ..............6-109 :SOURce[1]:PULSe:SWEep:<function>:LINear ..............
  • Page 13 Model 2461 Interactive SourceMeter® Instrument Reference Manual Table of Contents :TRACe:DELete ........................6-163 :TRACe:FILL:MODE ......................6-163 :TRACe:LOG:STATe ......................6-164 :TRACe:MAKE ........................6-165 :TRACe:POINts ........................6-167 :TRACe:SAVE ........................6-168 :TRACe:SAVE:APPend ......................6-170 :TRACe:STATistics:AVERage? ..................... 6-171 :TRACe:STATistics:CLEar ....................6-172 :TRACe:STATistics:MAXimum? .................... 6-173 :TRACe:STATistics:MINimum? .....................
  • Page 14 Table of Contents Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRIGger:LAN<n>:OUT:IP:ADDRess ..................6-218 :TRIGger:LAN<n>:OUT:LOGic ....................6-219 :TRIGger:LAN<n>:OUT:PROTocol ..................6-220 :TRIGger:LAN<n>:OUT:STIMulus ..................6-220 :TRIGger:LOAD "ConfigList" ....................6-222 :TRIGger:LOAD "DurationLoop" .................... 6-224 :TRIGger:LOAD "Empty" ....................... 6-225 :TRIGger:LOAD "GradeBinning" ................... 6-226 :TRIGger:LOAD "LogicTrigger" ..................... 6-228 :TRIGger:LOAD "LoopUntilEvent"...
  • Page 15 Model 2461 Interactive SourceMeter® Instrument Reference Manual Table of Contents Configuration list ........................7-41 Display ............................ 7-42 Event log ..........................7-42 File ............................7-42 Instrument identification ......................7-43 Miscellaneous ......................... 7-43 LAN ............................7-43 GPIB ............................7-44 Reading buffer ......................... 7-44 Reset ............................
  • Page 16 Table of Contents Model 2461 Interactive SourceMeter® Instrument Reference Manual bufferVar.sourcestatuses ......................8-31 bufferVar.sourceunits ......................8-32 bufferVar.sourcevalues ......................8-33 bufferVar.startindex ......................... 8-35 bufferVar.statuses ........................8-36 bufferVar.times ........................8-37 bufferVar.timestamps ......................8-38 bufferVar.units ......................... 8-40 buffer.write.format() ......................... 8-41 buffer.write.reading() ....................... 8-43 createconfigscript() ........................
  • Page 17 Model 2461 Interactive SourceMeter® Instrument Reference Manual Table of Contents localnode.settime() ........................8-87 localnode.showevents ......................8-88 localnode.version ........................8-89 node[N].execute() ........................8-90 node[N].getglobal() ........................8-90 node[N].setglobal() ........................8-91 opc() ............................8-92 print() ............................8-92 printbuffer()..........................8-93 printnumber() ........................... 8-96 reset() ............................8-97 localnode.prompts4882 ......................
  • Page 18 Table of Contents Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.measure.displaydigits ....................8-147 smu.measure.filter.count ....................... 8-148 smu.measure.filter.enable ..................... 8-148 smu.measure.filter.type ......................8-149 smu.measure.func ......................... 8-150 smu.measure.limit[Y].audible ....................8-152 smu.measure.limit[Y].autoclear ..................... 8-153 smu.measure.limit[Y].clear()....................8-154 smu.measure.limit[Y].enable ....................8-154 smu.measure.limit[Y].fail ....................... 8-155 smu.measure.limit[Y].high.value ................... 8-157 smu.measure.limit[Y].low.value .....................
  • Page 19 Model 2461 Interactive SourceMeter® Instrument Reference Manual Table of Contents smu.source.xlimit.tripped....................... 8-220 smu.terminals ........................8-220 status.clear() ......................... 8-221 status.condition ........................8-221 status.operation.condition ..................... 8-223 status.operation.enable ......................8-223 status.operation.event ......................8-224 status.operation.getmap() ..................... 8-224 status.operation.setmap()...................... 8-225 status.preset() ........................8-226 status.questionable.condition ....................8-227 status.questionable.enable....................
  • Page 20 Table of Contents Model 2461 Interactive SourceMeter® Instrument Reference Manual trigger.model.setblock() — trigger.BLOCK_BRANCH_COUNTER ........8-274 trigger.model.setblock() — trigger.BLOCK_BRANCH_DELTA ..........8-275 trigger.model.setblock() — trigger.BLOCK_BRANCH_LIMIT_CONSTANT ......8-277 trigger.model.setblock() — trigger.BLOCK_BRANCH_LIMIT_DYNAMIC ......8-278 trigger.model.setblock() — trigger.BLOCK_BRANCH_ON_EVENT ........8-279 trigger.model.setblock() — trigger.BLOCK_BRANCH_ONCE..........8-281 trigger.model.setblock() — trigger.BLOCK_BRANCH_ONCE_EXCLUDED ......8-281 trigger.model.setblock() —...
  • Page 21 How do I upgrade the firmware? ..................9-7 Where can I find updated drivers? ..................9-7 Why can't the Model 2461 read my USB flash drive?............9-7 How do I download measurements onto the USB flash drive? ........... 9-8 How do I save the present state of the instrument? ............9-9 Why did my settings change? ....................
  • Page 22 Table of Contents Model 2461 Interactive SourceMeter® Instrument Reference Manual Why do I keep seeing the "Undefined header" error? ............9-15 Why do I see the "incompatible settings" message? ............9-15 Why do I see the "Query interrupted" error? ..............9-15 Why do I see the "Query unterminated"...
  • Page 23 Buffers ............................D-3 Sweeps ............................. D-4 Trigger model ..........................D-5 Pulsing (Model 2430 feature) ....................D-6 Model 2400 to Model 2461 SCPI command cross-reference ..........D-6 CALCulate[1] subsystem ......................D-6 CALCulate2 subsystem ......................D-7 CALCulate3 subsystem ......................D-10 CONFigure ..........................D-10 DISPlay subsystem .........................
  • Page 24: Introduction

    The Model 2461 can source up to 7 A (10 A pulse), and features 1 A, 4 A, 5 A, 7 A, and 10 A ranges. With 0.012 percent basic accuracy at 6½-digit resolution, the Model 2461 is a good solution for testing a wide variety of materials and devices in applications such as power semiconductors, solar energy, high brightness LEDs, power conversion, electrochemistry, batteries, and more.
  • Page 25: Cd-Rom Contents

    ® The Model 2461 instrument Interactive SourceMeter SMU Instruments Product Information CD-ROM (Keithley Instruments part number 24GDI-950-01) is shipped with each Model 2461 instrument. The Interactive SourceMeter SMU Instruments Product Information CD-ROM contains: • Quick Start Guide: Provides unpacking instructions, describes basic connections, reviews basic operation information, and provides a quick test procedure to ensure the instrument is operational.
  • Page 26: Capabilities And Features

    Status model: Describes the Model 2461 status model. • Converting Model 2400 code to Model 2461 code: Provides information about converting existing Series 2400 SCPI code to Model 2461 code. The PDF version of this manual contains bookmarks for each section. The manual sections are also listed in the Table of Contents at the beginning of this manual.
  • Page 27: General Ratings

    • Supports IEEE-488 (GPIB), USB, and ethernet local area network (LAN) connections General ratings The Model 2461 instrument's general ratings and connections are listed in the following table. Category Specification Supply voltage range...
  • Page 28: General Operation

    General operation In this section: Power the instrument on or off ..........2-2 Front-panel overview ..............2-3 Turn the Model 2461 output on or off ........2-6 Rear panel overview ..............2-7 Touchscreen display ..............2-8 Screen descriptions ..............2-12 Menu overview ...............
  • Page 29: Power The Instrument On Or Off

    Follow the steps below to connect the Model 2461 to line power and turn on the instrument. The Model 2461 operates from a line voltage of 100 V to 240 V at a frequency of 50 Hz or 60 Hz. It automatically senses line voltage and frequency.
  • Page 30: Front-Panel Overview

    3. To turn your instrument off, press the front-panel POWER switch to place it in the off (O) position. Front-panel overview The front panel of the Model 2461 is shown below. Descriptions of the controls on the front panel follow the figure.
  • Page 31 Also stores and retrieves scripts to and from a USB flash drive. The flash drive must be formatted as a FAT drive. The Model 2461 has a high-resolution, five-inch color touchscreen Touchscreen display. The touchscreen accesses swipe screens and menu options.
  • Page 32 1588 LED indicator compliant device. 1588 functionality is not supported at this time. This functionality will be made available with a firmware update. See the Model 2461 Release Notes on the Keithley Instruments website (http://www.keithley.com) for details. Illuminates when the interlock is enabled.
  • Page 33: Turn The Model 2461 Output On Or Off

    Turn the Model 2461 output on or off You can turn the Model 2461 output on from the front panel or by sending remote commands. Turning the Model 2461 output off does not place the instrument in a safe state (an interlock is provided for this function).
  • Page 34: Rear Panel Overview

    Section 2: General operation Rear panel overview The rear panel of the Model 2461 is shown below. Descriptions of the options follow the figure. Figure 3: Model 2461 rear panel Provides connections for sense HI and sense LO, force HI and Screw-terminal force LO, guard, guard sense, and chassis ground.
  • Page 35: Touchscreen Display

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Supports full connectivity on a 10 Mbps or 100 Mbps network. The LAN port Model 2461 is an LXI version 1.4 Core 2011 compliant instrument that supports TCP/IP and complies with IEEE Std 802.3 (ethernet LAN). See LAN communications.
  • Page 36: Select Items On The Touchscreen

    • Turn the navigation control to highlight the item, and then press the navigation control to select it The following topics describe the Model 2461 touchscreen in more detail. Scroll bars Some of the interactive screens have additional options that are only visible when you scroll down the screen.
  • Page 37: Enter Information

    Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Enter information Some of the menu options open a keypad or keyboard that you can use to enter information. For example, if you are setting the GPIB address from the front panel, you see the keypad shown in the following figure.
  • Page 38: Adjust The Backlight Brightness And Dimmer

    Adjust the backlight brightness and dimmer You can adjust the brightness of the Model 2461 touchscreen display and buttons from the front panel or over a remote interface. You can also set the backlight to dim after a specified period has passed with no front-panel activity (available from the front-panel display only).
  • Page 39: Event Messages

    Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual To adjust the backlight using TSP commands: Send the following command: display.lightstate = brightness Where brightness is one of the following options: • Full brightness: display.STATE_LCD_100 • 75 % brightness: display.STATE_LCD_75 •...
  • Page 40: Screen Descriptions

    Home screen This is the default screen that you see whenever you turn the Model 2461 on or when you press the HOME key. The options available on the Home screen are described in the following topics. Figure 7: Model 2461 Home screen...
  • Page 41 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Communications indicator The communications indicator displays the type of communications the instrument is using. Press the indicator to display the present communications settings. Press the Change Settings button at the bottom of the dialog box to change the settings.
  • Page 42 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Active buffer indicator The Active Buffer indicator shows the name of the active reading buffer. Select the indicator to open a menu of available buffers. Select a buffer name in the list to make it the active reading buffer. The name of the new active reading buffer is updated in the indicator bar.
  • Page 43 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Active script indicator This indicator shows script activity and allows you to control script action from the Home screen. If there is no script activity, the indicator displays "No Script." You can select the indicator to display a menu of available scripts.
  • Page 44 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Indicator Meaning Continuous measurement: The instrument is making CONT measurements continuously. Manual trigger mode: Press the front-panel TRIGGER key to initiate a single measurement. Trigger model measurement method. The instrument is running the presently selected trigger model.
  • Page 45 Relative offset is applied Interactive swipe screens The Model 2461 touchscreen display has multiple screens that you can access by gently swiping left or right on the lower half of the display. The options available in the swipe screens are described in the following topics.
  • Page 46 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Swipe screen heading bar The heading bar of the swipe screen contains the following options. Figure 16: Swipe screens, maximized and minimized Screen element Description Minimize indicator You can swipe down to minimize the swipe screens.
  • Page 47 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Source function indicators on the right side of the screen signify settings that affect the displayed source value. • MEAS: Source readback is on and the value shown is the measured value of the source.
  • Page 48: Menu Overview

    You can program custom text that appears on the USER swipe screen. For example, you can program the Model 2461 to show that a test is in process. Refer to the Model 2461 Reference Manual, "Customizing a message for the USER swipe screen"...
  • Page 49: Source Menu

    When you select a Quick Setup, the instrument turns the output on. Carefully consider and configure the appropriate output-off state, source, and limits before connecting the Model 2461 to a device that can deliver energy, such as other voltage sources, batteries, capacitors, or solar cells. Configure the settings that are recommended for the instrument before making connections to the device.
  • Page 50 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Source Settings menu You can change the following settings by pressing the MENU key and selecting Source Settings. Setting Description Set the source range for the selected source function. For more...
  • Page 51 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Source Sweep menu This menu allows you to set up a sweep and generate a source configuration list, simultaneously building the trigger model. Setting Description Select to create a source configuration list and trigger model using Generate the settings on this menu.
  • Page 52 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Source Pulse menu This menu allows you to set up a source pulse sweep and generate a source configuration list and a measure configuration list, simultaneously building the trigger model.
  • Page 53 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Setting Description Not available for the Pulse Train sweep type; the voltage or current source Stop level at which the pulse sweep stops: Current: -10.5 A to 10.5 A •...
  • Page 54: Measure Menu

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Measure menu The Measure menus allow you to select, configure, and perform measure operations from the front panel. The following topics describe the settings that are available on these interactive screens.
  • Page 55 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Measure Calculations menu The Calculations menu contains settings that specify the way measurement information is processed and returned. Setting Description Use the relative offset feature to subtract a set value or a baseline reading from measurement readings.
  • Page 56 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Setting Description When the Math State is set to On, this setting specifies the Zero Reference reference used when the math operation is set to percent; the range is -1e12 to +1e12.
  • Page 57 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Measure Config Lists menu The Config Lists menu allows you to select an existing measure configuration list, create a new list, load configuration settings to and from the instrument (system), and view the settings of an index in a configuration list.
  • Page 58: Views Menu

    Views menu The menus under Views in the main menu allow you to select, configure, and view data from measure operations on the Model 2461. The following topics describe the settings that are available on these interactive screens. 2461-901-01 A/November 2015...
  • Page 59 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Views Graph menu The Graph menu opens a screen that displays a graph of the measurements in selected reading buffers as traces. It also contains tabs that you use to customize the graph display.
  • Page 60 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Data tab The Data tab allows you to select the reading buffer that provides the data that is displayed on the Graph tab. You can select up to four buffers. The data from each buffer is shown as a separate trace on the Graph tab.
  • Page 61 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Scale tab The Scale tab contains settings that allow you to fine-tune the output on the Graph tab. Setting Description The method determines how data is scaled and tracked on the X-Axis Method Graph tab.
  • Page 62 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Views Histogram menu The Histogram menu allows you to graph the distribution of measurement data in the selected reading buffer. It also contains tabs that you use to customize the histogram.
  • Page 63 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Scale tab The Scale tab allows you to set up boundaries, number of bins, and type of scaling used for the histogram. Setting Description The lowest value of the data that is binned in the histogram. Data Minimum Boundary that is below this level is binned in the low outlier bin.
  • Page 64: Trigger Menu

    Section 2: General operation Trigger menu The menus under Trigger in the main menu allow you to configure triggering operations from the Model 2461 front panel. The following topics describe the settings that are available on these interactive screens. Trigger Templates menu The Templates menu allows you to choose from one of several preprogrammed trigger models.
  • Page 65 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Setting Description Creates a trigger model that makes continuous measurements until a specified LoopUntilEvent event occurs. Settings that you can change before generating the trigger model: Source Event (default Trigger Key) •...
  • Page 66: Scripts Menu

    The menus under Scripts in the main menu allow you to configure, run, and manage scripting operations from the Model 2461 front panel. Scripts are blocks of commands that the instrument can run as a group. The following topics describe the settings that are available on these interactive screens.
  • Page 67 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Figure 26: Model 2461 MANAGE SCRIPTS menu Scripts Create Setup menu The Create Setup menu allows you to save the present settings and configuration lists of the instrument into a configuration script. You can use this script to recall the settings.
  • Page 68: System Menu

    System menu The menus under System in the main menu allow you to configure general instrument settings from the Model 2461 front panel. Among these settings are the event log, communications, backlight, time, and password settings. The following topics describe the settings that are available on these interactive screens.
  • Page 69 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Setting Description Turns the display of warnings on or off. If you turn this off, the Show Warning instrument continues to record warnings and display warning popup messages, but does not display them on the System Events tab.
  • Page 70 TSP-Link expansion interface is called a node. Each node must be identified with a unique node number. This identification is called a TSP-Link node number. Select Initialize to have the Model 2461 find all connected TSP- Initialize Link instruments and form a network.
  • Page 71 (SCPI or TSP). Contains the password if the instrument is set to use an access Password mode that requires a password. The Model 2461 is programmed with a default user name and password (case-sensitive): User name: admin •...
  • Page 72: Display Features

    This option initiates a firmware upgrade from a file on a USB flash Upgrade to New drive. This option returns the Model 2461 to a previous version of the Downgrade to Older firmware from a file on a USB flash drive.
  • Page 73: Setting The Number Of Displayed Digits

    Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Setting the number of displayed digits You can set the number of digits that are displayed for measurement readings on the front panel. You can display 3½, 4½, 5½, or 6½ digits. The default is 5½.
  • Page 74: Customizing A Message For The User Swipe Screen

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Figure 29: Exponent display format From the front panel: Press the MENU key. 1. Under System, select Settings. 2. Select the button next to Reading Format. 3. Select the reading format (Prefix or Exponent).
  • Page 75 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Creating a message When you create the message, you can send text that will be used on the top and bottom lines of the USER swipe screen. The top line allows up to 20 characters and the bottom line allows up to 32 characters.
  • Page 76: Creating Messages For Interactive Prompts

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Creating messages for interactive prompts If you are using the TSP command language and scripts, you can set up scripts that can prompt the operator to enter information from the front-panel display of the instrument.
  • Page 77: Handle And Bumpers

    1. Swivel the handle to a position above or below the instrument so that it will not interfere with the removal of the front bumper. 2. Grasp the front bumper on each side of the Model 2461 and gently pull it toward you until the bumper comes off the instrument.
  • Page 78: Dimensions

    Figure 32: Removing the handle 2. Using a Phillips screwdriver, loosen and remove the two screws holding the handle-mount assembly to one side of the Model 2461. The handle-mount assembly will fall away from the instrument chassis when the screws are removed.
  • Page 79 Figure 34: Model 2461 mounting screw locations and dimensions The following figures show the dimensions when the handle and bumpers are installed. Figure 35: Model 2461 dimensions front and rear with handle and bumpers 2-52 2461-901-01 A/November 2015...
  • Page 80 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Figure 36: Model 2461 dimensions side and top with handle and bumpers 2461-901-01 A/November 2015 2-53...
  • Page 81 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual The following figures show the dimensions when the handle and bumpers have been removed. Figure 37: Model 2461 front and rear panel dimensions with handle and bumpers removed 2-54 2461-901-01 A/November 2015...
  • Page 82: Remote Communications Interfaces

    You can choose from one of several communication interfaces to send commands to and receive responses from the Model 2461. You can control the Model 2461 from only one communications interface at a time. The first interface on which it receives a message takes control of the instrument. If another interface sends a message, that interface can take control of the instrument.
  • Page 83: Supported Remote Interfaces

    Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Supported remote interfaces The Model 2461 supports the following remote interfaces: • GPIB: IEEE-488 instrumentation general purpose interface bus • USB: Type B USB port • Ethernet: Local area network ethernet communications •...
  • Page 84: Gpib Setup

    This topic contains information about GPIB standards, bus connections, and primary address selection. The Model 2461 GPIB interface is IEEE Std 488.1 compliant and supports IEEE Std 488.2 common commands and status model topology. You can have up to 15 devices connected to a GPIB interface, including the controller. The maximum cable length is the lesser of either: •...
  • Page 85 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Connect the GPIB cables to your instrument To connect an instrument to the GPIB interface, use a cable equipped with standard GPIB connectors, as shown below. Figure 39: GPIB connector To allow many parallel connections to one instrument, stack the connectors.
  • Page 86 4. Next to Address, select the number. The GPIB Address dialog box is displayed. 5. Enter the address. 6. Select OK. If you are using a Model 2461 with no front panel, you can set the GPIB address with the SCPI command :SYSTem:GPIB:ADDRess (on page 6-152) or the TSP command gpib.address...
  • Page 87 The GPIB has control lines that allow predefined information, called events, to be transferred quickly. The following information lists some of the GPIB line events and how the Model 2461 reacts to them. This event clears the GPIB interface. When the Model 2461 detects a device clear (DCL) event, it does the following: •...
  • Page 88: Lan Communications

    When the Model 2461 detects an SDC event, it will do the following for the selected instrument: • Clears the input buffer, output queue, and command queue •...
  • Page 89 Figure 43: One-to-one connection with a crossover cable The Model 2461 supports Auto-MDIX and can use either normal LAN CAT-5 cables (patch) or crossover cables. The instrument automatically adjusts to support either cable. One-to-many connection With a LAN hub, a single network interface card can be connected to as many instruments as the hub can support.
  • Page 90 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Figure 44: One-to-many connection using a network hub or switch Two network card connection If you need to connect independent corporate and instrumentation networks, two network interface cards are required in the computer controller. Though the two networks are independent, stations on the corporate network can access the instruments, and the instruments can access the corporate network, using the same computer.
  • Page 91 3. Select one of the four tabs (GPIB, USB, LAN, or TSP-Link) to see the settings for that interface. 4. Press the EXIT key to leave the SYSTEM COMMUNICATIONS window without making any changes. If you are using a Model 2461 with no front panel, you can check the settings with the SCPI command :SYSTem:COMMunication:LAN:CONFigure (on page 6-145) or the TSP command lan.ipconfig()
  • Page 92 4. For TCP/IP Mode, select Auto. 5. Select Apply Settings to save your settings. If you are using a Model 2461 with no front panel, you can configure the LAN using SCPI or TSP commands. For details, see the SCPI command...
  • Page 93 1. From the Microsoft Windows Start menu, select Keithley Instruments. 2. Select LXI Discovery Browser. 3. Click LXI Discovery Browser. The Keithley LXI Discovery Browser window is displayed. The LXI Discovery Browser displays the instruments that it finds on the network and their associated IP addresses.
  • Page 94 2 When blinking, indicates that the port is receiving or sending information If neither LED is lit, the network is not connected. LAN interface protocols You can use one of following LAN protocols to communicate with the Model 2461: • Telnet •...
  • Page 95 Telnet is often used for debugging and troubleshooting. You will need a separate Telnet program to use this protocol. The Model 2461 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 96: Usb Communications

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation You can also try restarting the computer and the instrument. To restart the instrument: 1. Turn the instrument's power off, and then on. 2. Wait at least 60 seconds for the network configuration to be completed.
  • Page 97 INSTR: Use the USBTMC protocol To determine these parameters, you can run the Keithley Configuration Panel, which automatically detects all instruments connected to the computer. If you installed the Keithley I/O Layer, you can access the Keithley Configuration Panel through the ® ®...
  • Page 98 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation 3. Click Next. The Select Communication Bus dialog box is displayed. Figure 49: Select Communication Bus dialog box 4. Select USB. 5. Click Next. The Select Instrument Driver dialog box is displayed.
  • Page 99 10. Click Finish. 11. Click Cancel to close the Wizard. 12. Save the configuration. From the Keithley Configuration Panel, select File > Save. Verify the instrument through the Keithley Communicator: 1. Click Start > All Programs > Keithley Instruments > Keithley Communicator.
  • Page 100: Model 2461 Web Interface

    If you have the Agilent IO Libraries on your system, you can run Agilent Connection Expert to check your USB instruments. See the Agilent documentation for information. Model 2461 web interface The Model 2461 web interface allows you to make settings and control your instrument through a web page. The web page includes: •...
  • Page 101 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Figure 53: Model 2461 web page The Home page of the instrument provides information about the instrument. It includes: • The instrument model number, manufacturer, serial number, and firmware revision number.
  • Page 102 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation LXI Home page The LXI Home page displays instrument information, including the host name, MAC address, and VISA resource string. You cannot change the information from this page. You can use the host name instead of the IP address to connect to the instrument.
  • Page 103 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual You may lose your connection with the web interface after clicking Submit. This is normal and does not indicate an error or failure of the operation. If this occurs, find the correct IP address and reopen the web page of the instrument to continue.
  • Page 104 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Using the Model 2461 virtual front panel The Virtual Front Panel page allows you to control the instrument from a computer as if you were using the front panel. You can operate the instrument using a mouse to select options.
  • Page 105 Model 2461 Interactive SourceMeter® Instrument Reference Manual The Model 2461 only allows fewer than three clients to open the virtual front panel web page at the same time. Only the first successfully connected client can operate the instrument. Other clients can only view the virtual front panel.
  • Page 106: How To Install The Keithley I/O Layer

    Keithley Instruments website (http://www.keithley.com) to see if a later version of the Keithley I/O Layer is available. You can install the Keithley I/O Layer from the CD-ROM that came with your instrument, or from the download from the Keithley website.
  • Page 107: Modifying, Repairing, Or Removing Keithley I/O Layer Software

    Keithley SCPI Driver After uninstalling components, reboot the computer. Determining the command set you will use You can change the command set that you use with the Model 2461. The remote command sets that are available include: • SCPI: An instrument-specific language built on the SCPI standard.
  • Page 108: System Information

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation To verify which command set is selected from a remote interface: Send the command: *LANG? To change to the SCPI command set from a remote interface: Send the command: *LANG SCPI Reboot the instrument.
  • Page 109 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual To view system information using SCPI commands: To retrieve the manufacturer, model number, serial number, and firmware version, send the command: *IDN? To read the line frequency, send the command:...
  • Page 110: Instrument Sounds

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Instrument sounds The instrument can emit a beep when a front-panel key is pressed or when a system event occurs. You can turn these beeps on or off. Through the remote interface, you can generate a beep with a defined length and tone. This is typically used as part of code to indicate that something has occurred.
  • Page 111: Test Connections

    You can make test connections to the Model 2461 from the rear or front panel of the instrument. Basic connections The front and rear terminals of the instrument are rated for connection to circuits rated Measurement Category I only, with transients rated less than 1500 V peak above the maximum rated input.
  • Page 112 (DUTs). Figure 56: Model 2461 rear-panel screw terminal connections You can use the Model 2460-KIT Screw Terminal Connector Kit (included with the Model 2461) to make connections to the screw terminal. Each screw in the Model 2460-KIT can accommodate from 26 AWG (0.2 mm...
  • Page 113: Using The Interlock

    ±42 V. The Model 2461 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.
  • Page 114 An interlock circuit is provided on the rear panel of the instrument. This circuit must be closed to enable the Model 2461 to produce voltages greater than ±42 V DC. The interlock is intended for use through a normally open switch, which may be installed on the lid of a test fixture, on the enclosure of a semiconductor prober or device handler, or on the door or doors of a test equipment rack.
  • Page 115: Front- Or Rear-Panel Test Connections

    Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Keithley Instruments connector CS-1616-3, supplied with the Model 2461, can be used to make the interlock connection to the rear panel. You must supply connection wire. To ensure proper interlock operation, the external interlock switch and connection wires must be less than 10 Ω...
  • Page 116: Two-Wire Compared To Four-Wire Measurements

    To change to the rear-panel terminals, send the command: smu.terminals = smu.TERMINALS_REAR Two-wire compared to four-wire measurements You can use 2-wire or 4-wire measurement techniques with the Model 2461. You should use 4-wire, or remote sense, measurement techniques for the following conditions: •...
  • Page 117 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Use 4-wire connections when you are concerned about voltage drops because of lead or contact resistance that could affect measurement accuracy. This can occur on low impedance devices when you are sourcing or measuring voltage, especially in semiconductor device testing.
  • Page 118 Section 2: General operation Two-wire local sense connection drawings Figure 59: Model 2461 2-wire front-panel connections Figure 60: Model 2461 2-wire rear panel connections Using the front panel: 1. Press the FUNCTION key. 2. Select the source and measure combination.
  • Page 119 To further protect against overvoltage situations, you can set overvoltage protection. See Overvoltage protection (on page 2-121) for more information. Always connect the sense lines as close as possible to the device under test. Figure 61: Model 2461 rear panel 4-wire remote sense connections 2-92 2461-901-01 A/November 2015...
  • Page 120 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Figure 62: Model 2461 4-wire sense front panel connection Set the instrument to 4-wire sense To use 4-wire connections, you must set the instrument to 4-wire sense. When 4-wire sense is selected and the output is turned off, the sense lines are internally disconnected.
  • Page 121 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Using TSP commands: To change to 4-wire sensing, send these commands: smu.measure.func = smu.FUNC_DC_VOLTAGE smu.measure.sense = smu.SENSE_4WIRE To assign a different measure function, replace smu.FUNC_DC_VOLTAGE with one of the following: •...
  • Page 122: Test Fixtures

    A test fixture can be used to house a device or test circuit. The test fixture can be a metal or nonconductive enclosure, and is typically equipped with a lid. When the test fixture is correctly connected using the interlock, the output of the Model 2461 will be less than ±42 V when the lid of PEAK the test fixture is opened.
  • Page 123 The Model 2461 includes an interlock connector on the rear panel of the instrument. When properly connected to a test fixture, the output of the Model 2461 is limited to ±42 V when the lid of the test fixture is open.
  • Page 124: Output-Off State

    When the output is off, the SOURCE area of the Home screen shows the source value that is set, not the value that is presently being output. Normal output-off state When the Model 2461 is set to the normal output-off state, the following settings are made when the source is turned off: •...
  • Page 125: High-Impedance Output-Off State

    Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual High-impedance output-off state When the high-impedance output-off state is selected and the output is turned off: • The measurement sense is set to 2-wire • The output relay opens, disconnecting the instrument as a load Opening the relay disconnects external circuitry from the inputs and outputs of the instrument.
  • Page 126: Setting The Output-Off State

    = smu.OFFMODE_HIGHZ To set the output-off state to guard, send the command: smu.source.offmode = smu.OFFMODE_GUARD Source-measure overview Using the Model 2461, you can perform the following operations: • Source voltage and measure current, voltage, resistance, or power • Source current and measure voltage, current, resistance, or power •...
  • Page 127: Source And Measure Order

    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 2461 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 2461 before handling cables.
  • Page 128 When you select a Quick Setup, the instrument turns the output on. Carefully consider and configure the appropriate output-off state, source, and limits before connecting the Model 2461 to a device that can deliver energy, such as other voltage sources, batteries, capacitors, or solar cells. Configure the settings that are recommended for the instrument before making connections to the device.
  • Page 129 DC voltage or DC current to the digitize voltage or digitize current function and vice versa. Source voltage and make measurements When the Model 2461 is sourcing voltage, you can make current, voltage, resistance, or power measurements. Using the front panel: 1.
  • Page 130 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Source current and make measurements When the Model 2461 is sourcing current, you can make current, voltage, resistance, or power measurements. Using the front panel: 1. Connect the device under test (DUT) as described in Test connections (on page 2-83).
  • Page 131 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Adjusting source and limit values using live update When you enable live update on the instrument, you can update source range and source limit values instantly using the navigation control.
  • Page 132 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Making resistance measurements When you make resistance measurements, the resistance is calculated by either sourcing current and measuring voltage or by sourcing voltage and measuring current. When source readback is on, the instrument measures both voltage and current and uses these values in the ohms calculations.
  • Page 133 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Using SCPI: Send the following code: *RST SENSe:FUNCtion "CURR" SENSe:CURRent:RANGe:AUTO ON SENSe:CURRent:UNIT OHM SENSe:CURRent:OCOM ON SOURce:FUNCtion VOLT SOURce:VOLT 5 SOURce:VOLT:ILIM 0.01 SENSe:COUNT 5 OUTPut ON TRACe:TRIGger "defbuffer1" TRACe:DATA? 1, 5, "defbuffer1", SOUR, READ OUTPut OFF The front-panel display will look similar to the following example.
  • Page 134 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation The front-panel display will look similar to the following example. Figure 67: Resistance measurement SVMI and reading ohms Source current, measure voltage, and set measure units to ohms If you want to make resistance readings by sourcing current and measuring voltage, you can use this method.
  • Page 135 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual The front-panel display will look similar to the following example. Figure 68: Resistance measurement SIMV SCPI example Using TSP commands: Send the following code: reset() smu.measure.func = smu.FUNC_DC_VOLTAGE smu.measure.autorange = smu.ON smu.measure.unit = smu.UNIT_OHM...
  • Page 136 Section 2: General operation Measure resistance using the resistance function When the measurement function is set to resistance, the Model 2461 measures resistances by sourcing current. The instrument automatically sets the magnitude of the current source, voltage limit, and the measure range.
  • Page 137 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual The front-panel display will look similar to the following example. Figure 71: Resistance measurement with automatic settings Offset-compensated ohms The voltage offsets caused by the presence of thermoelectric EMFs (V ) can adversely affect resistance measurement accuracy.
  • Page 138: Source And Measure Using Scpi Commands

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Source and measure using SCPI commands The SCPI commands that set up the source functions are in the SOURce subsystem. The source commands are specific to each source function (voltage or current). For example, to set...
  • Page 139 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual The TSP commands that set up the measurement functions begin with smu.measure. The sense commands are also specific to each measure function (voltage, current, or resistance). For example, to set the NPLC cycles to 0.5 for the current measurement function, you would send: smu.measure.func = smu.FUNC_DC_CURRENT...
  • Page 140: Digitize Functions

    Section 2: General operation Digitize functions The Model 2461 digitize functions make fast, predictably spaced measurements. The speed, sensitivity, and bandwidth of the digitize functions allows you to make accurate voltage and current readings of fast signals, such as those associated with sensors, audio, medical devices, power line issues, and industrial processes.
  • Page 141 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Digitize measure connections The connections for front-panel and rear-panel digitize measurements are shown in the following graphics. Figure 72: Front-panel measure connections: Digitize voltage Figure 73: Rear-panel measure connections: Digitize voltage...
  • Page 142: Digitizing Aperture And Sample Rate

    ® Using SCPI or Test Script Processor (TSP ) commands over a remote interface, you can check for excess resistance in the connections from the front and rear panels of the Model 2461 to the DUT. 2461-901-01 A/November 2015 2-115...
  • Page 143: Contact Check Measurements

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Contact check measurements When a contact check command is sent to the Model 2461, the instrument detects measurements that may be in error due to excessive resistance in the force or sense leads when making remote measurements.
  • Page 144: Contact Check Measurement Connections

    The contact check function can be used to verify satisfactory contact resistance to the device under test (DUT) at both the front and rear panels of the Model 2461. Contact check can be run with the instrument in either 2-wire or 4-wire mode. If you run contact check in 2-wire mode, make sure to change the source-measure unit (SMU) to 4-wire (remote sense) mode before measuring to ensure that your measurements are made correctly.
  • Page 145: Contact Check Threshold Resistance

    Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Contact check threshold resistance The contact check threshold resistance level is the resistance value at which the contact check operation indicates a failure. Contact check threshold resistance can be set to one of the following values: •...
  • Page 146: Running Contact Check

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Running contact check You can run a contact check test in one of the following ways: • Check whether there is too much resistance in any connection to the device under test (DUT).
  • Page 147: Contact Check Commands

    For example, if the high connection fails, but the low and guard connections pass, the output will be false,true,true. Contact check commands The following table summarizes the Model 2461 contact check commands, which are described in more detail in the SCPI command reference...
  • Page 148: Protection

    When overvoltage protection is used in a test sequence, it should be set before turning the source on. Even with the overvoltage protection set to the lowest value (2 V), never touch anything connected to the terminals of the Model 2461 when the output is on. Always assume that a hazardous voltage (greater than 30 V ) is present when the output is on.
  • Page 149: Source Limits

    Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Setting overvoltage protection levels Using the front panel: 1. Press the MENU key. 2. Under Source, select Settings. 3. Next to Overvoltage Protection Limit, select the button. 4. Select the limit.
  • Page 150 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation With a source voltage of 10 V and a DUT resistance of 10 Ω, the current through the DUT should be: 10 V / 10 Ω = 1 A. However, because the limit is set to 10 mA, the current will not exceed 10 mA, and the voltage across the resistance is limited to 100 mV.
  • Page 151: Ranges

    Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Ranges You can set ranges for the source and measurement values. You can set specific ranges or allow the instrument to choose the ranges automatically. The source range determines how accurately the source output can be set.
  • Page 152 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Over a remote interface: SCPI commands: Refer to :SOURce[1]:<function>:RANGe (on page 6-97). TSP commands: Refer to smu.source.range (on page 8-207). Selecting the automatic source range When the automatic range is selected, the source-measure cycle is repeated to determine the correct range.
  • Page 153: Measurement Range

    Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Measurement range The measure range determines the full-scale measurement span that is applied to the signal. Therefore, it affects both the accuracy of the measurements and the maximum signal that can be measured.
  • Page 154 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Selecting a specific measure range You need to set the measure function before you can set the measure range. When selecting a measure range, to ensure the best accuracy and resolution, use the lowest range possible that does not cause an overflow event.
  • Page 155 Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual You need to set the measure function before the measure range can be set. If you set the measure range manually for a function, automatic measure range is automatically turned off for that function and remains off until you re-enable it.
  • Page 156: Automatic Reference Measurements

    The time interval between updates to these reference measurements is determined by the integration aperture that is being used for measurements. The Model 2461 uses separate reference and zero measurements for each aperture. By default, the instrument automatically checks the reference measurements whenever a signal measurement is made.
  • Page 157: Source Readback

    The delay provides a settling time for the source. The amount of delay time depends on the settings that are made for the source delay. You can set a manual value, or use the autodelay setting. Figure 77: Model 2461 settling and delay times 2-130 2461-901-01 A/November 2015...
  • Page 158: Setting The Source Delay

    (on page 8-183). Graphing The graphing features of the Model 2461 allow you to view your measurement data graphically. You can compare up to four traces on the front panel of the instrument. You can manipulate the graph to view minimums and maximums, view averages, determine deltas, and view the values of specific data points.
  • Page 159: Setting Up The Graph Tab

    Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Setting up the Graph tab When you start up the instrument, the Graph tab plots data from the active reading buffer as measurements are made. You can change which data is displayed and how it is scaled. These settings are changed on the Data and Scale tabs.
  • Page 160 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Setting up scaling The Scale tab allows you to set up how the data is displayed and tracked on the Graph tab. The X-Axis Method and Y-Axis Method determine how the data is scaled and tracked on the Graph tab.
  • Page 161: Using The Graph Tab

    Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Using the Graph tab You can touch the plot on the Graph tab to zoom in or out on data, display specific data points, or change which area of the graph you are looking at.
  • Page 162: Binning Data With The Histogram

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Using the swipe bar The swipe bar at the bottom of the Graph tab shows which buffers are providing the displayed data, the scale that is used, buffer statistics, and cursors.
  • Page 163: Setting Up The Histogram

    Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Setting up the Histogram To set up the Histogram: 1. Press the MENU key. 2. In the View menu, select Histogram. 3. Select the Data tab. 4. Select the Bin Buffer. This reading buffer contains the data that is binned.
  • Page 164: Saving Setups

    Save a user setup to internal memory From the front panel: 1. Configure the Model 2461 to the settings that you want to save. 2. Press the MENU key. 3. Under Scripts, select Create Setup. The CREATE SETUP window is displayed.
  • Page 165: Save A User Setup To A Usb Flash Drive

    Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Save a user setup to a USB flash drive From the front panel: 1. Save the user setup to internal memory, as described in Save a user setup to internal memory (on page 2-137).
  • Page 166: Delete A User Setup

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Delete a user setup To remove a user setup from internal memory or the USB flash drive from the front panel: 1. Press the MENU key. 2. Under Scripts, select Manage. The MANAGE SCRIPTS window is displayed.
  • Page 167: Define The Setup Used When Power Is Turned On

    Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Define the setup used when power is turned on You can select a configuration to be used when power is turned on. From the front panel: 1. Set the instrument to the settings that you want it to have each time the power is turned on.
  • Page 168: Resets

    Section 2: General operation Resets There are several types of resets in the Model 2461. In general, the terms "reset," "instrument reset," and "system reset" refer to the reset that is performed when you send the *RST or reset() command, or when you select MENU > System >...
  • Page 169: Reset The Instrument

    Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Reset the instrument You can reset many of the instrument settings to their default values. For detail on what gets reset, Reset default values (on page 4-25). Default values are also listed in the command descriptions.
  • Page 170: Information Provided For Each Event Log Entry

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 2: General operation Information provided for each event log entry Each event log entry includes the following information: • The date and time when the event occurred in 24-hour time format (MM/DD HH:MM) •...
  • Page 171: Effects Of Errors On Scripts

    Section 2: General operation Model 2461 Interactive SourceMeter® Instrument Reference Manual The options available on this tab are described in the table below. Settings tab settings Description Turns the display of warnings on or off. If you turn this off, the...
  • Page 172: Functions And Features

    Section 3 Functions and features In this section: Reading buffers ................ 3-2 Saving front-panel settings into a macro script ....... 3-29 Configuration lists ..............3-30 Auto calibration ............... 3-51 Sweep operation ..............3-53 Pulse operation ..............3-64 Instrument access ..............3-77 Relative offset .................
  • Page 173: Reading Buffers

    Reading buffers Reading buffers capture measurements, ranges, the output state of the instrument, and instrument status. The Model 2461 has two default reading buffers. You can also create user-defined reading buffers. Reading buffers provide statistics, including average, minimum, maximum, and standard deviation. If you use SCPI commands over the remote interface, peak-to-peak statistics are also available.
  • Page 174 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Buffer fill status There are several different ways to view buffer fill status from the front panel. As shown in the following figure, the Active buffer indicator (on page 2-15) in the annunciator bar...
  • Page 175 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual The System Events tab on the System Event Log menu (on page 2-41) displays the following buffer events: • Event code 4915, "Attempting to store past the capacity of reading buffer," which occurs when a buffer that is set to fill once is full.
  • Page 176 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Creating buffers To create a new user-defined reading buffer, you need to provide a name, capacity, and style for the new buffer. User-defined buffer names must start with an alphabetic character. The names cannot contain any periods or the underscore (_) character.
  • Page 177 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual 3. Select New. A keyboard is displayed. 4. Enter a name for the buffer you are creating, for example, testData. Figure 87: New Buffer Name 5. Select the OK button on the displayed keyboard.
  • Page 178 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features 8. Select OK. The MANAGE READING BUFFERS window is displayed, showing the buffer you just created. Figure 89: MANAGE READING BUFFERS window 9. Press the HOME key to return to the Home screen.
  • Page 179 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Using TSP commands to create a reading buffer: To create a full reading buffer named testData with a capacity of 200 readings, send the following command: testData = buffer.make(200, buffer.STYLE_FULL) Setting reading buffer options You can specify the settings for the reading buffers.
  • Page 180 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Using the front panel to set buffer capacity: When you resize a reading buffer, data in the buffer is cleared. 1. Press the MENU key. 2. Under Measure, select Reading Buffers. The MANAGE READING BUFFERS window is displayed.
  • Page 181 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Using SCPI commands to set buffer capacity: To set the testData reading buffer to hold 300 readings, send the following command: TRACe:POINts 300, "testData" Using TSP commands to set buffer capacity: To set the testData reading buffer to hold 300 readings, send the following command: testData.capacity = 300...
  • Page 182 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Figure 93: Select the buffer style 5. Select the style. The Initial Capacity dialog box is displayed. 6. Enter the number of readings and select OK. Using SCPI commands to set the buffer style:...
  • Page 183 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Using the front panel to set fill mode: 1. Press the MENU key. 2. Under Measure, select Reading Buffers. The MANAGE READING BUFFERS window is displayed. Figure 94: MANAGE READING BUFFERS window 3.
  • Page 184 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Using SCPI commands to set the buffer fill mode: To set the testData reading buffer fill mode to continuous, send the following command: TRACe:FILL:MODE CONT, "testData" To set the defbuffer1 reading buffer fill mode to fill once, send the following command: TRACe:FILL:MODE ONCE, "defbuffer1"...
  • Page 185 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Using the front panel: 1. Press the MENU key. 2. Under Measure, select Reading Buffers. The MANAGE READING BUFFERS window is displayed. Figure 96: MANAGE READING BUFFERS screen 3.
  • Page 186 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Using SCPI commands to select a reading buffer: To make a measurement and store the readings in a specific reading buffer, send the command: :READ? "<bufferName>" If you do not specify a buffer name, readings are stored in defbuffer1.
  • Page 187 (numbers and text) in plain-text form. You can import the .csv file into a spreadsheet. The Model 2461 does not check for existing files when you save. Verify that you are using a unique name to avoid overwriting any existing .csv files on the flash drive.
  • Page 188 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Figure 98: Example of spreadsheet with reading buffer content Sheet 1 Figure 99: Example of spreadsheet with reading buffer content Sheet 2 The following table describes the information that is stored in each column of the spreadsheet.
  • Page 189 T or F Origin The A/D converter from which the reading originated; for the Model 2461, this will be Main for measure functions or Digitizer for digitize functions. Value Value is the source value when the reading was taken; if readback is ON, it is the measured source value;...
  • Page 190 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Using the front panel to view the contents of a reading buffer: 1. Press the MENU key. 2. Under Views, select Reading Table. Data for the active reading buffer is displayed.
  • Page 191 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Using the front panel to save or append buffer content to files: 1. Insert a USB flash drive into the USB port. 2. Press the MENU key. 3. Under Measure, select Reading Buffers. The MANAGE READING BUFFERS window is displayed.
  • Page 192 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features To append readings and formatted timestamps from a reading buffer named testData to a file named myData.csv on a USB flash drive, send the following command: TRACe:SAVE:APPend "/usb1/myData.csv", "testData"...
  • Page 193 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual 4. Select Clear to clear the buffer. 5. A confirmation message is displayed. Select Yes. 6. Press the HOME key to return to the Home screen. Using SCPI commands to clear a buffer: To clear a user-defined buffer named testData, send the following command: TRACe:CLEar "testData"...
  • Page 194: Remote Buffer Operation

    Section 3: Functions and features Remote buffer operation You can control the Model 2461 buffers through a remote interface using SCPI or TSP remote commands. This section provides a summary of some of the remote commands available to control and access data stored in buffers;...
  • Page 195 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Using TSP commands: Once you create a reading buffer using TSP commands, if you use that buffer name for another buffer or variable, you can no longer access the original buffer.
  • Page 196 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Accessing the data in buffers Using SCPI commands: To access a buffer, include the buffer name in the respective command. For example, the following commands: • Create a buffer named testData to store 100 readings •...
  • Page 197: Reading Buffers

    Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Buffer read-only attributes Use buffer read-only attributes to access the information contained in an existing buffer. Using SCPI commands: The following commands are available for each reading buffer.
  • Page 198 SCPI or Test Script Processor (TSP ) commands. You cannot create a writable buffer from the Model 2461 front panel. The writable buffer is for input of external data only. Be aware that when you create a writable buffer, it immediately becomes the active buffer. If you then try to save readings from the instrument to the writable buffer, errors will occur.
  • Page 199 After you have populated a writable buffer, you can view the data on your computer from the Model 2461 Virtual Front Panel or on the front-panel graph screen. Using graphing through the virtual front panel requires significant system resources and may slow instrument operation.
  • Page 200: Saving Front-Panel Settings Into A Macro Script

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Saving front-panel settings into a macro script You can save some settings made through the front panel into a macro script that you can run later. The settings that are saved include any settings made through: •...
  • Page 201: Running A Macro Script

    Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Running a macro script You can run a macro script from the front panel or from a remote interface. To run a macro script from the front panel: 1.
  • Page 202: What Is A Configuration List

    When you recall a configuration index, you recall the settings in one row. Figure 103: Database of configuration points If you want to use the same configuration list on multiple Model 2461 instruments, you have to recreate it on each instrument. You can do this using one of the following methods: •...
  • Page 203: What Is A Configuration Index

    Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Configuration lists and the trigger model If you think of the trigger model as the execution engine that makes the instrument do things, configuration lists provide a database of stored settings that the trigger model can recall to change the settings of the instrument at any time during trigger model execution.
  • Page 204 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Instrument settings stored in a measure configuration list When you save a configuration index to a measure configuration list, the instrument saves the values for each setting listed in the following table. These settings can be set from the front panel or by using remote commands.
  • Page 205 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Measure configuration list settings Front-panel setting SCPI command TSP command :CALCulate[1]:<function>:MATH:STATe (on page 6-24) Math MENU > Measure > Calculations > Math smu.measure.math.enable (on page 8-158) :CALCulate[1]:<function>:MATH:FORMat (on page 6-19) Math format MENU >...
  • Page 206 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Instrument settings stored in a source configuration list When you save a configuration index to a source configuration list, the instrument saves the values for each setting listed in the following table. These settings can be set from the front panel or by using remote commands.
  • Page 207: Creating, Storing, And Performing Operations On Configuration Lists And Indexes

    Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Creating, storing, and performing operations on configuration lists and indexes To create a configuration index, you need to: • Create a new configuration list and give it a name or use a specific configuration list that already exists on the instrument •...
  • Page 208 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Front-panel configuration list menu overview To display the configuration list menus from the main menu: 1. Press the MENU key. 2. Under Measure, select Config Lists. The MEASURE CONFIGURATION LISTS screen is displayed.
  • Page 209 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Creating a configuration list and giving it a name This example creates a configuration list named MyMeasList. Using the front panel to create the configuration list: 1. Press the MENU key.
  • Page 210 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Storing configuration index 2 Refer to the instructions in Storing configuration index 1 (on page 3-38), and continue as follows to configure the instrument for configuration index 2.
  • Page 211 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Viewing configuration list contents Use the following procedure to view configuration index 2 from MyMeasList. Using the front panel: 1. Press the MENU key. 2. Under Measure, select Config Lists. The MEASURE CONFIGURATION LISTS screen is displayed.
  • Page 212 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Deleting a configuration index Use the following procedure to delete a configuration index from MyMeasList. Using the front panel to delete a configuration index: 1. Press the MENU key.
  • Page 213: Using Remote Commands For Configuration List Operations

    Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Using remote commands for configuration list operations You can use the following remote commands to create and maintain configuration lists. Action SCPI command TSP command Create a configuration list...
  • Page 214 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features The following table provides information about specific settings for each configuration index. Settings Index 1 Index 2 Index 3 Index 4 Function Voltage Voltage Voltage Voltage AutoRange Delay 0.001...
  • Page 215 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Storing configuration index 1 Use one of the following methods to: • Set the instrument source function to voltage • Set the instrument source range to 20 V •...
  • Page 216 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Storing configuration index 2 Use one of the following methods to: • Set the instrument source level to 3.0 V • Store all active source settings to MySourceList as configuration index 2 by appending to the...
  • Page 217 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Storing configuration index 3 Use one of the following methods to: • Set the time it takes to perform the current measurement (the NPLC setting) to 2. •...
  • Page 218 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Storing configuration index 4 Use one of the following methods to: • Set the instrument source level to 5.0 V • Store all active source settings to MySourceList as configuration index 4 by appending to the...
  • Page 219 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Using SCPI commands: :SOURce:CONFiguration:LIST:RECall "MySourceList", 2 For a measure configuration list, replace :SOURce with :SENSe and specify an existing measure configuration list name and index. Using TSP commands: smu.source.configlist.recall("MySourceList", 2)
  • Page 220 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Using SCPI commands: The SCPI configuration list query command returns a list of TSP commands that could be used to set the parameters stored in the specified configuration index.
  • Page 221 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Viewing the available configuration lists You can use remote commands to view the names of the configuration lists stored on the instrument. Using SCPI commands: To receive the name of one source configuration list stored on the instrument, use the following command.
  • Page 222: Autocalibration

    Autocalibration improves short-term accuracy of the Model 2461. However, you must still perform regular full calibration with metrology equipment to maintain overall accuracy. Autocalibration of the Model 2461 is not necessary unless you are using a digitizer function to make readings.
  • Page 223: Reviewing Calibration Information

    Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual To run autocalibration from the front panel: 1. Press the MENU key. 2. Under System, select Calibration. 3. Select Start ACAL. A prompt is displayed. 4. Select Yes. The Start ACAL button turns gray and a spinning activity indicator is displayed while the calibration runs.
  • Page 224: Monitoring Internal Temperature

    Pulse operation (on page 3-64). When you generate the sweep, the Model 2461 creates a source configuration list and a trigger model that contain the settings you selected for the sweep. To run the sweep, press the TRIGGER key. You can also use an initiate command over the remote interface.
  • Page 225: Linear Staircase Sweep

    Each source-measure point is equally spaced between the start and stop. The Model 2461 sends a buffer clear command at the start of a sweep; if you do not want this action, you can change the sweep trigger model to eliminate the clear block.
  • Page 226: Logarithmic Staircase Sweep

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Logarithmic staircase sweep A logarithmic staircase sweep is similar to a linear staircase sweep. The only difference is that the steps are scaled logarithmically. The steps in a logarithmic staircase sweep increase or decrease geometrically, beginning with a start voltage or current and ending with a stop voltage or current.
  • Page 227 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Setting up a sweep from the front panel To set up a sweep from the front panel, you select options from the Sweep Settings screen. Set up the sweep from the front panel 1.
  • Page 228 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Front-panel sweep options Option Description Type You can select one of the following options: Linear: Sets up a linear staircase sweep. • Logarithmic: Sets up a logarithmic staircase sweep.
  • Page 229 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Front-panel sweep options Option Description Count How many times the sweep should repeat. You can select one of the following options: Finite: Set a specific number of times to repeat.
  • Page 230 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features 5. Set the parameters for the sweep command. 6. Set the measurement function using [:SENSe[1]]:FUNCtion. 7. Set the measurement range using [:SENSe[1]]:<function>:RANGe[:UPPer]. 8. Make any other settings appropriate to your sweep.
  • Page 231: Aborting A Sweep

    Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual To create a sweep: 1. Set the source function using smu.source.func. 2. Set the source range using smu.source.range. 3. Set any other source settings that apply to your sweep. You must set source settings before the sweep function is called.
  • Page 232: Sweep Programming Examples

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Using the front panel: Press the front-panel TRIGGER key for two seconds and select Abort Trigger Model. Using SCPI commands: Send the command: :ABORt Using TSP commands: Send the command: trigger.model.abort()
  • Page 233 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Using TSP commands reset() smu.measure.func = smu.FUNC_DC_CURRENT smu.measure.autorange = smu.ON smu.source.func = smu.FUNC_DC_VOLTAGE smu.source.range = 20 smu.source.ilimit.level = 0.02 smu.source.sweeplinear("RES", 0, 10, 21, 200e-3) trigger.model.initiate() waitcomplete() printbuffer(1, 21, defbuffer1.sourcevalues, defbuffer1.readings) Logarithmic sweep with a current source The following examples perform a logarithmic sweep using a current source.
  • Page 234 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Voltage sweep based on a configuration list The following TSP example shows a voltage sweep that is based on a configuration list. It performs the following actions: •...
  • Page 235: Increasing The Speed Of Sweeps

    Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Using TSP commands reset() smu.source.configlist.create("CurrListSweep") smu.source.func = smu.FUNC_DC_CURRENT smu.source.range = 100e-3 smu.source.level = 1e-3 smu.source.configlist.store("CurrListSweep") smu.source.level = 10e-3 smu.source.configlist.store("CurrListSweep") smu.source.level = 5e-3 smu.source.configlist.store("CurrListSweep") smu.source.level = 7e-3 smu.source.configlist.store("CurrListSweep") smu.source.level = 11e-3 smu.source.configlist.store("CurrListSweep")
  • Page 236: Bias Level And Limits

    The pulse bias level is the output level the instruments sources before the first pulse and returns to in between pulses (delay and off time). You can set the bias level of the Model 2461 from -7.35 A to 7.35 A for current and -105 V to 105 V for voltage.
  • Page 237: Pulse Level And Limits

    The pulse level is the amplitude of the current or voltage pulse from zero (not from the bias level). The pulse level of the Model 2461 can be from -10.5 A to 10.5 A for current and -105 V to 105 V for voltage.
  • Page 238: Delay And Off Time

    The delay is the time that the output remains at the bias level before the start of the pulse. Delay on the Model 2461 can be from 0 s to 10,000 s; the default is 1 ms. The off time is the time that the output remains at the bias level after the end of the pulse. Off time can be 0 s to 10,000 s.
  • Page 239: Pulse Rise And Fall Times

    = 10 ms / 100 ms = 0.10 = 10 percent Maximum pulse duty cycle for the Model 2461 is 10 percent for the 20 V and lower ranges, and 5 percent for the 100 V range. 3-68 2461-901-01 A/November 2015...
  • Page 240: Pulse Sweep Type

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Pulse sweep type The Model 2461 supports the following pulse sweep types: • Linear pulse sweep using points or steps • Logarithmic pulse sweep • Dual linear or logarithmic pulse sweep •...
  • Page 241 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Linear pulse sweep In a linear pulse sweep, pulse levels increase or decrease in fixed steps. Each pulse top is equally spaced between the beginning of the pulse sweep and the end of the pulse sweep.
  • Page 242 It must be outside of the range defined by the starting and ending values. When you set up a logarithmic pulse sweep, the Model 2461 sets the order of magnitude for the pulses based on the number of pulse sweep points and the start and stop values.
  • Page 243 The pulse list sweep allows you to set up a custom pulse sweep using a configuration list. You can specify arbitrary pulse steps anywhere within the output range of the Model 2461. When a pulse list sweep is initiated, the output goes from the bias level to the first specified pulse level in the configuration list, and then back to the bias level for a specified delay and off time.
  • Page 244: Pulse Measurements

    Section 3: Functions and features Pulse measurements If the Model 2461 is set to any measure function except digitize, the measurement occurs after the pulse level has settled and before the transition to the bias level. Figure 127: Pulse measurement timing When setting up pulse measurements, configure your measurement settings first, before the pulse settings.
  • Page 245: Setting Up A Pulse Sweep

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Setting up a pulse sweep You can set up and run a pulse sweep from the front panel of the Model 2461 or over a remote ® interface using SCPI or Test Script Processor (TSP ) commands.
  • Page 246 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Setting up a pulse sweep from a remote interface To create and run pulse sweep from a remote interface using SCPI commands: 1. Set the source function using the :SOURce[1]:FUNCTion command.
  • Page 247: Pulse Commands

    Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Pulse commands The following table summarizes the Model 2461 pulse sweep commands, which are described in more detail in the SCPI command reference (on page 6-1) and TSP command reference (on page 8- 1) sections.
  • Page 248: Instrument Access

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Instrument access You can specify that the control interfaces request access before taking control of the instrument. There are several modes of access. You can set one of the following levels of access to the instrument: •...
  • Page 249: Changing The Password

    Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Using SCPI commands Send the command that is appropriate for the level of access you want to enable: SYSTem:ACCess FULL SYSTem:ACCess EXCLusive SYSTem:ACCess PROTected SYSTem:ACCess LOCKout Using TSP commands Send the command that is appropriate for the level of access you want to enable: localnode.access = localnode.ACCESS_FULL...
  • Page 250: Switching Control Interfaces

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Switching control interfaces When the access mode is set to anything other than Full, you need to log in to the instrument from the new interface before you can change any settings.
  • Page 251: Establishing A Relative Offset Value

    Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Establishing a relative offset value You can use the Model 2461 to automatically determine the relative offset, or you can assign a specific relative offset value. Automatically acquiring a relative offset value When you automatically acquire a relative offset value, the Model 2461: •...
  • Page 252: Disabling The Relative Offset

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Setting a relative offset value You can set a specific relative offset value using the front panel or remote commands. Using the front panel: 1. Press the FUNCTION key and select the measure function.
  • Page 253: Calculations That You Can Apply To Measurements

    = smu.OFF To set the relative offset for another function, replace smu.FUNC_DC_VOLTAGE with smu.FUNC_DC_CURRENT or smu.FUNC_RESISTANCE. Calculations that you can apply to measurements The Model 2461 allows you to apply the following math operations to the measurement: • mx+b •...
  • Page 254: Percent

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Percent The percent math function displays measurements as percent deviation from a specified reference constant. The percent calculation is: Where: Percent = The result Input = The measurement (if relative offset is being used, this is the relative offset value) Reference = The user-specified constant The result of the percent calculation is positive when the input is more than the reference.
  • Page 255: Setting Percent Math Operations

    Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Setting percent math operations From the front panel: 1. Press the FUNCTION key and select the measure function. 2. Press the MENU key. 3. Under Measure, select Calculations.
  • Page 256: Setting Reciprocal Math Operations

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Setting reciprocal math operations From the front panel: 1. Press the FUNCTION key and select the measure function. 2. Press the MENU key. 3. Under Measure, select Calculations.
  • Page 257: Digital I/O

    You cannot configure or directly control the digital I/O lines from the front panel. To configure and control any of the six digital input/output lines, you need to send commands to the Model 2461 over a remote interface. You can use either the SCPI or TSP command set. See...
  • Page 258: Digital I/O Port Configuration

    An attached device must be able to sink at least 50 µA from each I/O line. Figure 131: Digital I/O port configuration For additional details about the digital output, see the Model 2461 specifications (available at the Keithley Instruments support website (http://www.keithley.com/support)).
  • Page 259 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Vext line The digital I/O port provides a line (V ) with a flyback diode clamp that you can use when controlling inductive circuitry such as relay coils or low-power solenoids. You can use the built-in 5 V supply or an external voltage supply for these types of applications.
  • Page 260: Digital I/O Lines

    100 kΩ pull-up resistor. This makes the line compatible with other instruments that use open-drain digital I/O lines, such as other Keithley Instruments products that only support open-drain for its digital I/O. In this mode, the line can serve as an input, an output, or both. You can read from the line or write to it.
  • Page 261 These modes either detect or generate transitions in the state of the line, from high to low (falling edge) or from low to high (rising edge). The input edge detection setting of the Model 2461 determines which type of transition is detected as an input trigger. Output triggers are typically generated in the form of a pulse.
  • Page 262 To use synchronous triggering, configure the triggering master to synchronous master trigger mode or the non-Keithley equivalent. Configure all other instruments in the test system to the synchronous acceptor trigger mode or equivalent. Synchronous master Use the synchronous master trigger mode with the synchronous acceptor mode or its non-Keithley equivalent.
  • Page 263 An action overrun occurs if the physical line state is low when a stimulus event occurs. Figure 134: Synchronous master output trigger Synchronous acceptor Use the synchronous acceptor trigger mode with the synchronous master mode or its non-Keithley equivalent. Only one instrument should be configured as a synchronous master. All other instruments connected to the synchronization line must be configured as synchronous acceptor or equivalent.
  • Page 264 Keithley Instrument products. The Model 2461 supports TLINK systems. You can connect the Model 2461 to a TLINK system using the Model 2450-TLINK Trigger Link Cable. Configure the appropriate Model 2461 digital I/O lines as open-drain inputs or outputs for compatibility with TLINK.
  • Page 265: Remote Digital I/O Commands

    Perform basic steady-state digital I/O operations, such as reading and writing to individual I/O lines or reading and writing to the entire port • Trigger the Model 2461 when external trigger pulses are applied to the digital I/O port • Provide trigger pulses to external devices...
  • Page 266: Digital I/O Bit Weighting

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features SCPI command TSP command Description trigger.digout[N].logic (on page 8-245) :TRIGger:DIGital<n>:OUT:PULSewidth (on page 6-214) This command describes the length of time that the trigger line is asserted for output triggers.
  • Page 267 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Using SCPI commands to set the state of each line individually: :DIGital:LINE6:STATe 1 :DIGital:LINE5:STATe 1 :DIGital:LINE4:STATe 0 :DIGital:LINE3:STATe 1 :DIGital:LINE2:STATe 0 :DIGital:LINE1:STATe 1 Using SCPI commands to set all six lines at once by writing the decimal equivalent of the bit pattern to...
  • Page 268 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Reading a bit pattern The programming examples below illustrate how to read part or all of a bit pattern that has been applied to the digital I/O port by an external instrument. The binary pattern is 111111 (63 decimal).
  • Page 269: Measurement Methods

    Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Measurement methods Triggers are signals that instruct the instrument to make a measurement. You can set the Model 2461 to use the following triggering measurement methods: • Continuous measurement: The instrument is making measurements continuously.
  • Page 270: Switching Between Measurement Methods

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Switching between measurement methods The measurement methods that are available to you depend on how you are controlling the instrument. If you are using the front panel to control the instrument, you can choose any of the measurement methods.
  • Page 271: Triggering Using Hardware Lines

    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 2461 ignores the hardware value of the packet and generates a trigger event. The Model 2461 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 272: Trigger Timers

    Make sure to use the same LXI domain on both the Model 2461 instrument and the other instrument. If the Model 2461 has a different LXI domain from the instrument at the other end of the trigger connection, the LXI trigger packets are ignored by both instruments.
  • Page 273 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Count The count sets the number of events to generate each time the timer generates a trigger event. Each event is separated by the delay set by the SCPI :TRIGger:TIMer<n>:DELay or TSP trigger.timer[N].delay command.
  • Page 274 The Model 2461 has 1 to 4 independent timers. For example, you can use a trigger timer to control the delay between non-sequential blocks. After creating a trigger timer, you can insert a notify block to start the timer at a specific point in the trigger model.
  • Page 275: Event Blenders

    The ability to combine trigger events is called event blending. You can use an event blender to wait for up to four input trigger events to occur before responding with an output event. The Model 2461 has 1 or 2 event blenders that you can program. Event blender operations You can use event blenders to perform logical AND or logical OR operations on trigger events.
  • Page 276: Interactive Triggering

    All of the Model 2461 trigger objects have built-in event detectors that monitor for trigger events. The event detector only monitors events generated by that object. They cannot be configured to monitor events generated by any other trigger object.
  • Page 277 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual You can use some trigger objects to generate output triggers on demand. These trigger objects are the digital I/O lines, the TSP-Link synchronization lines, and the LAN. The programming example below generates output triggers using the assert function of the trigger object.
  • Page 278: Trigger Model

    Trigger model The trigger model controls the sequence in which source and measure actions occur. The Model 2461 trigger model is flexible, allowing you to control as much or as little as needed for your measurement application. When you are setting up a trigger model, you can choose the following options: •...
  • Page 279: Trigger Model Blocks

    Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Trigger model blocks Each trigger model consists of blocks that can be combined to create the trigger model. The blocks can be combined from the front panel or by sending remote commands. You can connect a maximum of 63 blocks as needed to control the instrument.
  • Page 280 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features There is a 2 µs delay after the block makes the last measurement in the count. The measure block must be used with a measure function. The trigger model will not run if a digitize function is selected.
  • Page 281 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Digitize block When trigger model execution reaches the block: 1. The instrument begins digitizing measurements. 2. The trigger model execution waits for the measurement to complete. 3. The instrument places the measurements into the specified reading buffer.
  • Page 282 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features When you select the Wait block, the following options are available. Setting Description An event that must occur before the trigger block will continue. Event 1 Optional. Determines if all of the defined events must occur or if at Event Logic least one of the events must occur.
  • Page 283 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Constant delay block When trigger model execution reaches a delay block, it stops normal measurement and trigger model operation for the amount of time set by the delay. Background measurements continue to be made, and if any previously executed block started infinite measurements, they also continue to be made.
  • Page 284 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features When the trigger model executes a notify block, the instrument generates the SCPI event NOTify<n> or TSP event trigger.EVENT_NOTIFYN. You can assign this event to a command that takes an event.
  • Page 285 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Log event block This block allows you to log an event in the event log when trigger model execution reaches this block. You can also force the trigger model to abort with this block. When the trigger model executes the block, the defined event is logged.
  • Page 286 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Config list recall block The configuration list recall block loads a specific index from a configuration list. All parameters that are defined in the configuration index are changed and take effect before this block completes and the next block begins.
  • Page 287 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Config list prev block The config list prev block defines a trigger model block that recalls the settings stored at the previous index in a source or measure configuration list if a single configuration list is specified. If both measure and source configuration lists are specified, measure and source settings are each recalled from the previous index in each list when this block is reached.
  • Page 288 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features When you select the digital I/O block, the following options are available. Setting Description Sets the value that specifies the output line bit pattern (0 to 63) Out Line Pattern...
  • Page 289 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual On event block The branch-on-event block branches to a specified block when a specified trigger event occurs. If the trigger event has not yet occurred when trigger model execution reaches the branch-on-event block, the trigger model continues to execute the blocks in the normal sequence.
  • Page 290 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Constant Limit block The Branch Constant Limit block defines a trigger model block that goes to a specified block if a measurement meets preset criteria. The measurement block must be a measurement block that occurs in the trigger model before the branch-on-constant-limits block.
  • Page 291 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Dynamic Limits block The branch-on-dynamic-limits block defines a trigger model block that goes to a specified block in the trigger model if a measurement meets user-defined criteria. When you define this block, you set: •...
  • Page 292 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features When you select the Delta block, the following options are available. Setting Description The value against which the block compares the difference Target Delta between the measurements The block number of the trigger model block to execute when the...
  • Page 293 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Trigger block summary Front-panel SCPI command Block description icon TSP command Not applicable :TRIGger:BLOCk:LIST? (on page 6-203) This returns the settings for all trigger model trigger.model.getblocklist() (on page 8-258)
  • Page 294 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Front-panel SCPI command Block description icon TSP command :TRIGger:BLOCk:BRANch:ONCE (on page 6-193) This causes the trigger model to branch to a trigger.model.setblock() — trigger.BLOCK_BRANCH_ONCE (on page specified building...
  • Page 295 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Front-panel icon SCPI command Block description TSP command :TRIGger:BLOCk:DIGital:IO (on page 6-201) This trigger model block that sets the lines on the digital trigger.model.setblock() — trigger.BLOCK_DIGITAL_IO (on page 8-...
  • Page 296: Predefined Trigger Models

    Section 3: Functions and features Predefined trigger models The Model 2461 includes predefined trigger models for common applications. You can use these predefined trigger models without changing them, or you can modify them to meet the needs of your application.
  • Page 297 (on page 8-272) Using a predefined trigger model to develop a trigger model The Model 2461 includes predefined trigger models that you can use as a starting point for developing your trigger model. After modifying a predefined trigger model, you can save it in a saved setup for future use. See Saving setups (on page 2-137) for information on how to save a configuration.
  • Page 298: Assembling Trigger Model Blocks

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Assembling trigger model blocks This section describes the basic concepts you need to understand to assemble trigger model blocks. Sequencing trigger model blocks You can set up the trigger model block from the front panel or by using remote commands.
  • Page 299: Running The Trigger Model

    Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Using SCPI commands: To retrieve the settings for all trigger model blocks, send the command: :TRIGger:BLOCk:LIST? Using TSP commands: To check the settings for a block, send the command: print(trigger.model.getblocklist())
  • Page 300 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Starting the trigger model Using the front panel: 1. Press the front-panel TRIGGER key for 2 s. A dialog box displays the available trigger methods. The presently selected method is highlighted.
  • Page 301 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Checking the state of the trigger model The trigger model can be in one of several states. The state is shown in the indicator bar on the Home screen of the instrument. You can also check the status using remote commands.
  • Page 302: Using Trigger Events To Start Actions In The Trigger Model

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Using trigger events to start actions in the trigger model You can set up trigger blocks to respond to trigger events. Trigger events are signals that can be generated by the instrument or by other system components.
  • Page 303 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Trigger events – TSP command set Trigger events Event description Event constant No trigger event trigger.EVENT_NONE Front-panel TRIGGER key press trigger.EVENT_DISPLAY Notify trigger block N (1 to 8) generates a trigger event when trigger.EVENT_NOTIFYN...
  • Page 304 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Using the notify block event When trigger model execution reaches a notify block, the instrument generates a trigger event and immediately continues to the next block. Other commands can reference the event that the notify block generates. This assigns a stimulus somewhere else in the system.
  • Page 305: Limit Testing And Binning

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Limit testing and binning The Model 2461 can be set up for limit testing and binning. It can perform simple benchtop limit testing using the front panel or sophisticated limit and binning operations using the trigger model and digital I/O to control external component-handling devices.
  • Page 306 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features 5. The Auto Clear setting automatically clears the limit fail indicator when a new passing measurement is made. To turn this feature off, select Off. 6. Set the Low Value. If the measurement is below the Low Value, the limit failure indicator is displayed.
  • Page 307: Set Up A Limit Test Using The Remote Interface

    Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Run the test: 1. Press the HOME key. 2. Use 4-wire connections to connect the first resistor to the instrument. 3. Press the OUTPUT ON/OFF switch to turn the source on.
  • Page 308 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features For this example, the same fail bit pattern is assigned to both the lower and upper bounds of the limits so that resistors with resistance values in the range R-P% to R go into the same bin as those with resistance values in the range R to R+P%.
  • Page 309 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Figure 139: Resistor grading example blocks 7 to 18 3-138 2461-901-01 A/November 2015...
  • Page 310 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Figure 140: Resistor grading example blocks 19 to 23 2461-901-01 A/November 2015 3-139...
  • Page 311 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Resistor grading SCPI code Send the following commands for this example application: Command Description Reset the Model 2461. *RST Set the instrument to source current with a SOURce:FUNCtion CURRent range of 10 mA and a voltage limit of 2 V.
  • Page 312 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Clear any existing trigger model commands TRIGger:LOAD:EMPTy from the instrument. Set up the trigger model: TRIGger:BLOCk:BUFFer:CLE 1, "defbuffer1" Block 1: Clear default buffer 1. • TRIG:BLOC:WAIT 2, DIG5 Block 2: Set up a wait block to wait for •...
  • Page 313 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Resistor grading TSP code local number_of_resistors = 100 -- Reset instrument to default settings. reset() -- Measure function must be first measure setting; -- most other settings are tied to the function.
  • Page 314 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features trigger.digout[6].logic = trigger.LOGIC_NEGATIVE -- Set width of output trigger pulse to 10 us. trigger.digout[6].pulsewidth = 10E-6 -- Trigger pulse will be output when Notify Block generates an event.
  • Page 315 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual -- adjust as appropriate. trigger.model.setblock(20, trigger.BLOCK_DELAY_CONSTANT, 0.001) -- Block 21: Set digital I/O lines 1-4; output decimal 0 (binary 0000) -- clear pattern to component handler. trigger.model.setblock(21, trigger.BLOCK_DIGITAL_IO, 0, 15) -- Block 22: Notify block generates event, which causes output -- of a trigger pulse on digital I/O line 6.
  • Page 316 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features The following diagram shows the trigger model flow for the resistor sorting example. Figure 141: Resistor sorting example trigger model 2461-901-01 A/November 2015 3-145...
  • Page 317 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Resistor sorting SCPI code Send the following commands for this example application: Command Description Reset the Model 2461. *RST Set the instrument to source current with a SOUR:FUNC CURR range of 10 mA and a voltage limit of 2 V.
  • Page 318 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Clear any existing trigger model TRIG:LOAD "Empty" commands from the instrument. Set up the trigger model: TRIG:BLOC:BUFF:CLE 1, "defbuffer1" Block 1: Clear default buffer 1. • Block 2: Set up a wait block to wait •...
  • Page 319 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Resistor sorting TSP code -- Create global variable to hold the number of resistors to be tested. -- Can use local variable if all commands are sent to instrument as...
  • Page 320 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features -- Output a falling edge trigger. trigger.digout[6].logic = trigger.LOGIC_NEGATIVE -- Set width of output trigger pulse to 10 us. trigger.digout[6].pulsewidth = 10E-6 -- Trigger pulse will be output when Notify Block generates an event.
  • Page 321: Tsp-Link System Expansion Interface

    It is not available if you are using SCPI commands. TSP-Link connections The Model 2461 has three synchronization lines that are built into the TSP-Link connection. If you are using a TSP-Link network, you do not have to modify any connections.
  • Page 322 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Figure 142: TSP-Link connections Item Description Notes Controller Optional. A computer is not needed for stand- alone systems. Communication connection Optional. Connection from controller to the master node through GPIB, LAN, or USB. Details about...
  • Page 323: Tsp-Link Nodes

    The product serial number of the node. Assigning node numbers Each Model 2461 instrument is initially assigned as node 2. You can assign node numbers from 1 to 64. However, the system can only include 32 physical nodes. The node number for each instrument is stored in its nonvolatile memory and remains in storage when the instrument is turned off.
  • Page 324: Master And Subordinates

    For more information about remote interfaces, see Remote communications interfaces. When linking with earlier models of Keithley instruments such as the Model 2600B, make sure to use the Model 2461 as the master node and the earlier instruments as subordinates. Initializing the TSP-Link system ®...
  • Page 325: Sending Commands To Tsp-Link Nodes

    Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual From the front panel: 1. Power on all instruments connected to the TSP-Link network. 2. Press the MENU key. 3. Under System, select Communication. The SYSTEM COMMUNICATIONS window opens.
  • Page 326: Terminating Scripts On The Tsp-Link System

    Abort Trigger Model from the dialog box that is displayed. Triggering using TSP-Link synchronization lines The Model 2461 has three synchronization lines that you can use for triggering, digital I/O, and to ® synchronize multiple instruments on a TSP-Link network.
  • Page 327 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Using groups to manage nodes on a TSP-Link system TSP-Link groups allow each group to run a different test script simultaneously. This method requires one TSP-Link network and a single remote connection to the computer that is connected to the master node.
  • Page 328 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features 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 329 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual Coordinating overlapped operations in remote groups All overlapped operations on all nodes in a group must have completed before the master node can send a command to the group. If you send a command to a node in a remote group when an overlapped operation is running on any node in that group, errors will occur.
  • Page 330 Use the commands in the following table to perform basic steady-state digital I/O operations; for example, you can program the Model 2461 to read and write to a specific TSP-Link synchronization line or to the entire port. 2461-901-01 A/November 2015...
  • Page 331 Section 3: Functions and features Model 2461 Interactive SourceMeter® Instrument Reference Manual TSP-Link commands Command Description trigger.tsplinkin[N].clear() (on page 8-310) Clears the event detector for a trigger trigger.tsplinkin[N].edge (on page 8-311) Indicates which trigger edge controls the trigger event detector for a trigger line trigger.tsplinkin[N].overrun...
  • Page 332: Using Model 2461 Tsp-Link Commands With Other Tsp-Link Products

    Using Model 2461 TSP-Link commands with other TSP-Link products If you are connecting the Model 2461 in a system with other TSP-Link products, be aware that some of the TSP-Link commands may be different. You can use the earlier versions of the commands, but be aware that they may not be supported in future versions of the product.
  • Page 333: Tsp-Net

    Using TSP-Net commands with TSP-enabled instruments, a Model 2461 can download a script to another TSP-enabled instrument and have both instruments run scripts independently. The Model 2461 can read the data from the remote instrument and either manipulate the data or send the data to a different remote instrument on the LAN.
  • Page 334: Using Tsp-Net With Any Ethernet-Enabled Instrument

    (on page 8-1) for details about the commands presented in this section. The Model 2461 LAN port is auto-sensing (Auto-MDIX), so you can use either a LAN crossover cable or a LAN straight-through cable to connect directly from the Model 2461 to an ethernet device or to a hub. ®...
  • Page 335: Remote Instrument Events

    If the Model 2461 is connected to a TSP-enabled instrument through TSP-Net, all events that occur on the remote instrument are transferred to the event log of the Model 2461. The Model 2461 indicates events from the remote instrument by prefacing these events with “Remote Error.” For example, if the remote instrument generates event code 4909, "Reading buffer not found within...
  • Page 336: Example: Using Tspnet Commands

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 3: Functions and features Example: Using tspnet commands function telnetConnect(ipAddress, userName, password) -- Connect through Telnet to a computer. id = tspnet.connect(ipAddress, 23, "") -- Read the title and login prompt from the computer.
  • Page 337: Source-Measure Considerations

    Reset default values ............... 4-25 Circuit configurations You can measure current or voltage with either type of source. The fundamental source-measure configurations for the Model 2461 are described in the following section. Source current When you configure the instrument to source current, the instrument functions as a high-impedance current source that can limit voltage and can measure current or voltage.
  • Page 338 Section 4: Source-measure considerations Model 2461 Interactive SourceMeter® Instrument Reference Manual The current source does not use the sense leads to enhance current source accuracy. However, if the instrument is in 4-wire sense, the instrument may reach limit levels if you disconnect the sense leads.
  • Page 339: Source Voltage

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 4: Source-measure considerations Source voltage When you configure the instrument to source voltage, it functions like a low-impedance voltage source that can limit current. The instrument can measure current or voltage. This configuration is shown in the figure below.
  • Page 340: Operating Boundaries

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Operating boundaries Operating boundaries define the current and voltage limits of the instrument. The general operating boundaries of the Model 2461 are shown in the following figure. Figure 145: Model 2461 operating boundaries 2461-901-01 A/November 2015...
  • Page 341: Current Source Operating Boundaries

    30 °C (86 °F) or less. Above 30 °C, high power operation could overheat the instrument, causing the output to turn off. The four quadrants of the operating boundaries are defined as I, II, III, and IV. The Model 2461 can operate in any of the four quadrants.
  • Page 342: Voltage Limit Boundary Examples

    200 Ω. The instrument is sourcing 100 mA to the 200 Ω load and subsequently measures 20 V. The load for 200 Ω intersects the 100 mA current source at 20 V. Figure 147: Model 2461 limit boundary example — normal Voltage meter = Current source * DUT load (100 mA)(200 Ω)
  • Page 343: Current Limit Boundary Examples

    In this graph, the resistive load is 2 kΩ. The instrument is sourcing 50 V to the 2 kΩ load and subsequently measures 25 mA. The load for 2 kΩ intersects the 50 V voltage source at 25 mA. Figure 149: Model 2461 current limit boundary example normal 2461-901-01 A/November 2015...
  • Page 344: Output Transient Recovery

    For the 800 Ω DUT, the instrument will only output 40 V at the 50 mA limit. Figure 150: Model 2461 current limit boundary example limited Voltage source = Current * DUT resistance = (50 mA)(800 Ω)
  • Page 345: Using Nplcs To Adjust Speed And Accuracy

    The speed setting affects the normal mode rejection ratio (NMRR) and common mode rejection ratio (CMRR). Normal mode noise is the noise signal between the HI and LO terminals; common-mode noise is the noise signal between LO and chassis ground. See the Model 2461 specification for NMRR and CMRR values at different PLC settings.
  • Page 346 Section 4: Source-measure considerations Model 2461 Interactive SourceMeter® Instrument Reference Manual Using SCPI commands: To set the number of PLCs for current measurements, send the command: :SENSe:CURRent:NPLCycles <n> To set the number of PLCs for resistance measurements, send the command: :SENSe:RESistance:NPLCycles <n>...
  • Page 347: Noise Shield

    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 2461 in a test circuit that may contain hazardous voltages without a properly installed and configured safety shield.
  • Page 348: Safety Shielding

    Grounding Noise and chassis ground Using the chassis as a ground point for signal connections to the Model 2461 chassis may result in different levels of noise, depending on your setup. If the Model 2461 common-mode current is channeled to the chassis instead of the device, the tie point to the chassis can help quiet measurements.
  • Page 349: Floating The Model 2461

    If you use an external source in the test system, you may need the Model 2461 to float off chassis earth ground. An example is shown below, which includes an external voltage source. Notice that output LO of the external voltage source is connected to chassis ground.
  • Page 350 Figure 154: Connections for floating the Model 2461 The external voltage source can be a source-measure unit (SMU) of a second Model 2461 instrument or other instrument. Keep in mind that if the combined outputs of the sources exceed ±42 V, a safety shield is required for the device under test (DUT).
  • Page 351: Guarding

    HI voltage. For 4-wire measurements, it is at the same level as the sense HI voltage. To use the built-in guards of the Model 2461, you must use the rear-panel screw terminal connection. There are no guards available on the front panel.
  • Page 352: Sink Operation

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Sink operation When the Model 2461 is operating as a sink, voltage and current have opposite polarities and the instrument is dissipating power rather than sourcing it. The instrument can be forced into sink operation by an external source, such as a battery, or an energy storage device, such as a capacitor.
  • Page 353 At the start of the test, the battery voltage is less than the voltage output setting of the Model 2461. As a result, this voltage difference drives a current that is immediately limited to the user-defined current limit.
  • Page 354: Timing Information

    When you return power to the instrument, verify that the cooling fan is running. If not, contact Keithley Instruments. Leaving the instrument turned on with the failure message displayed or with an inoperative cooling fan may result in damage to the instrument.
  • Page 355: Calculating Source Or Measure Accuracy

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 4: Source-measure considerations Calculating source or measure accuracy The source and measure accuracy specifications are expressed as a percent of reading or source value and an offset. To calculate source accuracy, use the formula: Accuracy = ±...
  • Page 356 Section 4: Source-measure considerations Model 2461 Interactive SourceMeter® Instrument Reference Manual Voltage measure accuracy: Input signal = (20 Ω x 100 mA) = 2 V Accuracy specification of 2 V range = ± (0.012 % of output + 300 µV) = ±...
  • Page 357: Offset-Compensated Ohm Calculations

    Instrument operations, including offset-compensated ohms, are performed on the input signal in a sequential manner. For a normal resistance measurement, the Model 2461 sources a current (I) and measures the voltage (V). The resistance (R) is then calculated as (R=V/I) and the reading is displayed.
  • Page 358: High-Capacitance Operation

    Model 2461 Interactive SourceMeter® Instrument Reference Manual High-capacitance operation The Model 2461 high-capacitance mode can prevent problems when you are measuring low current and driving a capacitive load. In this situation, you may see overshoot, ringing, and instability. This occurs because the pole formed by the load capacitance and the current range resistor can cause a phase shift in the voltage-control loop of the instrument.
  • Page 359: Filtering Measurement Data

    The Model 2461 has two filter options: repeating average and moving average. The repeating average filter produces slower results, but produces more stable results than the moving average filter.
  • Page 360: Moving Average Filter

    Section 4: Source-measure considerations Model 2461 Interactive SourceMeter® Instrument Reference Manual Moving average filter When the moving average filter is selected, the measurements are added to the stack continuously on a first-in, first-out basis. As each measurement is made, the oldest measurement is removed from the stack.
  • Page 361: Order Of Operations

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 4: Source-measure considerations Order of operations The measurements have filtering, relative offset values, math operations, and limit testing applied to them in a predetermined order. The measurements that are displayed on the front panel and that are stored in the reading buffers represent the measurements with any selected operations applied to them.
  • Page 362: Default Values

    Section 4: Source-measure considerations Model 2461 Interactive SourceMeter® Instrument Reference Manual Default values Math and limit reset values Setting Default value on reset MENU > Measure > Calculations > Filter > Config > Filter Count [:SENSe[1]]:<function>:AVERage:COUNt (on page 6-53) smu.measure.filter.count (on page 8-148) MENU >...
  • Page 363 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 4: Source-measure considerations MENU > Measure > Calculations > Limit2 > Auto Clear :CALCulate2:<function>:LIMit<Y>:CLEar:AUTO (on page 6- smu.measure.limit[Y].autoclear (on page 8-153) –1 MENU > Measure > Calculations > Limit2 > Low Value :CALCulate2:<function>:LIMit<Y>:LOWer[:DATA]...
  • Page 364 Section 4: Source-measure considerations Model 2461 Interactive SourceMeter® Instrument Reference Manual Terminal reset values Setting Default value on reset TERMINALS switch Front :ROUTe:TERMinals (on page 6-50) smu.terminals (on page 8-220) Measurement reset values Setting Default value on reset None (existing Menu >...
  • Page 365 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 4: Source-measure considerations Not available from front panel [:SENSe[1]]:<function>:RELative (on page 6-67) smu.measure.rel.level (on page 8-171) MENU > Measure > Calculations > Rel [:SENSe[1]]:<function>:RELative:STATe (on page 6-69) smu.measure.rel.enable (on page 8-170) 2-wire MENU >...
  • Page 366 Section 4: Source-measure considerations Model 2461 Interactive SourceMeter® Instrument Reference Manual Source reset values Setting Default value on reset None (existing Menu > Source > Config List > New List configuration lists :SOURce[1]:CONFiguration:LIST:CREate (on page 6-83) deleted) smu.source.configlist.create() (on page 8-177) None (existing Menu >...
  • Page 367 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 4: Source-measure considerations Trigger reset values Setting Default value on reset Not available from front panel :TRIGger:BLENder<n>:MODE (on page 6-183) trigger.blender[N].orenable (on page 8-236) Not available from front panel Falling edge :TRIGger:DIGital<n>:IN:EDGE (on page 6-211) trigger.digin[N].edge...
  • Page 368 Section 4: Source-measure considerations Model 2461 Interactive SourceMeter® Instrument Reference Manual Not available from front panel :TRIGger:TIMer<n>:STARt:FRACtional (on page 6-238) trigger.timer[N].start.fractionalseconds (on page 8-306) Not available from front panel :TRIGger:TIMer<n>:STARt:GENerate (on page 6-239) trigger.timer[N].start.generate (on page 8-306) Not available from front panel :TRIGger:TIMer<n>:STARt:SEConds...
  • Page 369: Introduction To Scpi Commands

    The following information describes some basic SCPI command information and how SCPI is used with the Model 2461 and presented in the Model 2461 documentation. Command execution rules Command execution rules are as follows: •...
  • Page 370 Section 5: Introduction to SCPI commands Model 2461 Interactive SourceMeter® Instrument Reference Manual SCPI can also use common commands, which consist of an asterisk (*) followed by three or four letters. For example, you can reset the instrument by sending the following command: *RST The examples above show commands that are sent individually.
  • Page 371: Scpi Command Programming Notes

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 5: Introduction to SCPI commands SCPI command programming notes This section contains general information about using Standard Commands for Programmable Instruments (SCPI). SCPI command formatting This section describes the formatting that this manual uses when discussing SCPI commands.
  • Page 372 Section 5: Introduction to SCPI commands Model 2461 Interactive SourceMeter® Instrument Reference Manual Queries Some commands are queries and others have a query option. These commands have a question mark (?) after the command. You can use the query to determine the present value of the parameters of the command or to get information from the instrument.
  • Page 373: Using The Scpi Command Reference

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 5: Introduction to SCPI commands Using the SCPI command reference The SCPI command reference contains detailed descriptions of each of the SCPI commands that you can use to control your instrument. Each command description is broken into several standard subsections.
  • Page 374 Section 5: Introduction to SCPI commands Model 2461 Interactive SourceMeter® Instrument Reference Manual Command name and summary table Each instrument command description starts with the command name, followed by a table with relevant information for each command. Definitions for the numbered items below are listed following the figure.
  • Page 375 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 5: Introduction to SCPI commands 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 376 Section 5: Introduction to SCPI commands Model 2461 Interactive SourceMeter® Instrument Reference Manual Example section The Example section of the command description shows some simple examples of how the command can be used. Figure 160: SCPI command description code examples 1.
  • Page 377: Acquiring Readings Using Scpi Commands

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 5: Introduction to SCPI commands Acquiring readings using SCPI commands The following table summarizes SCPI commands that acquire and return readings. Command Description Returns the specified data elements from the most recent reading. This command FETCh? does not trigger source-measure operations.
  • Page 378: Scpi Command Reference

    Section 6 SCPI command reference In this section: :FETCh? ................... 6-1 :MEASure? ................6-4 :MEASure:DIGitize? ..............6-7 :READ? ..................6-9 :READ:DIGitize? ..............6-12 *RCL ..................6-15 *SAV ..................6-15 ACAL subsystem ..............6-16 CALCulate subsystem ............6-19 DIGital subsystem ..............6-35 DISPlay subsystem ..............
  • Page 379 Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details This command requests the last available reading from a reading buffer. If you send this command more than once and there are no new readings, the returned values will be the same.
  • Page 380 Measure status questionable 0x0001 STAT_QUESTIONABLE A/D converter from which reading originated; for the 0x0006 STAT_ORIGIN Model 2461, this will always be 0 (main) or 2 (digitizer) Measure terminal, front is 1, rear is 0 0x0008 STAT_TERMINAL Measure status limit 2 low 0x0010...
  • Page 381: Measure

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :MEASure? This command makes measurements, places them in a reading buffer, and returns the last reading. Type Affected by Where saved Default value Query only Not applicable Not applicable...
  • Page 382 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference To change the number of digits returned in a remote command reading, use the :FORMat:ASCii:PRECision command. When specifying buffer elements, you can: • Specify buffer elements in any order.
  • Page 383 Measure status questionable 0x0001 STAT_QUESTIONABLE A/D converter from which reading originated; for the 0x0006 STAT_ORIGIN Model 2461, this will always be 0 (main) or 2 (digitizer) Measure terminal, front is 1, rear is 0 0x0008 STAT_TERMINAL Measure status limit 2 low 0x0010...
  • Page 384: Measure:digitize

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :MEASure:DIGitize? This command makes a digitize measurement, places it in a reading buffer, and returns the reading. Type Affected by Where saved Default value Query only Not applicable...
  • Page 385 Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual When specifying buffer elements, you can: • Specify buffer elements in any order. • Include any or all of the buffer elements listed below in a single list. You can repeat elements as long as the number of elements in the list is less than 14.
  • Page 386: Read

    Measure status questionable 0x0001 STAT_QUESTIONABLE A/D converter from which reading originated; for the 0x0006 STAT_ORIGIN Model 2461, this will always be 0 (main) or 2 (digitizer) Measure terminal, front is 1, rear is 0 0x0008 STAT_TERMINAL Measure status limit 2 low 0x0010...
  • Page 387 Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details This query makes the number of readings specified by [:SENSe[1]]:COUNt. If multiple readings are made, all readings are available in the reading buffer. However, only the last reading is returned as a reading with the command.
  • Page 388 Measure status questionable 0x0001 STAT_QUESTIONABLE A/D converter from which reading originated; for the 0x0006 STAT_ORIGIN Model 2461, this will always be 0 (main) or 2 (digitizer) Measure terminal, front is 1, rear is 0 0x0008 STAT_TERMINAL Measure status limit 2 low 0x0010...
  • Page 389: Read:digitize

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :READ:DIGitize? This query makes a digitize measurement, places it in a reading buffer, and returns the latest reading. Type Affected by Where saved Default value Query only Not applicable...
  • Page 390 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference The options for <bufferElements> are described in the following table. Option Description The date when the data point was measured DATE The measured value as it appears on the front panel...
  • Page 391 Measure status questionable 0x0001 STAT_QUESTIONABLE A/D converter from which reading originated; for the 0x0006 STAT_ORIGIN Model 2461, this will always be 0 (main) or 2 (digitizer) Measure terminal, front is 1, rear is 0 0x0008 STAT_TERMINAL Measure status limit 2 low 0x0010...
  • Page 392: Rcl

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference *RCL This command returns the instrument to the setup that was saved with the *SAV command. Type Affected by Where saved Default value Command only Not applicable Not applicable...
  • Page 393: Acal Subsystem

    Automatic calibration removes measurement errors that are caused by the performance drift on the components used in the source-measure unit (SMU) digitizer as a result of temperature and time. If you are using the digitize functions on the Model 2461, it is important to run the automatic calibration at least once a week.
  • Page 394: Acal:lastrun:temperature:internal

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :ACAL:LASTrun:TEMPerature:INTernal? This command returns the internal temperature of the instrument when autocalibration was run. Type Affected by Where saved Default value Query only Not applicable Nonvolatile memory Not applicable...
  • Page 395: Acal:lastrun:time

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :ACAL:LASTrun:TIME? This command returns the date and time when autocalibration was last run. Type Affected by Where saved Default value Query only Not applicable Not applicable Not applicable...
  • Page 396: Calculate Subsystem

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference CALCulate subsystem The commands in this subsystem configure and control the math and limit operations. :CALCulate[1]:<function>:MATH:FORMat This command specifies which math operation is performed on measurements when math operations are enabled.
  • Page 397: Calculate[1]::Math:mbfactor

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example Set the math function for voltage measurements to :CALC:VOLT:MATH:FORM MXB mx+b. :CALC:VOLT:MATH:MMF 0.80 Set the scale factor for voltage measurements to 0.80. :CALC:VOLT:MATH:MBF 50 Set the offset factor to 50.
  • Page 398 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details This attribute specifies the offset (b) for an mx + b operation. The mx + b math operation lets you manipulate normal display readings (x) mathematically based on...
  • Page 399: Calculate[1]::Math:mmfactor

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :CALCulate[1]:<function>:MATH:MMFactor This command specifies the scale factor, m, for the y = mx + b math operation. Type Affected by Where saved Default value Command and query Recall settings...
  • Page 400: Calculate[1]::Math:percent

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example Set the math function for voltage measurements :CALC:VOLT:MATH:FORM MXB to mx+b. :CALC:VOLT:MATH:MMF 0.80 Set the scale factor for voltage measurements to :CALC:VOLT:MATH:MBF 50 0.80. :CALC:VOLT:MATH:STAT ON Set the offset factor to 50.
  • Page 401: Calculate[1]::Math:state

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Where: • Percent is the result • Input is the measurement (if relative offset is being used, this is the relative offset value) • Reference is the user-specified constant If you send this command without the <function>...
  • Page 402: Calculate2::Limit:Audible

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example Set the math function for voltage measurements to mx+b. :CALC:VOLT:MATH:FORM MXB Set the scale factor for voltage measurements to 0.80. :CALC:VOLT:MATH:MMF 0.80 Set the offset factor to 50.
  • Page 403: Calculate2::Limit:Clear:auto

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example Set limit autoclear off. :CALC2:VOLT:LIM1:CLE:AUTO OFF Enable the beeper for limit 1 when a voltage :CALC2:VOLT:LIM1:AUD FAIL measurement exceeds the limit. :CALC2:VOLT:LIM1:LOW 0.25 Set lower limit 1 for voltage to 0.25 V.
  • Page 404 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details When auto clear is set to on for a measure function, limit conditions are cleared automatically after each measurement. If you are making a series of measurements, the instrument shows the limit test result of the last measurement for the pass or fail indication for the limit.
  • Page 405: Calculate2::Limit:Clear[:Immediate]

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :CALCulate2:<function>:LIMit<Y>:CLEar[:IMMediate] This command clears the results of the limit test defined by Y. Type Affected by Where saved Default value Command only Not applicable Not applicable Not applicable Usage :CALCulate2:<function>:LIMit<Y>:CLEar[:IMMediate]...
  • Page 406: Calculate2::Limit:Fail

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :CALCulate2:<function>:LIMit<Y>:FAIL? This command queries the results of a limit test. Type Affected by Where saved Default value Query only Not applicable Not applicable Not applicable Usage :CALCulate2:<function>:LIMit<Y>:FAIL? The measure function: <function>...
  • Page 407: Calculate2::Limit:Lower[:Data]

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example Set limit autoclear off. :CALC2:VOLT:LIM1:CLE:AUTO OFF Enable the beeper for limit 1 when a voltage :CALC2:VOLT:LIM1:AUD FAIL measurement exceeds the limit. :CALC2:VOLT:LIM1:LOW 0.25 Set lower limit 1 for voltage to 0.25 V.
  • Page 408 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details This command sets the lower limit for the limit Y test for the selected measure function. When limit Y testing is enabled, this causes a fail indication to occur when the measurement value is less than this value.
  • Page 409: Calculate2::Limit:State

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :CALCulate2:<function>:LIMit<Y>:STATe This command enables or disables a limit test on the measurement from the selected measure function. Type Affected by Where saved Default value Command and query Recall settings...
  • Page 410: Calculate2::Limit:Upper[:Data]

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example Set limit autoclear off. :CALC2:VOLT:LIM1:CLE:AUTO OFF Enable the beeper for limit 1 when a voltage :CALC2:VOLT:LIM1:AUD FAIL measurement exceeds the limit. :CALC2:VOLT:LIM1:LOW 0.25 Set lower limit 1 for voltage to 0.25 V.
  • Page 411 Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details This command sets the high limit for the limit Y test for the selected measurement function. When limit Y testing is enabled, the instrument generates a fail indication when the measurement value is more than this value.
  • Page 412: Digital Subsystem

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference DIGital subsystem The commands in the DIGital subsystem control the digital I/O lines. :DIGital:LINE<n>:MODE This command sets the mode of the digital I/O line to be a digital line, trigger line, or synchronous line and sets the line to be input, output, or open-drain.
  • Page 413: Digital:line:State

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Set <lineDirection> to one of the values shown in the following table. Value Description If the type is digital control, this automatically detects externally generated logic levels. You can read an input line, but you cannot write to it.
  • Page 414: Digital:read

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details When the line mode for a digital I/O line is set to digital output (:DIG:LINE<n>:MODE DIG, OUT), you can set the line high or low using the <state> parameter. When the line mode is set to digital input (:DIG:LINE<n>:MODE DIG, IN), you can query the state of the digital input line.
  • Page 415: Digital:write

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example Assume lines 2, 4, and 6 are set high when :DIG:READ? the I/O port is read. Output: This is binary 101010 Also see Digital I/O bit weighting...
  • Page 416: Display Subsystem

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference DISPlay subsystem This subsystem contains commands that control the front-panel display. :DISPlay:CLEar This command clears the text from the front-panel USER swipe screen. Type Affected by Where saved...
  • Page 417: Display::Digits

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :DISPlay:<function>:DIGits This command determines the number of digits that are displayed for measurements on the front panel. Type Affected by Where saved Default value Command and query Recall settings...
  • Page 418: Display:light:state

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example Set the front panel to display current :DISP:CURR:DIG 5 measurements with 5½ digits. Also see :FORMat:ASCii:PRECision (on page 6-44) :DISPlay:LIGHt:STATe This command sets the light output level of the front-panel display.
  • Page 419: Display:reading:format

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :DISPlay:READing:FORMat This command determines the format that is used to display measurement readings on the front-panel display of the instrument. Type Affected by Where saved Default value Command and query...
  • Page 420: Display:user:Text[:Data]

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example Clear and display the USER swipe screen. DISP:CLE Set the first line to read "Batch A122" and DISP:SCR SWIPE_USER the second line to display "Test running". DISP:USER1:TEXT "Batch A122"...
  • Page 421: Format Subsystem

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual FORMat subsystem The commands for this subsystem select the data format that is used to transfer instrument readings over the remote interface. :FORMat:ASCii:PRECision This command sets the precision (number of digits) for all numbers returned in the ASCII format.
  • Page 422: Format:border

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :FORMat:BORDer This command sets the byte order for the IEEE Std. 754 binary formats. Type Affected by Where saved Default value Command and query Recall settings Save settings...
  • Page 423: Format[:Data]

    This command affects the output of READ?, FETCh?, MEASure:<function>?, and TRACe:DATA? queries over a remote interface. All other queries are returned in the ASCII format. The Model 2461 only responds to input commands using the ASCII format, regardless of the data format that is selected for output strings.
  • Page 424: Output Subsystem

    Details This command sets the state of the output when the source is off for the selected function. When the Model 2461 is set to the normal output-off state, the following settings are made when the source is turned off: •...
  • Page 425 Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Opening the relay disconnects external circuitry from the inputs and outputs of the instrument. To prevent excessive wear on the output relay, do not use this output-off state for tests that turn the output off and on frequently.
  • Page 426: Output[1]:Interlock:tripped

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :OUTPut[1]:INTerlock:TRIPped? This command indicates that the interlock has been tripped. Type Affected by Where saved Default value Query only Not applicable Not applicable Not applicable Usage :OUTPut[1]:INTerlock:TRIPped? Details This command gives you the status of the interlock.
  • Page 427: Route Subsystem

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details When the output is switched on, the instrument sources either voltage or current, as set by :SOURce[1]:FUNCtion[:MODE]. Example Switch the source output of the instrument to :OUTP ON...
  • Page 428: Script Subsystem

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference SCRipt subsystem The SCRipt subsystem controls macro or instrument setup scripts. For additional information on macro scripts, refer to Saving front-panel settings into a macro script (on page 3-29).
  • Page 429: Sense1 Subsystem

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual SENSe1 subsystem The SENSe1 subsystem commands configure and control the measurement functions of the instrument. Many of these commands are set for a specific function (current, voltage, or resistance). For example, you can program a range setting for each function.
  • Page 430: [:Sense[1]]::Average:count

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example Set the digitize function to measure current. DIG:FUNC "CURR" Set the sample rate to 1,000,000, with a DIG:CURR:SRATE 1000000 count of 10, and automatic aperture. DIG:CURR:APER AUTO Make a digitize measurement.
  • Page 431 Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example 1 For current measurements, set the averaging CURR:AVER:COUNT 10 filter type to moving average, with a filter count of CURR:AVER:TCON MOV CURR:AVER ON Enable the averaging filter.
  • Page 432: [:Sense[1]]::Average[:State]

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference [:SENSe[1]]:<function>:AVERage[:STATe] This command enables or disables the averaging filter for measurements of the selected function. Type Affected by Where saved Default value Command and query Recall settings Save settings...
  • Page 433: [:Sense[1]]::Average:tcontrol

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual [:SENSe[1]]:<function>:AVERage:TCONtrol This command sets the type of averaging filter that is used for the selected measure function when the measurement filter is enabled. Type Affected by Where saved...
  • Page 434: [:Sense[1]]::Azero[:State]

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example 1 Set the averaging filter type to moving average, CURR:AVER:COUNT 10 with a filter count of 10. CURR:AVER:TCON MOV Enable the averaging filter. CURR:AVER ON Example 2...
  • Page 435 The time interval between updates to these reference measurements is determined by the integration aperture that is being used for measurements. The Model 2461 uses separate reference and zero measurements for each aperture. By default, the instrument automatically checks these reference measurements whenever a signal measurement is made.
  • Page 436: [:Sense[1]]::Delay:user

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference [:SENSe[1]]:<function>:DELay:USER<n> This command sets a user-defined delay that you can use in the trigger model. Type Affected by Where saved Default value Command and query Recall settings Save settings...
  • Page 437: [:Sense[1]]::Nplcycles

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual [:SENSe[1]]:<function>:NPLCycles This command sets the time that the input signal is measured for the selected function. Type Affected by Where saved Default value Command and query Recall settings...
  • Page 438: Sense[1]]::Ocompensated

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example 1 Sets the measurement time for current CURR:NPLC 0.5 measurements to 0.0083 s (0.5/60). Example 2 Sets the measurement time for resistance RES:NPLC 0.5 measurements to 0.0083 s (0.5/60).
  • Page 439: [:Sense[1]]::Range:auto

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example Reset the instrument. *RST Set the measurement function to resistance :SENS:FUNC "RES" and set the range to automatic. :SENS:RES:RANG:AUTO ON Turn offset-compensated ohms on. :RES:OCOM ON Set the measurement count to 5.
  • Page 440: [:Sense[1]]::Range:auto:llimit

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example Set the range to be selected automatically RES:RANG:AUTO ON for resistance measurements. Also see [:SENSe[1]]:<function>:RANGe[:UPPer] (on page 6-65) [:SENSe[1]]:<function>:RANGe:AUTO:LLIMit (on page 6-63) [:SENSe[1]]:<function>:RANGe:AUTO:LLIMit This command selects the lower limit for measurements of the selected function when the range is selected automatically.
  • Page 441: [:Sense[1]]::Range:auto:ulimit

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details You can use this command when automatic range selection is enabled. It prevents the instrument from selecting a range that is below this limit. Because the lowest ranges generally require longer settling times, setting the low limit that is appropriate for your application but above the lowest possible range can make measurements require less settling time.
  • Page 442: [:Sense[1]]::Range[:Upper]

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details This command can be written to and read for resistance measurements. For current and voltage measurements, it can only be read. For current and voltage measurements, the upper limit is controlled by the current or voltage limit.
  • Page 443 Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details You can assign any real number using this command. The instrument selects the closest fixed range that is large enough to measure the entered number. For example, for current measurements, if you expect a reading of approximately 9 mA, set the range to 9 mA to select the 10 mA range.
  • Page 444: [:Sense[1]]::Relative

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference [:SENSe[1]]:<function>:RELative This command contains the relative offset value. Type Affected by Where saved Default value Command and query Recall settings Save settings Instrument reset Measure configuration list Power cycle...
  • Page 445: [:Sense[1]]::Relative:acquire

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual [:SENSe[1]]:<function>:RELative:ACQuire This command acquires a measurement and stores it as the relative offset value. Type Affected by Where saved Default value Command only Not applicable Not applicable Not applicable Usage [:SENSe[1]]:<function>:RELative:ACQuire...
  • Page 446: [:Sense[1]]::Relative:state

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference [:SENSe[1]]:<function>:RELative:STATe This command enables or disables the application of a relative offset value to the measurement. Type Affected by Where saved Default value Command and query Recall settings...
  • Page 447: [:Sense[1]]::Rsense

    IR drop in the output test leads. Using 4-wire sensing with voltage measurements eliminates any voltage drops that may be in the test leads between the Model 2461 and the DUT. When you are using 2-wire sensing, voltage is measured at the output connectors.
  • Page 448: [:Sense[1]]::Srate

    <n> Details The sample rate determines how fast the Model 2461 acquires a digitized reading. Set the sample rate before setting the aperture. If the aperture setting is too high for the selected sample rate, it is automatically adjusted to the highest aperture that can be used with the sample rate.
  • Page 449: [:Sense[1]]::Unit

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual [:SENSe[1]]:<function>:UNIT This command sets the units of measurement that are displayed on the front panel of the instrument and stored in the reading buffer. Type Affected by Where saved...
  • Page 450: [:Sense[1]]:Configuration:list:catalog

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference If the NPLC setting is less than 0.2 PLC, sending autozero once can result in delay of more than a second. This command only applies to measure functions; it does not apply to digitize functions.
  • Page 451: [:Sense[1]]:Configuration:list:create

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual [:SENSe[1]]:CONFiguration:LIST:CREate This command creates an empty measure configuration list. Type Affected by Where saved Default value Command only Recall settings Save settings Not applicable Instrument reset Power cycle Usage [:SENSe[1]]:CONFiguration:LIST:CREate "<name>"...
  • Page 452: [:Sense[1]]:Configuration:list:query

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details Deletes a configuration list. If the index is not specified, the entire configuration list is deleted. If the index is specified, only the specified configuration index in the list is deleted.
  • Page 453: [:Sense[1]]:Configuration:list:recall

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details This command recalls data for one configuration index from the specified measure configuration list and from the source configuration list (if specified). For additional information about the information this command recalls when using a configuration list...
  • Page 454: [:Sense[1]]:Configuration:list:size

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details Use this command to recall the settings stored in a measure configuration index in a specific configuration list. If you do not specify an index when you send the command, it recalls the settings stored in the first configuration index in the specified measure configuration list.
  • Page 455: [:Sense[1]]:Configuration:list:store

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details This command returns the size (number of configuration indexes) of a measure configuration list. The size of the list is equal to the number of configuration indexes in a configuration list.
  • Page 456: [:Sense[1]]:Count

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference [:SENSe[1]]:COUNt This command sets the number of measurements to make when a measurement is requested. Type Affected by Where saved Default value Command and query Recall settings Save settings...
  • Page 457: [:Sense[1]]:Digitize:count

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example Clear data from the reading buffer. :SENS:FUNC "CURR" Set the count to 10. :TRAC:CLEAR Make ten measurements. :COUN 10 Returns the last measurement. :MEAS? Example output: :TRAC:DATA? 1,10 -5.693831E-05...
  • Page 458: [:Sense[1]]:Digitize:function[:On]

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference [:SENSe[1]]:DIGitize:FUNCtion[:ON] This command selects which digitize function is active. Type Affected by Where saved Default value Command and query Recall settings Save settings NONE Instrument reset Measure configuration list...
  • Page 459 Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details Set this command to the type of measurement you want to make. Reading this command returns the measure function that is presently active. Example Make the voltage measurement function the active function.
  • Page 460: Source Subsystem

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference SOURce subsystem The commands in the SOURce subsystem configure and control the current source and voltage source. :SOURce[1]:CONFiguration:LIST:CATalog? This command returns the name of one source configuration list.
  • Page 461: Source[1]:Configuration:list:delete

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details This command creates an empty configuration list. To add configuration indexes to this list, you need to use the store command. Configuration lists are not saved when the instrument is turned off. If you want to save a configuration list, use a saved setup to store the instrument settings, which include defined configuration lists.
  • Page 462: Source[1]:Configuration:list:query

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :SOURce[1]:CONFiguration:LIST:QUERy? This command returns a list of TSP commands and parameter settings that are stored in the specified configuration index. Type Affected by Where saved Default value Query only...
  • Page 463: Source[1]:Configuration:list:recall

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :SOURce[1]:CONFiguration:LIST:RECall This command recalls a specific configuration index in a specific source configuration list and an optional measure configuration list. Type Affected by Where saved Default value Command only...
  • Page 464: Source[1]:Configuration:list:size

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example Recalls configuration index 5 in a configuration list :SOURce:CONF:LIST:REC "MySourceList", 5 named MySourceList. Because an index was not specified, this :SOURce:CONF:LIST:RECall "MySourceList" command recalls configuration index 1 from a configuration list named MySourceList.
  • Page 465: Source[1]:Configuration:list:store

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :SOURce[1]:CONFiguration:LIST:STORe This command stores the active source settings into the named configuration list. Type Affected by Where saved Default value Command only Recall settings Saved settings Not applicable...
  • Page 466: Source[1]::Delay

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :SOURce[1]:<function>:DELay This command contains the source delay. Type Affected by Where saved Default value Command and query Recall settings Save settings Not applicable Instrument reset Source configuration list...
  • Page 467: Source[1]::Delay:auto

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :SOURce[1]:<function>:DELay:AUTO This command enables or disables the automatic delay that occurs when the source is turned on. Type Affected by Where saved Default value Command and query Recall settings...
  • Page 468: Source[1]::Delay:user

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :SOURce[1]:<function>:DELay:USER<n> This command sets a user-defined delay that you can use in the trigger model. Type Affected by Where saved Default value Command and query Recall settings Save settings...
  • Page 469: Source[1]::High:capacitance

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :SOURce[1]:<function>:HIGH:CAPacitance This command enables or disables high-capacitance mode. Type Affected by Where saved Default value Command and query Recall settings Save settings 0 (OFF) Instrument reset Source configuration list...
  • Page 470: Source[1]:[:Level][:Immediate][:Amplitude]

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :SOURce[1]:<function>[:LEVel][:IMMediate][:AMPLitude] This command immediately selects a fixed amplitude for the selected source function. Type Affected by Where saved Default value Command only Recall settings Save settings Instrument reset...
  • Page 471: Source[1]::Limit[:Level]

    Voltage: 0.2 V to 105 V • Details This command sets the source limit for measurements. The Model 2461 cannot source levels that exceed this limit. The values that can be set for this command are limited by the setting for the overvoltage protection limit.
  • Page 472: Source[1]::Limit[:Level]:Tripped

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :SOURce[1]:<function>:<x>LIMit[:LEVel]:TRIPped? This command indicates if the source exceeded the limits that were set for the selected measurements. Type Affected by Where saved Default value Query only Not applicable...
  • Page 473: Source[1]::Protection[:Level]

    When this attribute is used in a test sequence, it should be set before turning the source on. Even with the overvoltage protection set to the lowest value (2 V), never touch anything connected to the terminals of the Model 2461 when the output is on. Always assume that a hazardous voltage (greater than 30 V ) is present when the output is on.
  • Page 474: Source[1]::Protection[:Level]:Tripped

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :SOURce[1]:<function>:PROTection[:LEVel]:TRIPped? This command indicates if the overvoltage source protection feature is active. Type Affected by Where saved Default value Query only Not applicable Not applicable Not applicable Usage...
  • Page 475: Source[1]::Range:auto

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details This command manually selects the measurement range for the specified source. If you select a specific source range, the range must be large enough to source the value. If not, an overrange condition can occur.
  • Page 476: Source[1]::Read:back

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details This command indicates the state of the range for the selected source. When automatic source range is disabled, the source range is set manually. When automatic source range is enabled, the instrument selects the range that is most appropriate for the value that is being sourced.
  • Page 477 Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual When source readback is on, the front-panel display shows the measured source value and the buffer records the measured source value immediately before the device-under-test measurement. When source readback is off, the front-panel display shows the configured source value and the buffer records the configured source value immediately before the device-under-test measurement.
  • Page 478: Source[1]:List:

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :SOURce[1]:LIST:<function> This command allows you to set up a list of custom values for a sweep. Type Affected by Where saved Default value Command and query Recall settings...
  • Page 479: Source[1]:List::Append

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :SOURce[1]:LIST:<function>:APPend This command adds values to the source list for the selected source function. Type Affected by Where saved Default value Command only Recall settings Save settings Not applicable...
  • Page 480: Source[1]:List::Points

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :SOURce[1]:LIST:<function>:POINts? This command queries the length of the source list for the selected source function. Type Affected by Where saved Default value Query only Not applicable Not applicable...
  • Page 481: Source[1]:Pulse::Limit[:Level]

    • Details This command sets the source limit for pulse outputs. The Model 2461 cannot source pulse levels that exceed this limit. The values that can be set for this command are limited by the setting for the overvoltage protection limit.
  • Page 482: Source[1]:Pulse:[:Level][:Immediate][:Amplitude]

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example SOUR:PULS:CURR:VLIM:LEV 15 Sets the voltage source limit to 15 V. Also see Pulse operation (on page 3-64) :SOURce[1]:<function>:PROTection[:LEVel] (on page 6-96) :SOURce[1]:<function>:<x>LIMit[:LEVel] (on page 6-94) :SOURce[1]:<function>:<x>LIMit[:LEVel]:TRIPped? (on page 6-95) :SOURce[1]:PULSe:<function>[:LEVel][:IMMediate][:AMPLitude]...
  • Page 483 Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example SOUR:CONF:LIST:CRE "VoltCustomSweepList" SOUR:PULS:VOLT:LEV 1.17 SOUR:CONF:LIST:STOR "VoltCustomSweepList" SOUR:PULS:VOLT:LEV 1.27 SOUR:CONF:LIST:STOR "VoltCustomSweepList" SOUR:PULS:VOLT:LEV 1.33 SOUR:CONF:LIST:STOR "VoltCustomSweepList" SOUR:PULS:VOLT:LEV 1.39 SOUR:CONF:LIST:STOR "VoltCustomSweepList" SOUR:PULS:SWE:VOLT:LIST 0.03, OFF, "defbuffer1", 1, 3, 0, .005, ON, "VoltCustomSweepList"...
  • Page 484: Source[1]:Pulse:list:

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :SOURce[1]:PULSe:LIST:<function> This command allows you to set up a list of custom values for a pulse sweep. Type Affected by Where saved Default value Command and query Recall settings...
  • Page 485: Source[1]:Pulse:list::Append

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Trigger model (on page 3-107) :SOURce[1]:PULSe:LIST:<function>:APPend This command adds values to the source pulse list for the selected source function. Type Affected by Where saved Default value Command only...
  • Page 486: Source[1]:Pulse:list::Points

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :SOURce[1]:PULSe:LIST:<function>:POINts? This command returns the number of configuration indexes in the source pulse list for the selected source function. Type Affected by Where saved Default value Query only...
  • Page 487: Source[1]:Pulse:sweep::Linear

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :SOURce[1]:PULSe:SWEep:<function>:LINear This command sets up a linear pulse sweep for a fixed number of pulse points. Type Affected by Where saved Default value Command only Recall settings Save settings...
  • Page 488 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Enable or disable measurements at the top of each pulse: <measEnable> Enable: ON (default) • Disable: OFF • A string that indicates the reading buffer; the default buffers (defbuffer1 or <bufferName>...
  • Page 489 Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example *RST SOUR:FUNC VOLT SOUR:VOLT:READ:BACK ON DIG:FUNC "CURR" DIG:CURR:RANG 1 DIG:CURR:SRAT 50000 SOUR:PULS:SWE:VOLT:LIN 0, 0, 70, 8, 2e-3, ON, "defbuffer1", 10e-3, 10e-3, 2, .1, 1, ON, ON INIT Reset the instrument to its default settings.
  • Page 490: Source[1]:Pulse:sweep::Linear:step

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :SOURce[1]:PULSe:SWEep:<function>:LINear:STEP This command sets up a linear source pulse sweep configuration list model with a fixed number of steps. Type Affected by Where saved Default value Command only...
  • Page 491 Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual The time at the amplitude level for each pulse: <pulseWidth> Extended operating area: 10 A at 100 V, 5 % duty cycle, maximum pulse • width: 1 ms, minimum pulse width 150 µs (load dependent) Normal operating area (DC): 99.99 % duty cycle, maximum pulse width...
  • Page 492 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference When you specify a delay, a delay block is added to the pulse sweep trigger model. This delay is added to any source delay you may have set. For example, if you set 10 ms for the source delay and 25 ms for the delay in the pulse log sweep command, the actual delay is 35 ms.
  • Page 493: Source[1]:Pulse:sweep::List

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :SOURce[1]:PULSe:SWEep:<function>:LIST This command sets up a pulse sweep based on a configuration list, which allows you to customize the sweep. Type Affected by Where saved Default value Command only...
  • Page 494 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details This command allows you to set up a custom pulse sweep using a configuration list to specify the pulse levels. Before configuring a pulse operation, configure your measure settings. Pulse operations use the measure settings that were last defined before the pulse operation;...
  • Page 495: Source[1]:Pulse:sweep::Log

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Also see Configuration lists (on page 3-30) :INITiate[:IMMediate] (on page 6-182) Pulse operation (on page 3-64) :SOURce[1]:PULSe:LIST:<function> (on page 6-107) :SOURce[1]:PULSe:SWEep:<function>:LOG This command sets up a logarithmic pulse sweep for a set number of source points.
  • Page 496 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference The source function: <function> Voltage pulse sweep: VOLTage • Current pulse sweep: CURRent • Output level the instrument sources before the first pulse and returns to between <biasLevel>...
  • Page 497 Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Before configuring a pulse operation, configure your measure settings. Pulse operations use the measure settings that were last defined before the pulse operation; you may get unexpected results if you do not define the measure settings first.
  • Page 498: Source[1]:Pulse:train:

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :SOURce[1]:PULSe:TRain:<function> This command defines a sequence of source pulses and creates a trigger model to generate the pulse train. Type Affected by Where saved Default value Command only...
  • Page 499 The bias level must be within the normal DC operating area (not the extended area) of the operating boundaries. It must be low enough that it does not exceed the power settings defined by the bias limit and pulse limit parameters. For more information about the Model 2461 operating boundaries, see Operating boundaries (on page 4-4).
  • Page 500 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example *RST *CLS DIG:FUNC "CURR" DIG:CURR:RANG 10e-3 DIG:CURR:SRAT 25000 SOUR:FUNC VOLT SOUR:VOLT:READ:BACK ON SOUR:PULS:TR:VOLT 1e-3, 3e-3, 10e-3, 3, ON, "defbuffer1", 0, 90e-3, 5e-3, 5e-3 INIT *WAI Reset the instrument to its default settings and clear event registers and queues. Set the digitize function to current and the digitize sample rate to 25,000 readings per second.
  • Page 501: Source[1]:Sweep::Linear

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :SOURce[1]:SWEep:<function>:LINear This command sets up a linear sweep for a fixed number of measurement points. Type Affected by Where saved Default value Command only Recall settings Save settings...
  • Page 502 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details When the sweep is started, the instrument sources a specific voltage or current value to the device under test (DUT). A measurement is made for each point of the sweep.
  • Page 503: Source[1]:Sweep::Linear:step

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :SOURce[1]:SWEep:<function>:LINear:STEP This command sets up a linear source sweep configuration list and trigger model with a fixed number of steps. Type Affected by Where saved Default value Command only...
  • Page 504 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details When the sweep is started, the instrument sources a specific voltage or current voltage to the device under test (DUT). A measurement is made for each point of the sweep.
  • Page 505: Source[1]:Sweep::List

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :SOURce[1]:SWEep:<function>:LIST This command sets up a sweep based on a configuration list, which allows you to customize the sweep. Type Affected by Where saved Default value Command only...
  • Page 506 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example 1 *RST SENS:FUNC "CURR" SENS:CURR:RANG:AUTO ON SENS:CURR:RSEN OFF SOUR:FUNC VOLT SOUR:VOLT:RANG 20 SOUR:VOLT:ILIM 1 SOUR:LIST:VOLT 1, 5, 1, 5, 1, 5 SOUR:SWE:VOLT:LIST 1, 0.2 INIT *WAI TRAC:DATA? 1, 6, "defbuffer1", SOUR, READ This example uses the :SOURce[1]:LIST:<function>...
  • Page 507: Source[1]:Sweep::Log

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :SOURce[1]:SWEep:<function>:LOG This command sets up a logarithmic sweep for a set number of measurement points. Type Affected by Where saved Default value Command only Recall settings Save settings...
  • Page 508 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference A string that indicates the reading buffer; the default buffers (defbuffer1 or <bufferName> defbuffer2) or the name of a user-defined buffer; if no buffer is specified, defbuffer1 is used Default is 0;...
  • Page 509 Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example *RST SOUR:FUNC VOLT SOUR:VOLT:RANG 20 SENS:FUNC "CURR" SENS:CURR:RANG 100e-6 SOUR:SWE:VOLT:LOG .1, 10, 20, 1e-3, 1, FIXED INIT Reset the instrument to its defaults. Set the source function to voltage.
  • Page 510: Status Subsystem

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference STATus subsystem The STATus subsystem controls the status registers of the instrument. For additional information on the status model, see Status model (on page C-1). :STATus:CLEar This function clears event registers and the event log.
  • Page 511: Status:operation:enable

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :STATus:OPERation:ENABle This command sets or reads the contents of the Operation Event Enable Register of the status model. Type Affected by Where saved Default value Command and query...
  • Page 512: Status:operation:map

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details This attribute reads the operation event register of the status model. The instrument returns a decimal value that corresponds to the binary-weighted sum of all bits set in the register.
  • Page 513: Status:preset

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example When event 4916 (the buffer is 0 % filled) :STATus:OPERation:MAP 0, 4916, 4917 occurs, bit 0 is set in the condition register and the event register of the Operation Event Register.
  • Page 514: Status:questionable:enable

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example Reads the Questionable Condition Register. :STAT:QUES:COND? Also see Questionable Event Register (on page C-7) Understanding bit settings (on page C-16) :STATus:QUEStionable:ENABle This command sets or reads the contents of the questionable event enable register of the status model.
  • Page 515: Status:questionable[:Event]

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :STATus:QUEStionable[:EVENt]? This command reads the Questionable Event Register. Type Affected by Where saved Default value Query only Not applicable Not applicable Not applicable Usage :STATus:QUEStionable[:EVENt]? Details This query reads the contents of the questionable status event register. After sending this command and addressing the instrument to talk, a value is sent to the computer.
  • Page 516: Status:questionable:map

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :STATus:QUEStionable:MAP This command queries mapped event numbers or maps event numbers to bits in the event registers. Type Affected by Where saved Default value Command and query Not applicable...
  • Page 517: System Subsystem

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual SYSTem subsystem This subsystem contains commands that affect the overall operation of the instrument, such as passwords, beepers, communications, event logs, and time. :SYSTem:ACCess This command contains the type of access users have to the instrument through different interfaces.
  • Page 518: System:beeper[:Immediate]

    For example, you can use the beeper to signal the end of a lengthy sweep. Using this function from a remote interface does not affect audible errors or key click settings that were made from the Model 2461 front panel. Example Beep at 500 Hz for 1 s.
  • Page 519: System:ccheck

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :SYSTem:CCHeck? This command indicates whether one or more connections failed the contact check operation. Type Affected by Where saved Default value Query only Not applicable Not applicable Not applicable...
  • Page 520: System:ccheck:state

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference If sending the :SYSTem:CCHeck? command indicates a failure, you can use this command to determine which connection failed. Sending this command when contact check is not enabled results in an error.
  • Page 521: System:ccheck:threshold

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :SYSTem:CCHeck:THReshold This command sets the threshold value for contact resistance for the contact check status functions. Type Affected by Where saved Default value Command and query Instrument reset...
  • Page 522: System:clear

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :SYSTem:CLEar This command clears the event log. Type Affected by Where saved Default value Command only Not applicable Not applicable Not applicable Usage :SYSTem:CLEar Details This command removes all events from the event log, including entries in the front-panel event log.
  • Page 523: System:communication:lan:macaddress

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details This command specifies how the LAN IP address and other LAN settings are assigned. If automatic configuration is selected, the instrument automatically determines the LAN information. When method is automatic, the instrument first attempts to configure the LAN settings using dynamic host configuration protocol (DHCP).
  • Page 524: System:error[:Next]

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example Returns the MAC address. For example, you :SYSTem:COMMunication:LAN:MACaddress? might see: 08:00:11:00:00:57 Also see :SYSTem:COMMunication:LAN:CONFigure (on page 6-145) :SYSTem:ERRor[:NEXT]? This command returns the oldest unread error message from the event log and removes it from the log.
  • Page 525: System:error:code[:Next]

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :SYSTem:ERRor:CODE[:NEXT]? This command reads the oldest error code. Type Affected by Where saved Default value Query only Not applicable Not applicable Not applicable Usage :SYSTem:ERRor:CODE[:NEXT]? Details This command returns the numeric code of the next error in the event log. The error is cleared from the queue after being read.
  • Page 526: System:eventlog:count

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :SYSTem:EVENtlog:COUNt? This command returns the number of unread events in the event log. Type Affected by Where saved Default value Query only Not applicable Not applicable Not applicable...
  • Page 527: System:eventlog:next

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :SYSTem:EVENtlog:NEXT? This command returns the oldest unread event message from the event log. Type Affected by Where saved Default value Query only Not applicable Not applicable Not applicable...
  • Page 528: System:eventlog:post

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example Returns information on the next event in the event log. For example, if you SYST:EVEN:NEXT? sent a command without a parameter, the return is: -109,"Missing parameter;1;2015/05/06 12:55:33.648"...
  • Page 529: System:eventlog:save

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :SYSTem:EVENtlog:SAVE This command saves the event log to a file on a USB flash drive. Type Affected by Where saved Default value Command only Not applicable Not applicable...
  • Page 530: System:lfrequency

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details The address can be set to any address value from 1 to 30. However, the address must be unique in the system. It cannot conflict with an address that is assigned to another instrument or to the GPIB controller.
  • Page 531: System:password:new

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :SYSTem:PASSword:NEW This command stores the instrument password. Type Affected by Where saved Default value Command only Rear-panel LAN reset Nonvolatile memory admin Usage :SYSTem:PASSword:NEW "<password>" A string that contains the instrument password (maximum 30 characters) <password>...
  • Page 532: System:time

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details When you select RST, the instrument restores settings to their default values when the instrument is powered on. When you select a SAV option, the settings in the selected saved setup are applied when the instrument is powered on.
  • Page 533: System:version

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example Set the system time to August 29, 2014 at syst:time 2014, 8, 29, 11, 30, 30 11:30:30 and confirm setting. syst:time? 1 Output: Fri Aug 29 11:30:37 2014...
  • Page 534: Trace:actual:end

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details This command returns the number of readings stored in the buffer. Example Creates 200 element reading buffer named testData. TRACe:MAKE "testData", 200 Set the measurement count to 10.
  • Page 535: Trace:actual:start

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example TRACe:MAKE "test1", 100 COUNt 6 MEASure:CURRent? "test1" :TRACe:ACTual:STARt? "test1" ; END? "test1" MEASure:CURRent? "test1" :TRACe:ACTual:STARt? "test1" ; END? "test1" Create a buffer named test1 with a capacity of 100 readings.
  • Page 536: Trace:clear

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example TRACe:MAKE "test1", 100 COUNt 6 MEASure:CURRent? "test1" :TRACe:ACTual:STARt? "test1" ; END? "test1" Create a buffer named test1 with a capacity of 100 readings. Set the measure count to 6.
  • Page 537: Trace:data

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRACe:DATA? This command returns specified data elements from a specified reading buffer. Type Affected by Where saved Default value Query only Recall settings Not applicable Not applicable Instrument reset...
  • Page 538 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference The options for <bufferElements> are described in the following table. Option Description The date when the data point was measured DATE The measured value as it appears on the front panel...
  • Page 539 Measure status questionable 0x0001 STAT_QUESTIONABLE A/D converter from which reading originated; for the 0x0006 STAT_ORIGIN Model 2461, this will always be 0 (main) or 2 (digitizer) Measure terminal, front is 1, rear is 0 0x0008 STAT_TERMINAL Measure status limit 2 low 0x0010...
  • Page 540: Trace:delete

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Also see :FORMat[:DATA] (on page 6-46) Reading buffers (on page 3-2) Remote buffer operation (on page 3-23) :TRACe:MAKE (on page 6-165) :TRACe:DELete This command deletes a user-defined reading buffer.
  • Page 541: Trace:log:state

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details When a reading buffer is set to fill once, no data is overwritten in the buffer. When the buffer is filled, no more data is stored in that buffer and new readings are discarded.
  • Page 542: Trace:make

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details If this is set to on, when the reading buffer is cleared (0 % filled) or full (100 % filled), an event is logged in the event log. If this is set to off, reading buffer status is not reported in the event log.
  • Page 543 Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Once the buffer style is selected, it cannot be changed. Once you store the first reading in a compact buffer, you cannot change certain measurement settings, including range, display digits, and units; you must clear the buffer first.
  • Page 544: Trace:points

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :TRACe:POINts This command contains the number of readings a buffer can store. Type Affected by Where saved Default value Command and query Recall settings Save settings Not applicable...
  • Page 545: Trace:save

    The Model 2461 does not check for existing files when you save. Verify that you are using a unique name to avoid overwriting any existing .csv files on the flash drive.
  • Page 546 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example Create a buffer called MyBuffer with a TRACe:MAKE "MyBuffer", 100 maximum size of 100. SENSe:COUNt 5 Make five readings for each MEASure:CURRent:DC? "MyBuffer" measurement request and return the TRACe:DATA? 1,5, "MyBuffer", READ, REL, SOUR...
  • Page 547: Trace:save:append

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRACe:SAVE:APPend This command appends data from the reading buffer to a file on the USB flash drive. Type Affected by Where saved Default value Command only Not applicable...
  • Page 548: Trace:statistics:average

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example TRACe:MAKE "testData", 100 SENSe:COUNt 5 MEASure:CURRent:DC? "testData", READ, REL TRACe:SAVE "/usb1/myData5.csv", "testData" TRACe:CLEAr MEASure:CURRent:DC? TRACe:SAVE:APPend "/usb1/myData5.csv", "defbuffer1" MEASure:CURRent:DC? "testData" TRACe:SAVE:APPend "/usb1/myData5.csv", "testData", RAW, 6, 10 Create a buffer called testData.
  • Page 549: Trace:statistics:clear

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details This command returns the average reading calculated from all of the readings in the specified reading buffer. When the reading buffer is configured to fill continuously and overwrite old data with new data, the buffer statistics include the data that was overwritten.
  • Page 550: Trace:statistics:maximum

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example Clear all statistics in defbuffer1. TRACe:STATistics:CLEar Clears all statistics in a user-defined buffer TRACe:STATistics:CLEar "testData" named testData. Also see Reading buffers (on page 3-2) Remote buffer operation...
  • Page 551: Trace:statistics:minimum

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRACe:STATistics:MINimum? This command returns the minimum reading value in the reading buffer. Type Affected by Where saved Default value Query only Recall settings Not applicable Not applicable Instrument reset...
  • Page 552: Trace:statistics:pk2Pk

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :TRACe:STATistics:PK2Pk? This command returns the peak-to-peak value of all readings in the reading buffer. Type Affected by Where saved Default value Query only Recall settings Not applicable Not applicable...
  • Page 553: Trace:trigger

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example Returns the standard deviation of the readings in the TRACe:STAT:STDDev? default buffer defbuffer1. Returns the standard deviation of the readings in the TRACe:STAT:STDDev? "testData" user-defined buffer testData.
  • Page 554: Trace:trigger:digitize

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :TRACe:TRIGger:DIGitize This command makes readings using the active digitize function and stores them in the reading buffer. Type Affected by Where saved Default value Command only Not applicable...
  • Page 555: Trace:write:format

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRACe:WRITe:FORMat This command sets the units and number of digits of the readings that are written into the reading buffer. Type Affected by Where saved Default value Command only...
  • Page 556 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example 1 :TRAC:MAKE "write2me", 1000, WRITable :TRAC:WRIT:FORM "write2me", WATT, 4 :TRAC:WRIT:READ "write2me", 1 :TRAC:WRIT:READ "write2me", 2 :TRAC:WRIT:READ "write2me", 3 :TRAC:WRIT:READ "write2me", 4 :TRAC:WRIT:READ "write2me", 5 :TRAC:WRIT:READ "write2me", 6 :TRAC:DATA? 1, 6, "write2me", read, unit...
  • Page 557: Trace:write:reading

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRACe:WRITe:READing This command allows you to write readings into the reading buffer. Type Affected by Where saved Default value Command only Not applicable Not applicable Not applicable Usage For buffers with the writable buffer style: :TRACe:WRITe:READing "<bufferName>", <readingValue>...
  • Page 558 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example 1 :TRAC:MAKE "write2me", 1000, WRITable :TRAC:WRIT:FORM "write2me", WATT, 4 :TRAC:WRIT:READ "write2me", 1 :TRAC:WRIT:READ "write2me", 2 :TRAC:WRIT:READ "write2me", 3 :TRAC:WRIT:READ "write2me", 4 :TRAC:WRIT:READ "write2me", 5 :TRAC:WRIT:READ "write2me", 6 :TRAC:DATA? 1, 6, "write2me", read, unit...
  • Page 559: Trigger Subsystem

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual TRIGger subsystem The commands in this subsystem configure and control the trigger operations, including the trigger model. :ABORt This command stops all trigger model commands on the instrument.
  • Page 560: Trigger:blender:Mode

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details This command sets the blender event detector to the undetected state and resets the overrun indicator of the event detector. Example Clears the event detector for blender 2.
  • Page 561: Trigger:blender:Overrun

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRIGger:BLENder<n>:OVERrun? This command indicates whether or not an event was ignored because of the event detector state. Type Affected by Where saved Default value Query only Not applicable...
  • Page 562 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details There are four stimulus inputs that can each select a different event. Use zero to disable the blender input. The <event> par ameter may be any of the trigger events shown i n the followi ng tabl e.
  • Page 563: Trigger:block:branch:always

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRIGger:BLOCk:BRANch:ALWays This command defines a trigger model block that always goes to a specific block. Type Affected by Where saved Default value Command only Recall settings Save settings...
  • Page 564: Trigger:block:branch:counter:count

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details This command defines a trigger model building block that branches to another block using a counter to iterate a specified number of times. Counters increment every time the trigger model reaches them until they are more than or equal to the count value.
  • Page 565: Trigger:block:branch:counter:reset

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example Reset trigger model settings. TRIG:LOAD "Empty" Clear defbuffer1 at the beginning of the TRIG:BLOC:BUFF:CLEAR 1 trigger model. TRIG:BLOC:MEAS 2 Loop and take 5 readings. TRIG:BLOC:BRAN:COUN 3, 5, 2 Delay 1 s.
  • Page 566: Trigger:block:branch:delta

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :TRIGger:BLOCk:BRANch:DELTa This command defines a trigger model block that goes to a specified block if the difference of two measurements meets preset criteria. Type Affected by Where saved...
  • Page 567: Trigger:block:branch:event

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRIGger:BLOCk:BRANch:EVENt This command branches to a specified block when a specified trigger event occurs. Type Affected by Where saved Default value Command only Recall settings Save settings Not applicable...
  • Page 568: Trigger:block:branch:limit:constant

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example :TRIG:BLOC:BRAN:EVEN 6, DISP, 2 When the trigger model reaches this block, if the front-panel TRIGGER key has been pressed, the trigger model returns to block 2. If the TRIGGER key has not been pressed, the trigger model continues to block 7 (the next block in the trigger model).
  • Page 569: Trigger:block:branch:limit:dynamic

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual • Inside: The measurement is inside the values set by limits A and B; limit A must be the low value and Limit B must be the high value •...
  • Page 570: Trigger:block:branch:once

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details The branch-on-dynamic-limits block defines a trigger model block that goes to a specified block in the trigger model if a measurement meets user-defined criteria. When you define this block, you set: •...
  • Page 571: Trigger:block:branch:once:excluded

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details The branch-once building block branches to a specified block the first time trigger model execution encounters the branch-once block. If it is encountered again, the trigger model ignores the block and continues in the normal sequence.
  • Page 572: Trigger:block:buffer:clear

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :TRIGger:BLOCk:BUFFer:CLEar This command defines a trigger model block that clears the reading buffer. Type Affected by Where saved Default value Command only Recall settings Save settings Not applicable...
  • Page 573: Trigger:block:config:next

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRIGger:BLOCk:CONFig:NEXT This command recalls the settings at the next index of a source or measure configuration list. Type Affected by Where saved Default value Command only Recall settings...
  • Page 574: Trigger:block:config:previous

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :TRIGger:BLOCk:CONFig:PREVious This command defines a trigger model block that recalls the settings stored at the previous index in a source or measure configuration list. Type Affected by Where saved...
  • Page 575: Trigger:block:config:recall

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRIGger:BLOCk:CONFig:RECall This command recalls the system settings that are stored in a source or measure configuration list. Type Affected by Where saved Default value Command only Recall settings...
  • Page 576: Trigger:block:delay:constant

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :TRIGger:BLOCk:DELay:CONStant This command adds a constant delay to the trigger model. Type Affected by Where saved Default value Command only Recall settings Save settings Not applicable Instrument reset...
  • Page 577: Trigger:block:delay:dynamic

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRIGger:BLOCk:DELay:DYNamic This command adds a delay to the execution of the trigger model. Type Affected by Where saved Default value Command only Recall settings Save settings Not applicable...
  • Page 578: Trigger:block:digital:io

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :TRIGger:BLOCk:DIGital:IO This command defines a trigger model block that sets the lines on the digital I/O port high or low. Type Affected by Where saved Default value Command only...
  • Page 579: Trigger:block:digitize

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRIGger:BLOCk:DIGitize This command defines a trigger block that makes a measurement using a digitize function. Type Affected by Where saved Default value Command only Recall settings Save settings...
  • Page 580: Trigger:block:list

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :TRIGger:BLOCk:LIST? This command returns the settings for all trigger model blocks. Type Affected by Where saved Default value Query only Not applicable Not applicable Not applicable Usage :TRIGger:BLOCk:LIST? Details This returns the settings for the trigger model.
  • Page 581: Trigger:block:measure

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details This block allows you to log an event in the event log when trigger model execution reaches this block. You can also force the trigger model to abort with this block. When the trigger model executes the block, the defined event is logged.
  • Page 582: Trigger:block:nop

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference If you are defining a user-defined reading buffer, you must create it before you define this block. When you set the count to a finite value, trigger model execution remains at the block until all measurements are complete.
  • Page 583: Trigger:block:notify

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRIGger:BLOCk:NOTify This command defines a trigger model block that generates a trigger event and immediately continues to the next block. Type Affected by Where saved Default value Recall settings...
  • Page 584: Trigger:block:source:pulse:state

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :TRIGger:BLOCk:SOURce:PULSe:STATe This command defines a pulse trigger block that turns the pulse source on or off. Type Affected by Where saved Default value Command only Recall settings Save settings...
  • Page 585: Trigger:block:source:state

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRIGger:BLOCk:SOURce:STATe This command defines a trigger block that turns the output source on or off. Type Affected by Where saved Default value Command only Recall settings Save settings...
  • Page 586: Trigger:block:wait

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :TRIGger:BLOCk:WAIT This command defines a trigger model block that waits for an event before allowing the trigger model to continue. Type Affected by Where saved Default value Command only...
  • Page 587 Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual The following usage has been deprecated; replace it with the usage above that includes the <clear> parameter. :TRIGger:BLOCk:WAIT <blockNumber>, <event>, <logic>, <event> :TRIGger:BLOCk:WAIT <blockNumber>, <event>, <logic>, <event>, <event>...
  • Page 588: Trigger:digital:In:clear

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :TRIGger:DIGital<n>:IN:CLEar This command clears the trigger event on a digital input line. Type Affected by Where saved Default value Command only Not applicable Not applicable Not applicable Usage :TRIGger:DIGital<n>:IN:CLEar...
  • Page 589: Trigger:digital:In:overrun

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details This command sets the logic on which the trigger event detector and the output trigger generator operate on the specified trigger line. To directly control the line state, set the mode of the line to digital and use the write command. When the digital line mode is set for open drain, the edge settings assert a TTL low-pulse.
  • Page 590: Trigger:digital:Out:logic

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example Returns 0 if no overruns have occurred or 1 TRIG:DIG1:IN:OVER? if one or more overrun have occurred for I/O line 1. Also see Digital I/O port configuration (on page 3-87) :DIGital:LINE<n>:MODE...
  • Page 591: Trigger:digital:Out:pulsewidth

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRIGger:DIGital<n>:OUT:PULSewidth This command describes the length of time that the trigger line is asserted for output triggers. Type Affected by Where saved Default value Command and query Recall settings Save settings 10e-6 (10 µs)
  • Page 592 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details The digital trigger pulsewidth command determines how long the trigger is asserted. The trigger stimulus for a digital I/O line can be set to one of the trigger events that are described in the following table.
  • Page 593: Trigger:lan:In:clear

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRIGger:LAN<n>:IN:CLEar This command clears the event detector for a LAN trigger. Type Affected by Where saved Default value Command only Not applicable Not applicable Not applicable Usage :TRIGger:LAN<n>:IN:CLEar The LAN event number (1 to 8) to clear <n>...
  • Page 594: Trigger:lan:In:overrun

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example Set the LAN trigger mode for event 2 to falling. :TRIG:LAN2:IN:EDGE FALL Also see Digital I/O (on page 3-86) TSP-Link System Expansion Interface (on page 3-150) :TRIGger:LAN<n>:IN:OVERrun? This command indicates the overrun status of the LAN event detector.
  • Page 595: Trigger:lan:Out:connect:state

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRIGger:LAN<n>:OUT:CONNect:STATe This command prepares the event generator for outgoing trigger events. Type Affected by Where saved Default value Command and query Not applicable Not applicable Not applicable Usage :TRIGger:LAN<n>:OUT:CONNect:STATe <state>...
  • Page 596: Trigger:lan:Out:logic

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details Sets the IP address for outgoing trigger events. After you change this setting, you must send the connect command before outgoing messages can be sent. Example Use IP address 192.0.32.10 to connect the TRIG:LAN1:OUT:IP:ADDR "192.0.32.10"...
  • Page 597: Trigger:lan:Out:protocol

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRIGger:LAN<n>:OUT:PROTocol This command sets the LAN protocol to use for sending trigger messages. Type Affected by Where saved Default value Command and query Recall settings Save settings Instrument reset...
  • Page 598 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details This attribute specifies which event causes a LAN trigger packet to be sent for this trigger. Set the event to one of the existing trigger events, which are shown in the following table.
  • Page 599: Trigger:load "Configlist

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRIGger:LOAD "ConfigList" This command loads a predefined trigger model configuration that uses source and measure configuration lists. Type Affected by Where saved Default value Command only Not applicable...
  • Page 600 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example *RST :SOURce:CONF:LIST:CRE "SOURCE_LIST" :SENS:CONF:LIST:CRE "MEASURE_LIST" :SOUR:VOLT 1 :SOURce:CONF:LIST:STORE "SOURCE_LIST" :SENS:CURR:RANG 1e-3 :SENSe:CONF:LIST:STOR "MEASURE_LIST" :SOUR:VOLT 5 :SOURce:CONF:LIST:STORE "SOURCE_LIST" :SENS:CURR:RANG 10e-3 :SENSe:CONF:LIST:STOR "MEASURE_LIST" :SOUR:VOLT 10 :SOURce:CONF:LIST:STORE "SOURCE_LIST" :SENS:CURR:RANG 100e-3 :SENSe:CONF:LIST:STOR "MEASURE_LIST"...
  • Page 601: Trigger:load "Durationloop

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRIGger:LOAD "DurationLoop" This command loads a predefined trigger model configuration that makes continuous measurements for a specified amount of time. Type Affected by Where saved Default value Command only...
  • Page 602: Trigger:load "Empty"

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :TRIGger:LOAD "Empty" This command resets the trigger model. Type Affected by Where saved Default value Command only Not applicable Not applicable Not applicable Usage :TRIGger:LOAD "Empty" Details When you load this predefined trigger model, any blocks that have been defined in the trigger model are cleared so the trigger model has no blocks defined.
  • Page 603: Trigger:load "Gradebinning

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRIGger:LOAD "GradeBinning" This command loads a predefined trigger model configuration that sets up a grading operation. Type Affected by Where saved Default value Command only Not applicable Not applicable...
  • Page 604 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference x is limit 1, 2, 3, or 4; the upper limit that the measurement is compared <limitxHigh> against x is 1, 2, 3, or 4; the lower limit that the measurement is compared against <limitxLow>...
  • Page 605: Trigger:load "Logictrigger

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRIGger:LOAD "LogicTrigger" This command loads a predefined trigger model configuration that sets up a digital trigger through the digital I/O. Type Affected by Where saved Default value Command only...
  • Page 606: Trigger:load "Loopuntilevent

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example :TRIGger:LOAD "LogicTrigger", 1, 2, 10, ENTer, 0.001, "defbuffer1" Set up the template to use the digital in line 1 and wait until the wait block is entered to detect the pulse from digital in line 1 and to trigger measurements.
  • Page 607 Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details The event constant is the event that ends infinite triggering or ends readings set to occur before the trigger and start post-trigger readings. The trigger model makes readings until it detects the event constant.
  • Page 608: Trigger:load "Simpleloop

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :TRIGger:LOAD "SimpleLoop" This command loads a predefined trigger model configuration. Type Affected by Where saved Default value Command only Not applicable Not applicable Not applicable Usage :TRIGger:LOAD "SimpleLoop", <count>...
  • Page 609 Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example Reset the instrument and set it to *RST measure current with automatic range SENS:FUNC "CURR" setting. SENS:CURR:RANG:AUTO ON Source 5 V with a source delay of 0.1 s.
  • Page 610: Trigger:load "Sortbinning

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference :TRIGger:LOAD "SortBinning" This command loads a predefined trigger model configuration that sets up a sorting operation. Type Affected by Where saved Default value Command only Not applicable Not applicable...
  • Page 611: Trigger:state

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual x is limit 1, 2, 3, or 4; the upper limit that the measurement is compared <limitxHigh> against x is 1, 2, 3, or 4; the lower limit that the measurement is compared against <limitxLow>...
  • Page 612: Trigger:timer:Clear

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference The trigger model states are: • Idle: The trigger model is stopped. • Running: The trigger model is running. • Waiting: The trigger model has been in the same wait block for more than 100 ms.
  • Page 613: Trigger:timer:Count

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRIGger:TIMer<n>:COUNt This command sets the number of events to generate each time the timer generates a trigger event or is enabled as a timer or alarm. Type Affected by...
  • Page 614 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Example 2 *RST TRIG:TIM4:DEL 0.5 TRIG:TIM4:STAR:STIM NOT8 TRIG:TIM4:STAR:GEN OFF TRIG:TIM4:COUN 20 TRIG:TIM4:STAT ON TRIG:LOAD "Empty" TRIG:BLOC:BUFF:CLEAR 1, "defbuffer1" TRIG:BLOC:NOT 2, 8 TRIG:BLOC:WAIT 3, TIM4 TRIG:BLOC:MEAS 4, "defbuffer1" TRIG:BLOC:BRAN:COUN 5, 20, 3...
  • Page 615: Trigger:timer:Delay

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRIGger:TIMer<n>:DELay This command sets and reads the timer delay. Type Affected by Where saved Default value Command and query Recall settings Save settings 10e-6 (10 µs) Instrument reset...
  • Page 616: Trigger:timer:Start:generate

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details This command configures the alarm of the timer. When the timer is enabled, the timer starts immediately if the timer is configured for a start time in the past or if it is in the future.
  • Page 617: Trigger:timer:Start:overrun

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual :TRIGger:TIMer<n>:STARt:OVERrun? This command indicates if an event was ignored because of the event detector state. Type Affected by Where saved Default value Query only Not applicable Not applicable...
  • Page 618: Trigger:timer:Start:stimulus

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details This command configures the alarm of the timer. When the timer is enabled, the timer starts immediately if the timer is configured for a start time that has passed.
  • Page 619: Trigger:timer:State

    Section 6: SCPI command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Trigger events are described in the table below. Trigger events Event description Event constant No trigger event NONE Front-panel TRIGGER key press DISPlay Notify trigger block <n> (1 to 8); the trigger model generates a NOTify<n>...
  • Page 620 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 6: SCPI command reference Details When this command is set to on, the timer performs the delay operation. When this command is set to off, there is no timer on the delay operation.
  • Page 621: Introduction To Tsp Operation

    Section 7 Introduction to TSP operation In this section: Introduction to TSP operation........... 7-1 Fundamentals of scripting for TSP ........... 7-4 Fundamentals of programming for TSP ......... 7-11 Test Script Builder (TSB)............7-29 About TSP Commands ............7-40 Introduction to TSP operation ®...
  • Page 622 Section 7: Introduction to TSP operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Example 1 Emit a double-beep at 2400 Hz. The sequence is 0.5 s beeper.beep(0.5, 2400) on, 0.25 s off, 0.5 s on. delay(0.250) beeper.beep(0.5, 2400) Example 2 You can use the results of a function-based command directly or assign variables to the results for later access.
  • Page 623: Queries

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 7: Introduction to TSP operation Reading an attribute To read an attribute, you can use the attribute as the parameter of a function or assign it to another variable. Example 1: Read an attribute using a function Reads the status of the light state by passing print(display.lightstate)
  • Page 624: Fundamentals Of Scripting For Tsp

    Section 7: Introduction to TSP operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Fundamentals of scripting for TSP Though it can improve your process to use scripts, you do not have to create scripts to use the instrument. Most of the examples in the documentation can be run by sending individual command messages.
  • Page 625: Run-Time And Nonvolatile Memory Storage Of Scripts

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 7: Introduction to TSP operation Run-time and nonvolatile memory storage of scripts Scripts are loaded into the run-time environment of the instrument. From there, they can be stored in nonvolatile memory in the instrument.
  • Page 626 Load a script by sending commands over a remote interface (on page 7-7). • Keithley Instruments Test Script Builder (TSB) software (available for download on the Keithley Instruments support website (http://www.keithley.com/support)). For more information, see Creating a new TSP project (on page 7-34).
  • Page 627 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 7: Introduction to TSP operation Load a script by sending commands over a remote interface To load a script over the remote interface, you can use the loadscript and endscript commands. Normally, when the instrument receives a command, it runs the command immediately. When the instrument receives the loadscript command, the instrument starts collecting subsequent messages instead of running them immediately.
  • Page 628 Section 7: Introduction to TSP operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Running scripts using a remote interface You can run any script using scriptVar.run(). Replace scriptVar with the name of a script that is in nonvolatile or run-time memory.
  • Page 629 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 7: Introduction to TSP operation Retrieve a user script from the instrument You can review user scripts that are in the nonvolatile memory of the instrument and retrieve them. To see a list of scripts from the front-panel interface: 1.
  • Page 630 Section 7: Introduction to TSP operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Power up script The power up script runs automatically when the instrument is powered on. To create a power up script, save a new script and name it autoexec. The autoexec script is automatically saved to nonvolatile memory.
  • Page 631: Fundamentals Of Programming For Tsp

    ® The Test Script Processor (TSP ) scripting engine is a Lua interpreter. In TSP-enabled instruments, the Lua programming language has been extended with Keithley-specific instrument control commands. What is Lua? Lua is a programming language that can be used with TSP-enabled instruments. Lua is an efficient language with simple syntax that is easy to learn.
  • Page 632: Lua Basics

    Section 7: Introduction to TSP operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Lua basics This section contains the basics about the Lua programming language to allow you to start adding Lua programming commands to your scripts quickly. For more information about Lua, see the Lua website (http://www.lua.org).
  • Page 633 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 7: Introduction to TSP operation Values and variable types In Lua, you can use variables to store values in the run-time environment for later use. Lua is a dynamically-typed language; the type of the variable is determined by the value that is assigned to the variable.
  • Page 634 Section 7: Introduction to TSP operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Example: Boolean y = false false boolean print(y, type(y)) Example: String and number x = "123" string print(x, type(x)) Adding a number to x forces its type to x = x + 7 number.
  • Page 635 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 7: Introduction to TSP operation Relational operators Operator Description less than < greater than > less than or equal <= greater than or equal >= not equal equal Bitwise operators Operator Description &...
  • Page 636 Section 7: Introduction to TSP operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Example 1 print(10 or eventlog.next()) print(nil or "a") print(nil and 10) print(false and eventlog.next()) print(false and nil) print(false or nil) print(10 and 20) Output: false false Example 2 hex = function (i) return "0x"..string.format("%X", i) end...
  • Page 637 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 7: Introduction to TSP operation Operator precedence Operator precedence in Lua follows the order below (from higher to lower priority): • ^ (exponentiation) • not, - (unary), ! (logical NOT) • *, /, <<, >>...
  • Page 638 Section 7: Introduction to TSP operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Where: • myFunction: The name of the function. • parameterX: Parameter names. To use multiple parameters, separate the names with commas. • functionBody: The code that is executed when the function is called.
  • Page 639 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 7: Introduction to TSP operation 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 640 Section 7: Introduction to TSP operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Example: If and else Output: x = 2 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 641 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 7: Introduction to TSP operation 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 7-19) statements.
  • Page 642 Section 7: Introduction to TSP operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Example: Repeat until list = {"One", "Two", "Three", "Four", "Five", "Six"} print("Count elements in list using repeat:") element = 1 repeat print(element, list[element]) element = element + 1...
  • Page 643 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 7: Introduction to TSP operation Example: Generic for days = {"Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"} for i, v in ipairs(days) do print(days[i], i, v) The generic for statement works by using functions called iterators. On each iteration, the iterator function is called to produce a new value, stopping when this new value is nil.
  • Page 644 Section 7: Introduction to TSP operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Example: Break with while statement enclosed by comment delimiters This example defines a break value local numTable = {5, 4, 3, 2, 1} (breakValue), but the break value line is local k = table.getn(numTable)
  • Page 645: Standard Libraries

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 7: Introduction to TSP operation Tables and arrays Lua makes extensive use of the data type table, which is a flexible array-like data type. Table indices start with 1. Tables can be indexed not only with numbers, but with any value except nil. Tables can be heterogeneous, which means that they can contain values of all types except nil.
  • Page 646 Section 7: Introduction to TSP operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Base library functions Base library functions Function Description Sets the garbage-collection threshold to the given limit (in collectgarbage() kilobytes) and checks it against the byte counter. If the new...
  • Page 647 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 7: Introduction to TSP operation String library functions This library provides generic functions for string manipulation, such as finding and extracting substrings. When indexing a string in Lua, the first character is at position 1 (not 0, as in ANSI C).
  • Page 648 Section 7: Introduction to TSP operation Model 2461 Interactive 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 649: Suggestions For Increasing The Available Memory

    Test Script Builder (TSB) Keithley Instruments Test Script Builder (TSB) is a software tool available from the Keithley Instruments website. You can install and use TSB to develop scripts for TSP-enabled instruments.
  • Page 650: Installing The Tsb Add-In

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

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 7: Introduction to TSP operation Figure 162: Example of the Test Script Builder workspace Item Description Project navigator Script editor; right-click to run the script that is displayed Outline view Programming interaction Help;...
  • Page 652: Script Editor

    Section 7: Introduction to TSP operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Script editor The script editor is where you write, modify, and debug scripts. To open and display a script file, double-click the file name in the project navigator. You can have multiple script files open in the script editor at the same time.
  • Page 653: Connecting An Instrument In Tsb

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 7: Introduction to TSP operation Connecting an instrument in TSB You must use the TSP command set with the Test Script Builder software. For information on changing the command set, refer to Determining the command set you will use (on page 2-80).
  • Page 654: Creating A New Tsp Project

    Section 7: Introduction to TSP operation Model 2461 Interactive SourceMeter® Instrument Reference Manual 4. Click OK. You briefly see the Opening Resource dialog box, and then the instrument is visible in the Instrument Console. Figure 165: Instrument connected in TSB Creating a new TSP project ®...
  • Page 655: Adding A New Tsp File To A Project

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 7: Introduction to TSP operation Adding a new TSP file to a project To add a new TSP file to a project: 1. Select the File menu and select New > TSP File. The New TSP File dialog box opens.
  • Page 656: Creating A Run Configuration

    Section 7: Introduction to TSP operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Creating a run configuration A run configuration allows you to download multiple script files to an instrument and execute them as a single script. To create a run configuration: 1.
  • Page 657 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 7: Introduction to TSP operation 4. In the Name box, enter the name of your new run configuration. 5. Click the Browse button next the Project box. 6. Select a project from the list of available projects 7.
  • Page 658 Section 7: Introduction to TSP operation Model 2461 Interactive SourceMeter® Instrument Reference Manual 8. Select the files you want to add to the run configuration and click Add to add them to the Load Order list. To change the load order of the TSP files, select the files you want to move and click Up or Down until the files are in the correct order.
  • Page 659 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 7: Introduction to TSP operation 9. Click Apply. 10. Click the Script Attributes tab. 11. Select one of the following: Load and Execute: If you select this option, which is the default selection, the script automatically loads into the instrument's volatile memory (run-time environment) and executes when you click Run.
  • Page 660: Memory Considerations For The Run-Time Environment

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Memory considerations for the run-time environment The Model 2461 reserves a large amount of memory for use with interactions with the front panel, commands, and test scripts. The amount of memory usage is affected by the following product features: •...
  • Page 661: Beeper Control

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 7: Introduction to TSP operation Beeper control The beeper command allows you to sound the instrument beeper: beeper.beep() (on page 8-10) Digital I/O The digital I/O port of the instrument can control external circuitry (such as a component handler for binning operations).
  • Page 662: Display

    Section 7: Introduction to TSP operation Model 2461 Interactive SourceMeter® Instrument Reference Manual Display The display functions and attributes allow you to change the format of information on the front-panel display of the instrument. You can also customize your display.
  • Page 663: Instrument Identification

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 7: Introduction to TSP operation Instrument identification These commands store strings that describe the instrument. localnode.access (on page 8-83) localnode.gettime() (on page 8-84) localnode.linefreq (on page 8-84) localnode.model (on page 8-85) localnode.password (on page 8-85) localnode.prompts...
  • Page 664: Gpib

    Section 7: Introduction to TSP operation Model 2461 Interactive SourceMeter® Instrument Reference Manual GPIB These commands store the GPIB address and indicate whether GPIB communication is enabled. gpib.address (on page 8-80) Reading buffer Reading buffers capture measurements, ranges, instrument status, and output states of the instrument.
  • Page 665: Queries And Response Messages

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 7: Introduction to TSP operation Queries and response messages You can use the print(), printbuffer(), and printnumber() functions to query the instrument and generate response messages. The format attributes control how the data is formatted for the print functions used.
  • Page 666: Smu

    Section 7: Introduction to TSP operation Model 2461 Interactive SourceMeter® Instrument Reference Manual SMU commands and functions are unique to SMU instruments. You can use the SMU commands to control the instrument source and measure functions. localnode.linefreq (on page 8-84) smu.terminals...
  • Page 667 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 7: Introduction to TSP operation SMU source commands are: smu.source.autorange (on page 8-175) smu.source.autodelay (on page 8-176) smu.source.configlist.catalog() (on page 8-177) smu.source.configlist.create() (on page 8-177) smu.source.configlist.delete() (on page 8-178) smu.source.configlist.query() (on page 8-179) smu.source.configlist.recall()
  • Page 668: Status Model

    Section 7: Introduction to TSP operation Model 2461 Interactive SourceMeter® Instrument Reference Manual SMU pulse commands smu.source.pulse.level (on page 8-190) smu.source.pulsesweeplinear() (on page 8-194) smu.source.pulsesweeplinearstep() (on page 8-197) smu.source.pulsesweeplist() (on page 8-200) smu.source.pulsesweeplog() (on page 8-202) smu.source.pulsetrain() (on page 8-205) SMU contact check commands smu.contact.check()
  • Page 669: Time

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 7: Introduction to TSP operation Time bufferVar.fractionalseconds (on page 8-24) bufferVar.n (on page 8-26) bufferVar.relativetimestamps (on page 8-28) bufferVar.seconds (on page 8-29) bufferVar.times (on page 8-37) bufferVar.timestamps (on page 8-38) delay() (on page 8-49) localnode.gettime()
  • Page 670 Section 7: Introduction to TSP operation Model 2461 Interactive SourceMeter® Instrument Reference Manual trigger.lanin[N].clear() (on page 8-248) trigger.lanin[N].edge (on page 8-249) trigger.lanin[N].overrun (on page 8-249) trigger.lanin[N].wait() (on page 8-250) trigger.lanout[N].assert() (on page 8-251) trigger.lanout[N].connect() (on page 8-252) trigger.lanout[N].connected (on page 8-252) trigger.lanout[N].disconnect()
  • Page 671: Trigger Model

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 7: Introduction to TSP operation Trigger model The trigger model commands allow you to control and set the trigger model options. trigger.model.abort() (on page 8-258) trigger.model.getblocklist() (on page 8-258) trigger.model.getbranchcount() (on page 8-259) trigger.model.initiate()
  • Page 672: Tsp-Link

    Section 7: Introduction to TSP operation Model 2461 Interactive SourceMeter® Instrument Reference Manual TSP-Link TSP-link commands allow you to control and access the TSP-Link synchronization port. Use these commands to perform basic steady-state digital I/O operations; for example, you can program the instrument to read and write to a specific TSP-Link synchronization line or to the entire port.
  • Page 673: User Strings

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 7: Introduction to TSP operation User strings The userstring functions allow you to add user-defined strings to nonvolatile memory, delete the strings and see a list of the user strings in memory.
  • Page 674: Tsp Command Reference

    Section 8 TSP command reference In this section: TSP command programming notes .......... 8-1 Using the TSP command reference ......... 8-3 TSP commands ................ 8-7 TSP command programming notes This section contains general information about using TSP commands. TSP syntax rules This section provides rules for what you can and cannot do when entering TSP commands.
  • Page 675: Time And Date Values

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Parameters for functions All functions must have a set of parentheses () immediately following the function. If there are parameters for the function, they are placed between the parentheses. The parentheses are required even when no parameters are specified.
  • Page 676: Using The Tsp Command Reference

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Remote control When the instrument is controlled remotely, the front-panel controls are disabled. You can still view information on the front-panel display and move between the screens using the keys and touchscreen controls.
  • Page 677: Command Name, Brief Description, And Summary Table

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual The subsections contain information about the command. The subsections are: • Command name, brief description, and summary table • Usage • Details • Example • Also see The content of each of these subsections is described in the following topics.
  • Page 678: Command Usage

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Where saved. Indicates where the command settings reside once they are used on an instrument. Options include: • Not saved: Command is not saved and must be typed each time you use it.
  • Page 679: Command Details

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Command details This section lists additional information you need to know to successfully use the remote commands. Figure 175: TSP Details description Example section The Example section of the remote command description shows examples of how you can use the command.
  • Page 680: Tsp Commands

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference TSP commands acal.count This attribute returns the number of times automatic calibration has been run. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable...
  • Page 681: Acal.lastrun.tempdiff

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example Returns the internal temperature of the instrument when print(acal.lastrun.internaltemp) auto calibration was last run. Example output: 63.167084 Also see acal.lastrun.tempdiff (on page 8-8) acal.run() (on page 8-9) acal.lastrun.tempdiff...
  • Page 682: Acal.lastrun.time

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference acal.lastrun.time This attribute returns the date and time when autocalibration was last run. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Nonvolatile memory...
  • Page 683: Beeper.beep()

    For example, you can use the beeper to signal the end of a lengthy sweep. Using this function from a remote interface does not affect audible errors or key click settings that were made from the Model 2461 front panel. Example Generates a 2 s, 2400 Hz tone.
  • Page 684: Buffer.delete()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example Clears statistics for defbuffer1. buffer.clearstats() Clears statistics for testData. buffer.clearstats(testData) Also see buffer.getstats() (on page 8-12) buffer.delete() This function deletes a user-defined reading buffer. Type TSP-Link accessible...
  • Page 685: Buffer.getstats()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual buffer.getstats() This function returns statistics from a specified reading buffer. Type TSP-Link accessible Affected by Where saved Default value Function Usage buffer.getstats() buffer.getstats(bufferVar) statsVar = buffer.getstats(bufferVar) The name of the reading buffer, which may be a default buffer (defbuffer1 or bufferVar defbuffer2) or a user-defined buffer;...
  • Page 686 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Use the following command to get statsVar; a table with the following entries in it: n, min, max, mean, and stddev. statsVar = buffer.getstats(bufferVar) Use the following commands to print these entries: print(statsVar.n)
  • Page 687: Buffer.make()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual buffer.make() This function creates a user-defined reading buffer. Type TSP-Link accessible Affected by Where saved Default value Function Usage bufferVar = buffer.make(bufferSize) bufferVar = buffer.make(bufferSize, style) A user-supplied string that indicates the name of the buffer bufferVar The maximum number of readings that can be stored in bufferVar;...
  • Page 688: Buffer.save()

    Examples of valid destination file names: buffer.save(MyBuffer, "/usb1/myData") buffer.save(MyBuffer, "/usb1/myData.csv") The Model 2461 does not check for existing files when you save. Verify that you are using a unique name to avoid overwriting any existing .csv files on the flash drive. 2461-901-01 A/November 2015...
  • Page 689: Buffer.saveappend()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example 1 buffer.save(MyBuffer, "/usb1/myData.csv") Save all reading and default time information from a buffer named MyBuffer to a file named myData.csv on the USB flash drive. Example 2 buffer.save(MyBuffer, "/usb1/myDataRel.csv", buffer.SAVE_RELATIVE_TIME)
  • Page 690 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Details If the file you specify does not exist on the USB flash drive, this command creates the file. For options that save more than one item of time information, each item is comma-delimited. For example, the default format is date, time, and fractional seconds for each reading.
  • Page 691: Buffervar.capacity

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual bufferVar.capacity This attribute contains the number of readings a buffer can store. Type TSP-Link accessible Affected by Where saved Default value Attribute (R/W) Restore configuration Not applicable Not applicable...
  • Page 692: Buffervar.clear()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference bufferVar.clear() This function clears all readings and statistics from the specified buffer. Type TSP-Link accessible Affected by Where saved Default value Function Usage bufferVar.clear() The name of the reading buffer, which may be a default buffer (defbuffer1 or...
  • Page 693: Buffervar.dates

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual bufferVar.dates This attribute contains the dates of readings that are stored in the reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Restore configuration...
  • Page 694: Buffervar.endindex

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference bufferVar.endindex This attribute indicates the last index in a reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Restore configuration Not applicable Not applicable...
  • Page 695: Buffervar.fillmode

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual bufferVar.fillmode This attribute determines if a reading buffer is filled continuously or is filled once and stops. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)
  • Page 696: Buffervar.formattedreadings

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference bufferVar.formattedreadings This attribute contains the stored readings formatted as they appear on the front-panel display. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Restore configuration...
  • Page 697: Buffervar.fractionalseconds

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual bufferVar.fractionalseconds This attribute contains the fractional second portion of the timestamp of each reading in the reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R)
  • Page 698: Buffervar.logstate

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference bufferVar.logstate This attribute indicates if information events are logged when the specified reading buffer is at 0 % or 100 % filled Type TSP-Link accessible Affected by Where saved...
  • Page 699: Buffervar.n

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual bufferVar.n This attribute contains the number of readings in the specified reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Restore configuration Not applicable...
  • Page 700: Buffervar.readings

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference bufferVar.readings This attribute contains the readings stored in a specified reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Restore configuration Not applicable Not applicable...
  • Page 701: Buffervar.relativetimestamps

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual bufferVar.relativetimestamps This attribute contains the timestamps, in seconds, when each reading occurred, relative to the timestamp of the first entry in the reading buffer. Type TSP-Link accessible Affected by...
  • Page 702: Buffervar.seconds

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference bufferVar.seconds This attribute contains the timestamp of a reading in seconds, in UTC format. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Restore configuration Not applicable...
  • Page 703: Buffervar.sourceformattedvalues

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual bufferVar.sourceformattedvalues This attribute contains the source levels formatted as they appear on the front-panel display when the readings in the reading buffer were acquired. Type TSP-Link accessible Affected by...
  • Page 704: Buffervar.sourcestatuses

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference bufferVar.sourcestatuses This attribute contains the source status conditions of the instrument for the reading point. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Restore configuration...
  • Page 705: Buffervar.sourceunits

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example Create a reading buffer named reset() testData, configure the instrument to testData = buffer.make(50) make two measurements, and store the smu.source.output = smu.ON readings in the buffer.
  • Page 706: Buffervar.sourcevalues

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Details The attribute is an array (a Lua table) of strings indicating the units of measure at the time of the reading. Example Create a reading buffer named...
  • Page 707 Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual The values returned by this command depend on the source readback state: • If readback is off, the value is the programmed value • If readback is on, the value is the actual measured source value...
  • Page 708: Buffervar.startindex

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference bufferVar.startindex This attribute indicates the starting index in a reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Restore configuration Not applicable Not applicable...
  • Page 709: Buffervar.statuses

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual bufferVar.statuses This attribute contains the status values of readings in the reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Restore configuration Not applicable...
  • Page 710: Buffervar.times

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example Create a reading buffer named testData, reset() configure the instrument to make two testData = buffer.make(50) measurements, and store the readings in smu.source.output = smu.ON the buffer.
  • Page 711: Buffervar.timestamps

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example This example creates a reading buffer reset() named testData and makes three testData = buffer.make(50) measurements. trigger.model.load("SimpleLoop", 3, 0, testData) The print() command outputs the time trigger.model.initiate() of the first reading.
  • Page 712 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Details This attribute contains the timestamps (date, hours, minutes, seconds, and fractional seconds) of readings stored in the reading buffer. When using the compact buffer style, there is a very small drift between the triggering clock and the timestamp clock, which may result in timestamp truncation and discontinuities over time.
  • Page 713: Buffervar.units

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual bufferVar.units This attribute contains the unit of measure that is stored with readings in the reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R)
  • Page 714: Buffer.write.format()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Also see buffer.delete() (on page 8-11) buffer.make() (on page 8-14) bufferVar.clear() (on page 8-19) print() (on page 8-92) printbuffer() (on page 8-93) Reading buffers (on page 3-2) Remote buffer operation (on page 3-23) buffer.write.format()
  • Page 715 Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details This command is valid when the buffer style is writable or full writable. Defines the units and the number of digits that are reported for the data. This function affects how the data is shown in the reading buffer and what is shown on the front-panel Home, Histogram, Reading Table, and Graph screens.
  • Page 716: Buffer.write.reading()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference buffer.write.reading() This function allows you to write readings into the reading buffer. Type TSP-Link accessible Affected by Where saved Default value Function Usage buffer.write.reading(bufferVar, readingValue) buffer.write.reading(bufferVar, readingValue, seconds) buffer.write.reading(bufferVar, readingValue, seconds, fractionalSeconds)
  • Page 717 Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example 1 extBuffer = buffer.make(100, buffer.STYLE_WRITABLE) buffer.write.format(extBuffer, buffer.UNIT_WATT, buffer.DIGITS_3_5) buffer.write.reading(extBuffer, 1) buffer.write.reading(extBuffer, 2) buffer.write.reading(extBuffer, 3) buffer.write.reading(extBuffer, 4) buffer.write.reading(extBuffer, 5) buffer.write.reading(extBuffer, 6) printbuffer(1, 6, extBuffer.readings, extBuffer.units) Creates a 100-point reading buffer named extBuffer. Style is writable.
  • Page 718: Createconfigscript()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference createconfigscript() This function creates a setup file that captures most of the present settings of the instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
  • Page 719: Dataqueue.capacity

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details You cannot use the timeout value when accessing the data queue from a remote node (you can only use the timeout value while adding data to the local data queue).
  • Page 720: Dataqueue.clear()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example This example fills the data queue until it is full MaxCount = dataqueue.CAPACITY and prints the number of items in the queue. while dataqueue.count < MaxCount do Output: dataqueue.add(1)
  • Page 721: Dataqueue.count

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual dataqueue.count This attribute contains the number of items in the data queue. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Power cycle Not applicable Not applicable Usage count = dataqueue.count...
  • Page 722: Delay()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference 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 723: Digio.line[N].Mode

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example 1 Emit a double-beep at 2400 Hz. The sequence is beeper.beep(0.5, 2400) 0.5 s on, 0.25 s off, 0.5 s on. delay(0.250) beeper.beep(0.5, 2400) Example 2 Clear the data queue, add 35 to it, and then delay dataqueue.clear()
  • Page 724 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Details You can use this command to place each digital I/O line into one of the following modes: • Digital open-drain, output, or input • Trigger open-drain, output, or input •...
  • Page 725: Digio.line[N].Reset()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual digio.line[N].reset() This function resets digital I/O line values to their factory defaults. Type TSP-Link accessible Affected by Where saved Default value Function Usage digio.line[N].reset() The digital I/O line (1 to 6)
  • Page 726: Digio.line[N].State

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference digio.line[N].state This function sets a digital I/O line high or low when the line is set for digital control and returns the state on the digital I/O lines.
  • Page 727: Digio.writeport()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details The binary equivalent of the returned value indicates the value of the input lines on the digital I/O port. The least significant bit (bit B1) of the binary number corresponds to digital I/O line 1; bit B6 corresponds to digital I/O line 6.
  • Page 728: Display.changescreen()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example Sets digital I/O lines 1 through 6 high (binary digio.writeport(63) 111111). Also see digio.readport() (on page 8-53) Digital I/O port configuration (on page 3-87) display.changescreen() This function changes which front-panel screen is displayed.
  • Page 729: Display.clear()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual display.clear() This function clears the text from the front-panel USER swipe screen. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.clear() Example Clear the USER swipe screen.
  • Page 730: Display.input.number()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example removePrompt3 = display.prompt(display.BUTTONS_NONE, "This prompt will disappear in 3 seconds") delay(3) display.delete(removePrompt3) This example displays a prompt that is automatically removed in three seconds: Also see display.prompt() (on page 8-64) display.input.number()
  • Page 731 Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details This command prompts the instrument operator to enter a value. The prompt is displayed until it has been responded to. On the prompt, the operator can move the cursor in the entry box by touching the screen. The cursor is moved to the spot where the operator touched the screen.
  • Page 732: Display.input.option()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference display.input.option() This function allows you to create an option dialog box with customizable buttons on the front-panel display. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.BUTTON_OPTIONn = display.input.option(dialogTitle, buttonTitle1,...
  • Page 733 Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example optionID = display.input.option("Select an option", "Apple", "Orange", "Papaya", "Pineapple", "Blueberry", "Banana", "Grapes", "Peach", "Apricot", "Guava") print(optionID) This example displays the following dialog box: If the user selects Peach, the return is display.BUTTON_OPTION8.
  • Page 734: Display.input.prompt()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference display.input.prompt() This function allows you to create a prompt that accepts a user response from the front-panel display. Type TSP-Link accessible Affected by Where saved Default value Function Usage buttonReturn = display.input.prompt(buttonSet, dialogTitle)
  • Page 735: Display.input.string()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Also see display.input.number() (on page 8-57) display.input.option() (on page 8-59) display.input.string() (on page 8-62) display.input.string() This function allows you to create a dialog box that requests text from the user through the front-panel display.
  • Page 736: Display.lightstate

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example value = display.input.string("Enter Test Name", display.SFORMAT_ANY) print(value) This example displays the prompt "Enter Test Name" and a keyboard that the operator can use to enter a response: The return is the response from the operator.
  • Page 737: Display.prompt()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details This command changes the light output of the front panel when a test requires different instrument illumination levels. The change in illumination is temporary. The normal backlight settings are restored after a power cycle.
  • Page 738: Display.readingformat

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Only one prompt can be active at a time. When the user presses a button, the button presses are returned as one of the following options: • OK: display.BUTTON_OK •...
  • Page 739: Display.settext()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details This setting persists through reset() and power cycles. When Prefix is selected, prefixes are added to the units symbol, such as k (kilo) or m (milli). When Exponent is selected, exponents are used instead of prefixes.
  • Page 740: Display.waitevent()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference display.waitevent() This function causes the instrument to wait for a user to respond to a prompt that was created with a prompt command. Type TSP-Link accessible Affected by...
  • Page 741: Eventlog.clear()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual eventlog.clear() This function clears the event log. Type TSP-Link accessible Affected by Where saved Default value Function Usage eventlog.clear() Details This command removes all events from the event log, including entries in the front-panel event log.
  • Page 742: Eventlog.next()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example Displays the present number of unread print(eventlog.getcount(eventlog.SEV_INFO)) information messages in the instrument event log. If there are three information messages in the event log, output is: Also see eventlog.clear()
  • Page 743: Eventlog.post()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details When an event occurs on the instrument, it is placed in the event log. The eventlog.next() command retrieves an unread event from the event log. Once an event is read, it can no longer be accessed remotely.
  • Page 744: Eventlog.save()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Details You can use this command to create your own event log entries and assign a severity level to them. This can be useful for debugging and status reporting.
  • Page 745: Exit()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details This command saves all event log entries to a USB flash drive. If you do not define an event type, the instrument saves all event log entries.
  • Page 746: File.flush()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Details Note that files are automatically closed when the file descriptors are garbage collected. Example file_num = file.open("/usb1/GENTRIGGER", file.MODE_WRITE) file.close(file_num) Open the file GENTRIGGER for writing, then close it.
  • Page 747: File.mkdir()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual file.mkdir() This function creates a directory at the specified path on the USB flash drive. Type TSP-Link accessible Affected by Where saved Default value Function Usage file.mkdir(path) The path of the directory...
  • Page 748: File.read()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example Opens file testfile.txt for writing. file_num = file.open("/usb1/testfile.txt", If no errors were found while opening, file.MODE_WRITE) writes This is my test file and if file_num != nil then closes the file.
  • Page 749: File.usbdriveexists()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual file.usbdriveexists() This function detects if a USB flash drive is inserted into the front-panel USB port. Type TSP-Link accessible Affected by Where saved Default value Function Usage driveInserted = file.usbdriveexists()
  • Page 750: Format.asciiprecision

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example Opens file testfile.txt for writing. file_num = file.open("testfile.txt", If no errors were found while opening, file.MODE_WRITE) writes This is my test file and if file_num != nil then closes the file.
  • Page 751: Format.byteorder

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual format.byteorder This attribute sets the binary byte order for the data that is printed using the printnumber() and printbuffer() functions. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 752: Format.data

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference format.data This attribute sets the data format for data that is printed using the printnumber() and printbuffer() functions. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)
  • Page 753: Gpib.address

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual gpib.address This attribute contains the GPIB address. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory Usage address = gpib.address gpib.address = address...
  • Page 754: Lan.ipconfig()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference lan.ipconfig() This function specifies the LAN configuration for the instrument. Type TSP-Link accessible Affected by Where saved Default value Function Rear panel LAN reset Nonvolatile memory lan.MODE_AUTO Usage method, ipV4Address, subnetMask, gateway = lan.ipconfig()
  • Page 755: Lan.lxidomain

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual 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 756: Localnode.access

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference localnode.access This attribute contains the type of access users have to the instrument through different interfaces. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory localnode.ACCESS_FULL...
  • Page 757: Localnode.gettime()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual localnode.gettime() This function retrieves the instrument date and time. Type TSP-Link accessible Affected by Where saved Default value Function Usage localnode.gettime() Details The time is returned in UTC time. UTC time is specified as the number of seconds since Jan 1, 1970, UTC.
  • Page 758: Localnode.model

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference 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 759: Localnode.prompts

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual localnode.prompts This attribute determines if the instrument generates prompts in response to command messages. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Power cycle Not saved localnode.DISABLE...
  • Page 760: Localnode.serialno

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference localnode.serialno This attribute stores the instrument's serial number. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage serialno = localnode.serialno...
  • Page 761: Localnode.showevents

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details Internally, the instrument bases time in UTC time. UTC time is specified as the number of seconds since Jan 1, 1970, UTC. You can use UTC time from a local time specification, or you can use UTC time from another source (for example, your computer).
  • Page 762: Localnode.version

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Details Enable this attribute to have the instrument output generated events to the remote interface. Events are output after a command message is executed but before prompts are issued (if prompts are enabled with localnode.prompts).
  • Page 763: Node[N].Execute()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual node[N].execute() This function starts test scripts on a remote TSP-Link node. Type TSP-Link accessible Affected by Where saved Default value Function Yes (see Details) Usage node[N].execute(scriptCode) The node number of this instrument (1 to 64)
  • Page 764: Node[N].Setglobal()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: 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 765: Opc()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual opc() This function sets the operation complete (OPC) bit after all pending commands, including overlapped commands, have been executed. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 766 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Details TSP-enabled instruments do not have inherent query commands. Like any other scripting environment, the print() command and other related print() commands generate output. The print() command creates one response message.
  • Page 767 Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details If startIndex is set to less than 1 or if endIndex is more than the size of the index, 9.910000e+37 is returned for each value outside the allowed index and an event is generated.
  • Page 768: Printbuffer

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference The time when the instrument made the readings. See bufferVar.times bufferVar.times (on page 8-37). The timestamps of readings stored in the reading buffer. See bufferVar.timestamps bufferVar.timestamps (on page 8-38).
  • Page 769: Printnumber()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Also see bufferVar.n (on page 8-26) bufferVar.readings (on page 8-27) format.asciiprecision (on page 8-77) format.byteorder (on page 8-78) format.data (on page 8-79) printnumber() (on page 8-96) printnumber() This function prints numbers using the configured format.
  • Page 770: Reset()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference reset() This function resets commands to their default settings and clears the buffers. Type TSP-Link accessible Affected by Where saved Default value Function Usage reset() reset(system) If the node is the master, the entire system is reset: true...
  • Page 771: Script.catalog()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details When this attribute is enabled, the IEEE Std 488.2 common commands generate prompts if prompting is enabled with the localnode.prompts attribute. If localnode.prompts4882 is enabled, limit the number of *trg commands sent to a running script to 50 regardless of the setting of the localnode.prompts attribute.
  • Page 772: Script.delete()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference script.delete() This function deletes a script from the run-time memory and nonvolatile memory. Type TSP-Link accessible Affected by Where saved Default value Function Usage script.delete(scriptName) A string that represents the name of the script...
  • Page 773: Scriptvar.run()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example Loads the script with the file name test8 = script.load("/usb1/testSetup.tsp") testSetup.tsp that is on the USB flash drive and names it test8. Also see None scriptVar.run() This function runs a script.
  • Page 774: Scriptvar.source

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Details The scriptVar.save() function saves a script to nonvolatile memory or a USB flash drive. The root folder of the USB flash drive has the absolute path /usb1/.
  • Page 775: Smu.contact.check()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example print(test7.source) Assuming a script named test7 was created on the instrument, this example retrieves the source code. Output: reset() display.settext(display.TEXT1, "Text on line 1") display.settext(display.TEXT2, "Text on line 2") Also see scriptVar.save()
  • Page 776: Smu.contact.checkall()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference smu.contact.checkall() This function checks the high, low, and guard connections for excessive contact resistance. Type TSP-Link accessible Affected by Where saved Default value Function Usage high, low, guard = smu.contact.checkall()
  • Page 777: Smu.contact.enable

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.contact.enable This attribute indicates whether the contact check function is enabled or disabled on the instrument. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved smu.OFF...
  • Page 778: Smu.contact.threshold

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference smu.contact.threshold This attribute sets the threshold value for contact resistance for the contact check status functions. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved smu.THRESHOLD_50_OHM...
  • Page 779: Smu.digitize.aperture

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.digitize.aperture This attribute determines the aperture setting for the selected function. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script smu.APERTURE_AUTO Instrument reset...
  • Page 780: Smu.digitize.count

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference smu.digitize.count This attribute sets the number of measurements to digitize when a measurement is requested. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration...
  • Page 781: Smu.digitize.func

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details This command affects how the reading for a measurement is displayed on the front panel of the instrument. It does not affect the number of digits returned in a remote command reading. It also does not affect the accuracy or speed of measurements.
  • Page 782: Smu.digitize.limit[Y].Audible

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example Set the measurement function to digitize smu.digitize.func = smu.FUNC_DIGITIZE_CURRENT current. Also see Digitize functions (on page 2-113) smu.measure.func (on page 8-150) smu.digitize.limit[Y].audible This attribute determines if the instrument beeper sounds when a limit test passes or fails, or disables the beeper.
  • Page 783: Smu.digitize.limit[Y].Autoclear

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.digitize.limit[Y].autoclear This attribute indicates if the test result for limit Y should be cleared automatically or not. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)
  • Page 784: Smu.digitize.limit[Y].Enable

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Details Use this command to clear the test results of limit Y when the limit auto clear option is turned off. Both the high and low test results are cleared.
  • Page 785 Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual reset() -- set the instrument to measure digitized voltage smu.digitize.func = smu.FUNC_DIGITIZE_VOLTAGE -- set the range to 10 V --set the instrument to source current smu.source.func=smu.FUNC_DC_CURRENT smu.digitize.range = 10 -- disable auto clearing for limit 1 smu.digitize.limit[1].autoclear = smu.OFF...
  • Page 786: Smu.digitize.limit[Y].Fail

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference smu.digitize.limit[Y].fail This attribute queries the results of a limit test. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage value = smu.digitize.limit[Y].fail...
  • Page 787 Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual reset() -- set the instrument to measure digitized voltage smu.digitize.func = smu.FUNC_DIGITIZE_VOLTAGE -- set the range to 10 V --set the instrument to source current smu.source.func=smu.FUNC_DC_CURRENT smu.digitize.range = 10 -- disable auto clearing for limit 1 smu.digitize.limit[1].autoclear = smu.OFF...
  • Page 788: Smu.digitize.limit[Y].High.value

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference smu.digitize.limit[Y].high.value This attribute specifies the upper limit for a limit test. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Save settings Instrument reset...
  • Page 789: Smu.digitize.limit[Y].Low.value

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.digitize.limit[Y].low.value This attribute specifies the lower limit for limit tests. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script −1 Instrument reset...
  • Page 790 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference reset() -- set the instrument to measure digitized voltage smu.digitize.func = smu.FUNC_DIGITIZE_VOLTAGE -- set the range to 10 V --set the instrument to source current smu.source.func=smu.FUNC_DC_CURRENT smu.digitize.range = 10 -- disable auto clearing for limit 1 smu.digitize.limit[1].autoclear = smu.OFF...
  • Page 791: Smu.digitize.range

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.digitize.limit[Y].fail (on page 8-113) smu.digitize.limit[Y].high.value (on page 8-115) smu.digitize.range This attribute determines the positive full-scale measure range for digitizer. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 792: Smu.digitize.math.enable

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference smu.digitize.math.enable This attribute enables or disables math operations on measurements for the selected digitize function. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script smu.OFF...
  • Page 793: Smu.digitize.math.format

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.digitize.math.format This attribute specifies which math operation is performed on measurements when math operations are enabled. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script smu.MATH_PERCENT...
  • Page 794: Smu.digitize.math.mxb.bfactor

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference smu.digitize.math.mxb.bfactor This attribute specifies the offset, b, for the y = mx + b operation. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration...
  • Page 795: Smu.digitize.math.mxb.mfactor

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.digitize.math.mxb.mfactor This attribute specifies the scale factor, m, for the y = mx + b math operation. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)
  • Page 796: Smu.digitize.math.percent

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference smu.digitize.math.percent This attribute specifies the reference constant that is used when math operations are set to percent. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)
  • Page 797: Smu.digitize.read()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.digitize.read() This function makes digitize measurements, places them in a reading buffer, and returns the last reading. Type TSP-Link accessible Affected by Where saved Default value Function Usage reading = smu.digitize.read()
  • Page 798: Smu.digitize.readwithtime()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference smu.digitize.readwithtime() This function initiates digitize measurements and returns the last actual measurement and time information in UTC format without using the trigger mode. Type TSP-Link accessible Affected by...
  • Page 799: Smu.digitize.rel.acquire()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.digitize.rel.acquire() This function acquires a measurement and stores it as the relative offset value. Type TSP-Link accessible Affected by Where saved Default value Function Usage smu.digitize.rel.acquire() Details This command triggers the instrument to make a new measurement for the selected function. This measurement is then stored as the new relative offset level.
  • Page 800: Smu.digitize.rel.enable

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference smu.digitize.rel.enable This attribute enables or disables the application of a relative offset value to the measurement. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script smu.OFF...
  • Page 801: Smu.digitize.samplerate

    Details The sample rate determines how fast the Model 2461 acquires a digitized reading. Set the sample rate before setting the aperture. If the aperture setting is too high for the selected sample rate, it is automatically adjusted to the highest aperture that can be used with the sample rate.
  • Page 802: Smu.digitize.unit

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example Set the digitize function to digitize current. smu.digitize.func = smu.FUNC_DIGITIZE_CURRENT Set the sample rate to 1,000,000, with a smu.digitize.samplerate = 1000000 count of 1, and automatic aperture.
  • Page 803: Smu.digitize.userdelay[N]

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.digitize.userdelay[N] This attribute sets a user-defined delay that you can use in the trigger model. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration...
  • Page 804: Smu.interlock.tripped

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference smu.interlock.tripped This attribute indicates that the interlock has been tripped. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage interlockStatus = smu.interlock.tripped...
  • Page 805: Smu.measure.autorangehigh

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details This command determines how the range is selected. When this command is set to off, you must set the range. If you do not set the range, the instrument remains at the range that was last selected by autorange.
  • Page 806: Smu.measure.autorangelow

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example Sets the measurement function to voltage and turn smu.measure.func = smu.FUNC_DC_VOLTAGE autorange on. Check the high range for voltage smu.measure.autorange = smu.ON measurements. print(smu.measure.autorangehigh) Also see Ranges...
  • Page 807: Smu.measure.autozero.enable

    The time interval between updates to these reference measurements is determined by the integration aperture that is being used for measurements. The Model 2461 uses separate reference and zero measurements for each aperture. By default, the instrument automatically checks these reference measurements whenever a signal measurement is made.
  • Page 808: Smu.measure.autozero.once()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference smu.measure.autozero.once() This function causes the instrument to refresh the reference and zero measurements once. Type TSP-Link accessible Affected by Where saved Default value Function Usage smu.measure.autozero.once() Details This command forces a refresh of the reference and zero measurements that are used for the present aperture setting for the selected function.
  • Page 809: Smu.measure.configlist.create()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example Request the name of one measure configuration print(smu.measure.configlist.catalog()) list that is stored in the instrument. Send the command again until it returns nil to get all stored lists.
  • Page 810: Smu.measure.configlist.delete()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference smu.measure.configlist.delete() This function deletes a measure configuration list. Type TSP-Link accessible Affected by Where saved Default value Function Usage smu.measure.configlist.delete(listName) smu.measure.configlist.delete(listName, index) A string that represents the name of a measure configuration list...
  • Page 811: Smu.measure.configlist.query()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.measure.configlist.query() This function returns a list of TSP commands and parameter settings that are stored in the specified configuration index. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 812 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example print(smu.measure.configlist.query("testMeasList", 2, "\n")) Returns the TSP commands and parameter settings that represent the settings in configuration index 2. Partial example output: smu.measure.func = smu.FUNC_DC_CURRENT smu.measure.range = 1.000000e-06 smu.measure.autorange = smu.ON...
  • Page 813: Smu.measure.configlist.recall()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.measure.configlist.recall() This function recalls a configuration index in a measure configuration list and an optional source configuration list. Type TSP-Link accessible Affected by Where saved Default value Function Usage smu.measure.configlist.recall(listName)
  • Page 814: Smu.measure.configlist.size()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example Because an index was not specified, this smu.measure.configlist.recall("MyMeasList") command recalls configuration index 1 from a configuration list named MyMeasList. Recalls configuration index 5 in a smu.measure.configlist.recall("MyMeasList", 5) configuration list named MyMeasList.
  • Page 815: Smu.measure.configlist.store()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.measure.configlist.store() This function stores the active measure or digitize settings into the named configuration list. Type TSP-Link accessible Affected by Where saved Default value Function Usage smu.measure.configlist.store(listName) smu.measure.configlist.store(listName, index)
  • Page 816: Smu.measure.count

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference smu.measure.count This attribute sets the number of measurements to make when a measurement is requested. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration...
  • Page 817 Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example 1 reset() --Set up measure function smu.measure.func = smu.FUNC_DC_CURRENT smu.terminals = smu.TERMINALS_REAR smu.measure.autorange = smu.ON smu.measure.nplc = 1 smu.measure.count = 200 --Set up source function smu.source.func = smu.FUNC_DC_VOLTAGE smu.source.ilimit.level = 0.1...
  • Page 818 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example 2 reset() --set up measure function smu.measure.func = smu.FUNC_DC_CURRENT smu.terminals = smu.TERMINALS_REAR smu.measure.autorange = smu.ON smu.measure.nplc = 1 --set up source function smu.source.func = smu.FUNC_DC_VOLTAGE smu.source.ilimit.level = 0.1 smu.source.level = 20...
  • Page 819 Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example 3 reset() smu.digitize.func = smu.FUNC_DIGITIZE_CURRENT smu.digitize.range = 35e-3 smu.measure.configlist.create("MyDigiCurrList") smu.measure.configlist.store("MyDigiCurrList") print(smu.measure.configlist.query("MyDigiCurrList", 1, '\n')) Set the digitize function to current and the range to 35 mA. Create a configuration list named MyDigiCurrList and store the active digitize settings in index 1 of that list.
  • Page 820: Smu.measure.displaydigits

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference smu.measure.displaydigits This attribute determines the number of digits that are displayed for measurements on the front panel for the selected function. Type TSP-Link accessible Affected by Where saved...
  • Page 821: Smu.measure.filter.count

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.measure.filter.count This attribute sets the number of measurements that are averaged when filtering is enabled. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration...
  • Page 822: Smu.measure.filter.type

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Details This command enables or disables the averaging filter. When this is enabled, the reading returned by the instrument is an averaged value, taken from multiple measurements. The settings of the filter count and filter type for the selected measure function determines how the reading is averaged.
  • Page 823: Smu.measure.func

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual When the moving average filter is selected, the measurements are added to the stack continuously on a first-in, first-out basis. As each measurement is made, the oldest measurement is removed from the stack.
  • Page 824 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Details Set this command to the type of measurement you want to make. Reading this command returns the measure function that is presently active. When you select a function, settings for other commands that are related to the function become active.
  • Page 825: Smu.measure.limit[Y].Audible

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.measure.limit[Y].audible This attribute determines if the instrument beeper sounds when a limit test passes or fails, or disables the beeper. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 826: Smu.measure.limit[Y].Autoclear

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference smu.measure.limit[Y].autoclear This attribute indicates if the test result for limit Y should be cleared automatically or not. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)
  • Page 827: Smu.measure.limit[Y].Clear()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.measure.limit[Y].clear() This function clears the results of the limit test defined by Y for the selected measurement function. Type TSP-Link accessible Affected by Where saved Default value Function Usage smu.measure.limit[Y].clear()
  • Page 828: Smu.measure.limit[Y].Fail

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Details This command enables or disables a limit test for the selected measurement function. When this attribute is enabled, the limit Y testing occurs on each measurement made by the instrument. Limit Y testing compares the measurements to the high and low limit values.
  • Page 829 Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example This example enables limits 1 and 2 for voltage, measurements. Limit 1 is checking for readings to be between 3 and 5 V, while limit 2 is checking for the readings to be between 1 and 7 V. The auto clear feature is disabled, so if any reading is outside these limits, the corresponding fail is 1.
  • Page 830: Smu.measure.limit[Y].High.value

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example output that shows all readings are within limit values (all readings between 3 V and 5 V): limit 1 results = smu.FAIL_NONE limit 2 results = smu.FAIL_NONE...
  • Page 831: Smu.measure.limit[Y].Low.value

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.measure.limit[Y].low.value This attribute specifies the lower limit for limit tests. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Yes Restore configuration Configuration script −1 Instrument reset...
  • Page 832: Smu.measure.math.format

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example When voltage measurements are made, the math smu.measure.func = smu.FUNC_DC_VOLTAGE format is enabled and set to percent. smu.measure.math.format = smu.MATH_PERCENT smu.measure.math.enable = smu.ON Also see Calculations that you can apply to measurements (on page 3-82) smu.measure.math.format...
  • Page 833: Smu.measure.math.mxb.bfactor

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example Enables the reciprocal math operation on smu.measure.func = smu.FUNC_DC_VOLTAGE voltage measurements. smu.measure.math.format = smu.MATH_RECIPROCAL smu.measure.math.enable = smu.ON Also see Calculations that you can apply to measurements (on page 3-82) smu.measure.math.enable...
  • Page 834 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example Set the measurement function to voltage. smu.measure.func = smu.FUNC_DC_VOLTAGE Set the math operation to mx+b. smu.measure.math.format = smu.MATH_MXB Set the scale factor for the mx +b operation smu.measure.math.mxb.mfactor = 0.80...
  • Page 835: Smu.measure.math.mxb.mfactor

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.measure.math.mxb.mfactor This attribute specifies the scale factor, m, for the y = mx + b math operation. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)
  • Page 836: Smu.measure.math.percent

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference smu.measure.math.percent This attribute specifies the reference constant that is used when math operations are set to percent. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)
  • Page 837: Smu.measure.nplc

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.measure.nplc This command sets the time that the input signal is measured for the selected function. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration...
  • Page 838: Smu.measure.offsetcompensation

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference smu.measure.offsetcompensation This attribute enables or disables offset compensation. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script smu.OFF Instrument reset Measure configuration list...
  • Page 839: Smu.measure.range

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.measure.range This attribute determines the positive full-scale measure range. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script Current: 1 µA Instrument reset Measure configuration list Resistance: 200 MΩ...
  • Page 840: Smu.measure.read()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example Select the measurement function to be voltage. smu.source.func = smu.FUNC_DC_CURRENT Instrument selects the 2 V measurement range. smu.measure.func = smu.FUNC_DC_VOLTAGE smu.measure.range = 0.5 Also see Ranges (on page 2-124) smu.measure.autorange...
  • Page 841: Smu.measure.readwithtime()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example Create a buffer named voltMeasBuffer. Set voltMeasBuffer = buffer.make(10000) the instrument to measure voltage. smu.measure.func = smu.FUNC_DC_VOLTAGE Make a measurement that is stored in the print(smu.measure.read(voltMeasBuffer)) voltMeasBuffer and is also printed.
  • Page 842: Smu.measure.rel.acquire()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example print(smu.measure.readwithtime()) Print the last measurement and time information in UTC format, which will look similar to: -1.405293589829e-11 1400904629 0.1950935 Also see smu.measure.count (on page 8-143) trigger.model.load() — SimpleLoop (on page 8-270) smu.measure.rel.acquire()
  • Page 843: Smu.measure.rel.enable

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.measure.rel.enable This attribute enables or disables the application of a relative offset value to the measurement. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script smu.OFF...
  • Page 844: Smu.measure.rel.level

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference smu.measure.rel.level This attribute contains the relative offset value. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script Instrument reset Measure configuration list...
  • Page 845: Smu.measure.sense

    IR drop in the output test leads. Using 4-wire sensing with voltage measurements eliminates any voltage drops that may be in the test leads between the Model 2461 and the DUT. When you are using 2-wire sensing, voltage is measured at the output connectors.
  • Page 846: Smu.measure.unit

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference smu.measure.unit This attribute sets the units of measurement that are displayed on the front panel of the instrument and stored in the reading buffer. Type TSP-Link accessible Affected by...
  • Page 847: Smu.measure.userdelay[N]

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.measure.userdelay[N] This attribute sets a user-defined delay that you can use in the trigger model. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration...
  • Page 848: Smu.reset()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference smu.reset() This function turns off the output and resets the commands that begin with smu. to their default settings. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 849: Smu.source.autodelay

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example Set the source function to current. smu.source.func = smu.FUNC_DC_CURRENT Set the instrument to select the smu.source.autorange = smu.ON source range automatically. Also see smu.source.range (on page 8-207) smu.source.autodelay...
  • Page 850: Smu.source.configlist.catalog()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference smu.source.configlist.catalog() This function returns the name of one source configuration list. Type TSP-Link accessible Affected by Where saved Default value Function Usage smu.source.configlist.catalog() Details You can use this command to retrieve the names of source configuration lists that are stored in the instrument.
  • Page 851: Smu.source.configlist.delete()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example Create a source configuration list reset() named MyScrLst. Print the name of one configuration list smu.source.configlist.create("MyScrList") stored in volatile memory. Output: print(smu.source.configlist.catalog()) MyScrList Print the name of one configuration list.
  • Page 852: Smu.source.configlist.query()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example Deletes a configuration list named smu.source.configlist.delete("mySourceList") mySourceList. Deletes delete configuration index 14 in smu.source.configlist.delete("mySourceList", 14) the source configuration list named mySourceList Also see Configuration lists (on page 3-30) smu.source.configlist.create()
  • Page 853: Smu.source.configlist.recall()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.source.configlist.recall() This function recalls a specific configuration index in a specific source configuration list and an optional measure configuration list. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 854: Smu.source.configlist.size()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example Because an index was not specified, this smu.source.configlist.recall("MySourceList") command recalls configuration index 1 from a configuration list named MySourceList. Recalls configuration index 5 in a smu.source.configlist.recall("MySourceList", 5) configuration list named MySourceList.
  • Page 855: Smu.source.configlist.store()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.source.configlist.store() This function stores the active source settings into the named configuration list. Type TSP-Link accessible Affected by Where saved Default value Function Restore configuration Instrument reset Power cycle...
  • Page 856: Smu.source.delay

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference smu.source.delay This attribute contains the source delay. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script Not applicable Instrument reset Source configuration list...
  • Page 857: Smu.source.func

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.source.func This attribute contains the source function, which can be voltage or current. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script smu.FUNC_DC_VOLTAGE...
  • Page 858: Smu.source.level

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Details When the instrument is measuring low current and is driving a capacitive load, you may see overshoot, ringing, and instability. You can enable the high capacitance mode to minimize these problems.
  • Page 859: Smu.source.offmode

    • smu.OFFMODE_HIGHZ • smu.OFFMODE_GUARD Details When the Model 2461 is set to the normal output-off state, the following settings are made when the source is turned off: • The measurement sense is set to 2-wire • The voltage source is selected and set to 0 V •...
  • Page 860 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Opening the relay disconnects external circuitry from the inputs and outputs of the instrument. To prevent excessive wear on the output relay, do not use this output-off state for tests that turn the output off and on frequently.
  • Page 861: Smu.source.output

    When the output is switched on, the instrument sources either voltage or current, as set by smu.source.func. Example Switch the source output of the instrument to smu.source.output = smu.ON Also see Turn the Model 2461 output on or off smu.source.func (on page 8-184) smu.source.offmode (on page 8-186) smu.source.protect.level This attribute sets the overvoltage protection setting of the source output.
  • Page 862: Smu.source.protect.tripped

    When this attribute is used in a test sequence, it should be set before turning the source on. Even with the overvoltage protection set to the lowest value (2 V), never touch anything connected to the terminals of the Model 2461 when the output is on. Always assume that a hazardous voltage (greater than 30 V ) is present when the output is on.
  • Page 863: Smu.source.pulse.level

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.source.pulse.level This attribute selects a fixed amplitude for the selected source function when pulsing. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Recall settings Save settings...
  • Page 864 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example smu.source.func = smu.FUNC_DC_VOLTAGE smu.source.configlist.create("CustomVoltSweep") smu.source.pulse.level = 1.17 smu.source.configlist.store("CustomVoltSweep") smu.source.pulse.level = 1.27 smu.source.configlist.store("CustomVoltSweep") smu.source.pulse.level = 1.33 smu.source.configlist.store("CustomVoltSweep") smu.source.pulse.level = 1.39 smu.source.configlist.store("CustomVoltSweep") smu.source.pulsesweeplist("CustomVoltSweep", 0.03, smu.OFF, defbuffer1, 1, 3, 0, .005)
  • Page 865: Smu.source.pulse.xlimit.level

    • Details This command sets the source limit for pulse outputs. The Model 2461 cannot source pulse levels that exceed this limit. The values that can be set for this command are limited by the setting for the overvoltage protection limit.
  • Page 866 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example smu.source.func = smu.FUNC_DC_VOLTAGE smu.source.pulse.ilimit.level = 1 print(smu.source.pulse.ilimit.level) Set the source function to voltage with the pulse current limit set to 1 A. Query the source pulse current limit setting.
  • Page 867: Smu.source.pulsesweeplinear()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.source.pulsesweeplinear() This function sets up a linear pulse sweep for a fixed number of pulse points. Type TSP-Link accessible Affected by Where saved Default value Function Usage smu.source.pulsesweeplinear(configListName, biasLevel, start, stop, points, pulseWidth) smu.source.pulsesweeplinear(configListName, biasLevel, start, stop, points,...
  • Page 868 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference The name of the reading buffer, which may be a default buffer (defbuffer1 or bufferName defbuffer2) or a user-defined buffer; defaults to defbuffer1 The amount of time that the instrument stays at bias level before each pulse (in...
  • Page 869 Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example reset() smu.source.func = smu.FUNC_DC_VOLTAGE smu.source.range = 20 smu.measure.func = smu.FUNC_DC_CURRENT smu.measure.range = 100e-6 smu.measure.nplc = 0.01 smu.measure.autozero.enable = smu.OFF smu.source.pulsesweeplinear("VoltLinSweep", 0, 0, 10, 20, 2e-3) trigger.model.initiate() Reset the instrument to its default settings.
  • Page 870: Smu.source.pulsesweeplinearstep()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference smu.source.pulsesweeplinearstep() This function sets up a linear source pulse sweep configuration list model with a fixed number of steps. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 871 Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Enable or disable measurements at the top of each pulse: measEnable Enable: smu.ON (default) • Disable: smu.OFF • The name of the reading buffer, which may be a default buffer (defbuffer1 or bufferName defbuffer2) or a user-defined buffer;...
  • Page 872 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference The name of the source configuration list determines the name of the measure configuration list; Meas is appended to the beginning of the name. If the name of your configuration list is greater than 28 characters, it is truncated to include only the first 28 characters (including the prefix Meas that is added for the measure configuration list).
  • Page 873: Smu.source.pulsesweeplist()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.source.pulsesweeplist() This function sets up a pulse sweep based on a configuration list, which allows you to customize the sweep. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 874 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Before configuring a pulse operation, configure your measure settings. Pulse operations use the measure settings that were last defined before the pulse operation; you may get unexpected results if you do not define the measure settings first.
  • Page 875: Smu.source.pulsesweeplog()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Also see Configuration lists (on page 3-30) Pulse operation (on page 3-64) smu.source.sweeplist() (on page 8-214) trigger.model.initiate() (on page 8-259) Trigger model (on page 3-107) smu.source.pulsesweeplog() This function sets up a logarithmic pulse sweep for a set number of source points.
  • Page 876 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference The voltage or current source level at which the pulse sweep stops: stop Current: -10.5 A to 10.5 A • Voltage: -105 V to 105 V • The number of pulse-measure points between the start and stop values of the pulse...
  • Page 877 Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual The asymptote changes the inflection of the pulse sweep curve and allows it to sweep through zero. You can use the asymptote parameter to customize the inflection and offset of the source value curve.
  • Page 878: Smu.source.pulsetrain()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference smu.source.pulsetrain() This function defines a sequence of source pulses and creates a trigger model to generate the pulse train. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 879 The bias level must be within the normal DC operating area (not the extended area) of the operating boundaries. It must be low enough that it does not exceed the power settings defined by the bias limit and pulse limit parameters. For more information about the Model 2461 operating boundaries, see Operating boundaries (on page 4-4).
  • Page 880: Smu.source.range

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Reset the instrument to its default settings. Set the source function to current and turn on source readback. Set the digitize function to voltage and the digitize voltage range to 20 V.
  • Page 881: Smu.source.readback

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual This command is intended to eliminate the time required by the automatic range selection. To select the range, you can specify the approximate source value that you will use. The instrument selects the lowest range that can accommodate that level.
  • Page 882 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example Reset the instrument to default reset() settings. testDataBuffer = buffer.make(100) Make a buffer named smu.source.func = smu.FUNC_DC_VOLTAGE testDataBuffer that can hold 100 smu.measure.func = smu.FUNC_DC_CURRENT readings. smu.source.readback = smu.ON Set source function to voltage.
  • Page 883: Smu.source.sweeplinear()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.source.sweeplinear() This function sets up a linear sweep for a fixed number of measurement points. Type TSP-Link accessible Affected by Where saved Default value Function Usage smu.source.sweeplinear(configListName, start, stop, points) smu.source.sweeplinear(configListName, start, stop, points, sDelay)
  • Page 884 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Details When the sweep is started, the instrument sources a specific voltage or current value to the device under test (DUT). A measurement is made for each point of the sweep.
  • Page 885: Smu.source.sweeplinearstep()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.source.sweeplinearstep() This function sets up a linear source sweep configuration list and trigger model with a fixed number of steps. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 886 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Details When the sweep is started, the instrument sources a specific voltage or current voltage to the device under test (DUT). A measurement is made for each point of the sweep.
  • Page 887: Smu.source.sweeplist()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.source.sweeplist() This function sets up a sweep based on a configuration list, which allows you to customize the sweep. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 888 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example reset() smu.source.configlist.create("CurrListSweep") smu.source.func = smu.FUNC_DC_CURRENT smu.source.range = 100e-3 smu.source.level = 1e-3 smu.source.configlist.store("CurrListSweep") smu.source.level = 10e-6 smu.source.configlist.store("CurrListSweep") smu.source.level = 7e-3 smu.source.configlist.store("CurrListSweep") smu.source.level = 11e-3 smu.source.configlist.store("CurrListSweep") smu.source.level = 9e-3 smu.source.configlist.store("CurrListSweep")
  • Page 889: Smu.source.sweeplog()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.source.sweeplog() This function sets up a logarithmic sweep for a set number of measurement points. Type TSP-Link accessible Affected by Where saved Default value Function Usage smu.source.sweeplog(configListName, start, stop, points) smu.source.sweeplog(configListName, start, stop, points, sDelay)
  • Page 890 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Details When the sweep is started, the instrument sources a specific voltage or current value to the device under test (DUT). A measurement is made for each point of the sweep.
  • Page 891: Smu.source.userdelay[N]

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.source.userdelay[N] This attribute sets a user-defined delay that you can use in the trigger model. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration...
  • Page 892: Smu.source.xlimit.level

    Current: i • Details This command sets the source limit for measurements. The Model 2461 cannot source levels that exceed this limit. The values that can be set for this command are limited by the setting for the overvoltage protection limit.
  • Page 893: Smu.source.xlimit.tripped

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual smu.source.xlimit.tripped This attribute indicates if the source exceeded the limits that were set for the selected measurements. Type TSP-Link accessible Affected by Where saved Default value Attribute (R)
  • Page 894: Status.clear()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Details This command selects which set of input and output terminals the instrument uses. You can select front panel or rear panel terminals. If the output is turned on when you change from one set of terminals to the other, the output is turned off.
  • Page 895 If you are using the GPIB, USB, or VXI-11 serial poll sequence of the Model 2461 to get the status byte (also called a serial poll byte), B6 is the Request for Service (RQS) bit. If the bit is set, it indicates that a serial poll (SRQ) has occurred.
  • Page 896: Status.operation.condition

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference status.operation.condition This attribute reads the Operation Event Register of the status model. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage operationRegister = status.operation.condition...
  • Page 897: Status.operation.event

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual status.operation.event This attribute reads the Operation Event Register of the status model. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage operationRegister = status.operation.event...
  • Page 898: Status.operation.setmap()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example Query bit 0 of the Operation Event print(status.operation.getmap(0)) Register. Example output: 4917 4916 Also see Operation Event Register (on page C-8) status.operation.setmap() (on page 8-225) status.operation.setmap() This function maps events to bits in the Operation Event Register.
  • Page 899: Status.preset()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual When a mapped event is programmed to clear bits, the bit in the condition register is set to 0 when the event is detected. If the event is set to zero (0), the bit is never set.
  • Page 900: Status.questionable.condition

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference status.questionable.condition This attribute reads the Questionable Condition Register of the status model. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage questionableRegister = status.questionable.condition...
  • Page 901: Status.questionable.enable

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual status.questionable.enable This attribute sets or reads the contents of the questionable event enable register of the status model. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) status.preset()
  • Page 902: Status.questionable.getmap()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example 1 Uses a decimal value to set bits B1 and -- decimal 66 = binary 0100 0010 B6 of the status questionable enable questionableRegister = 66 register.
  • Page 903: Status.questionable.setmap()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual status.questionable.setmap() This function maps events to bits in the questionable event registers. Type TSP-Link accessible Affected by Where saved Default value Function Usage status.questionable.setmap(bitNumber, setEvent) status.questionable.setmap(bitNumber, setEvent, clearEvent)
  • Page 904: Status.request_Enable

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference status.request_enable This attribute stores the settings of the Service Request (SRQ) Enable Register. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) status.preset() Not applicable Usage SRQEnableRegister = status.request_enable...
  • Page 905: Status.standard.enable

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example 3 Clear the register. status.request_enable = 0 Also see Status model (on page C-1) Understanding bit settings (on page C-16) status.standard.enable This attribute reads or sets the bits in the Status Enable register of the Standard Event Register.
  • Page 906: Status.standard.event

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Command errors include: • IEEE Std 488.2 syntax error: The instrument received a message that does not follow the defined syntax of the IEEE Std 488.2 standard. •...
  • Page 907: Timer.cleartime()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details When this command returns zero (0), no bits are set. You can send 0 to clear all bits. The instrument returns a decimal value that corresponds to the binary-weighted sum of all bits set in the register.
  • Page 908: Timer.gettime()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example Clear the data queue, add 35 to it, and then delay dataqueue.clear() 0.5 seconds before reading it. dataqueue.add(35) Output: timer.cleartime() Delay time was 0.500099 delay(0.5) dt = timer.gettime() print("Delay time was "...
  • Page 909: Trigger.blender[N].Clear()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual trigger.blender[N].clear() This function clears the blender event detector and resets the overrun indicator of blender N. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.blender[N].clear()
  • Page 910: Trigger.blender[N].Overrun

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example Generate a trigger blender 1 trigger.blender[1].orenable = true event when a digital I/O trigger.blender[1].stimulus[1] = trigger.EVENT_DIGIO3 trigger happens on line 3 or trigger.blender[1].stimulus[2] = trigger.EVENT_DIGIO5 Also see trigger.blender[N].reset()
  • Page 911: Trigger.blender[N].Reset()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual trigger.blender[N].reset() This function resets some of the trigger blender settings to their factory defaults. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.blender[N].reset() The trigger event blender (1 or 2) Details The trigger.blender[N].reset() function resets the following attributes to their factory...
  • Page 912: Trigger.blender[N].Wait()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference The event parameter may be any of the trigger events shown in the following table. Trigger events Event description Event constant No trigger event trigger.EVENT_NONE Front-panel TRIGGER key press trigger.EVENT_DISPLAY...
  • Page 913: Trigger.clear()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details This function waits for an event blender trigger event. If one or more trigger events were detected since the last time trigger.blender[N].wait() or trigger.blender[N].clear() was called, this function returns immediately.
  • Page 914: Trigger.digin[N].Clear()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example Generate a trigger event. *TRG Check if there are any pending trigger print(trigger.wait(1)) events. trigger.clear() Output: true print(trigger.wait(1)) Clear any pending command triggers. Check if there are any pending trigger events.
  • Page 915: Trigger.digin[N].Edge

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual trigger.digin[N].edge This attribute sets the edge used by the trigger event detector on the given trigger line. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)
  • Page 916: Trigger.digin[N].Overrun

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference trigger.digin[N].overrun This attribute returns the event detector overrun status. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Digital I/O trigger N clear Not applicable Not applicable...
  • Page 917: Trigger.digout[N].Assert()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details This function pauses for up to timeout seconds for an input trigger. If one or more trigger events are detected since the last time trigger.digin[N].wait() or trigger.digin[N].clear() was called, this function returns a value immediately.
  • Page 918: Trigger.digout[N].Logic

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference trigger.digout[N].logic This attribute sets the output logic of the trigger event generator to positive or negative for the specified line. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 919: Trigger.digout[N].Release()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details Setting the pulse width to zero (0) seconds asserts the trigger indefinitely. To release the trigger line, use trigger.digout[N].release(). Example Sets the pulse width for trigger line 4 to digio.line[4].mode = digio.MODE_TRIGGER_OUT...
  • Page 920: Trigger.digout[N].Stimulus

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference trigger.digout[N].stimulus This attribute selects the event that causes a trigger to be asserted on the digital output line. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)
  • Page 921: Trigger.lanin[N].Clear()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Trigger events Event description Event constant No trigger event trigger.EVENT_NONE Trigger event blender N (1 to 2), which combines trigger trigger.EVENT_BLENDERN events Trigger timer N (1 to 4) expired trigger.EVENT_TIMERN...
  • Page 922: Trigger.lanin[N].Edge

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference trigger.lanin[N].edge This attribute sets the trigger operation and detection mode of the specified LAN event. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script trigger.EDGE_EITHER...
  • Page 923: Trigger.lanin[N].Wait()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details This command indicates whether an event has been ignored because the event detector was already in the detected state when the event occurred. This is an indication of the state of the event detector built into the synchronization line itself. It does not indicate if an overrun occurred in any other part of the trigger model, or in any other construct that is monitoring the event.
  • Page 924: Trigger.lanout[N].Assert()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference trigger.lanout[N].assert() This function simulates the occurrence of the trigger and generates the corresponding event. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.lanout[N].assert() The LAN event number (1 to 8) Details Generates and sends a LAN trigger packet for the LAN event number specified.
  • Page 925: Trigger.lanout[N].Connect()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual trigger.lanout[N].connect() This function prepares the event generator for outgoing trigger events. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.lanout[N].connect() The LAN event number (1 to 8) Details This command prepares the event generator to send event messages.
  • Page 926: Trigger.lanout[N].Disconnect()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Details This is set to true when the LAN trigger is connected and ready to send trigger events after a successful trigger.lanout[N].connect() command. If the LAN trigger is not ready to send trigger events, this value is false.
  • Page 927: Trigger.lanout[N].Ipaddress

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual trigger.lanout[N].ipaddress This attribute specifies the address (in dotted-decimal format) of UDP or TCP listeners. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script "0.0.0.0"...
  • Page 928: Trigger.lanout[N].Logic

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference trigger.lanout[N].logic This attribute sets the logic on which the trigger event detector and the output trigger generator operate on the given trigger line. Type TSP-Link accessible Affected by...
  • Page 929: Trigger.lanout[N].Stimulus

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details The LAN trigger listens for trigger messages on all the supported protocols. However, it uses the designated protocol for sending outgoing messages. After you change this setting, you must re-connect the LAN trigger event generator before you can send outgoing event messages.
  • Page 930 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference If any events are detected before the trigger LAN connection is sent, the event is ignored and the action overrun is set. Trigger events Event description Event constant No trigger event trigger.EVENT_NONE...
  • Page 931: Trigger.model.abort()

    When this command is received, the instrument stops the trigger model. Example Terminates all commands related to the trigger model on trigger.model.abort() the instrument. Also see Effect of GPIB line events on Model 2461 (on page 2-59) Aborting the trigger model (on page 3-129) Trigger model (on page 3-107) trigger.model.getblocklist()
  • Page 932: Trigger.model.getbranchcount()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference trigger.model.getbranchcount() This function returns the count value of the trigger model counter block. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.model.getbranchcount(blockNumber) The sequence of the block in the trigger model...
  • Page 933: Trigger.model.load() - Config List

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual trigger.model.load() — Config List This function loads a predefined trigger model configuration that uses source and measure configuration lists. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 934: Trigger.model.load() - Duration Loop

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example reset() smu.source.configlist.create("SOURCE_LIST") smu.measure.configlist.create("MEASURE_LIST") smu.source.level = 1 smu.source.configlist.store("SOURCE_LIST") smu.measure.range = 1e-3 smu.measure.configlist.store("MEASURE_LIST") smu.source.level = 5 smu.source.configlist.store("SOURCE_LIST") smu.measure.range = 10e-3 smu.measure.configlist.store("MEASURE_LIST") smu.source.level = 10 smu.source.configlist.store("SOURCE_LIST") smu.measure.range = 100e-3 smu.measure.configlist.store("MEASURE_LIST") trigger.model.load("ConfigList", "MEASURE_LIST", "SOURCE_LIST")
  • Page 935 Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details When you load this predefined trigger model, you can specify amount of time to make a measurement and the length of the delay before the measurement. After selecting a trigger model template, you can view the trigger model blocks in a graphical format by pressing the front-panel MENU key and under Trigger, selecting Configure.
  • Page 936: Trigger.model.load() - Empty

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference trigger.model.load() — Empty This function clears the trigger model. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.model.load("Empty") Details When you load this predefined trigger model, any blocks that have been defined in the trigger model are cleared so the trigger model has no blocks defined.
  • Page 937: Trigger.model.load() - Gradebinning

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual trigger.model.load() — GradeBinning This function loads a predefined trigger model configuration that sets up a grading operation. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.model.load("GradeBinning", components, startInLine, startDelay, endDelay,...
  • Page 938 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference The bit pattern that is sent when the measurement fails limit 1; range 1 to limit1Pattern 15; default is 1 The bit pattern that is sent when the measurement fails limit 2; range 1 to limit2Pattern 15;...
  • Page 939: Trigger.model.load() - Logictrigger

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual trigger.model.load() — LogicTrigger This function loads a predefined trigger model configuration that sets up a logic trigger through the digital I/O. Type TSP-Link accessible Affected by Where saved...
  • Page 940: Trigger.model.load() - Loopuntilevent

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example trigger.model.load("LogicTrigger", 1, 2, 10, 0.001, defbuffer1) Set up the template to use the digital in line and wait for a pulse from digital in line 1 to trigger measurements.
  • Page 941 Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details The event constant is the event that ends infinite triggering or ends readings set to occur before the trigger and start post-trigger readings. The trigger model makes readings until it detects the event constant.
  • Page 942 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Trigger events Event description Event constant Trigger event blender N (1 to 2), which combines trigger trigger.EVENT_BLENDERN events Trigger timer N (1 to 4) expired trigger.EVENT_TIMERN Source limit condition occurs trigger.EVENT_SOURCE_LIMIT...
  • Page 943: Trigger.model.load() - Simpleloop

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual trigger.model.load() — SimpleLoop This function loads a predefined trigger model configuration that makes a specific number of measurements. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.model.load("SimpleLoop", count)
  • Page 944 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example reset() --set up measure function smu.measure.func = smu.FUNC_DC_CURRENT smu.terminals = smu.TERMINALS_REAR smu.measure.autorange = smu.ON smu.measure.nplc = 1 --set up source function smu.source.func = smu.FUNC_DC_VOLTAGE smu.source.ilimit.level = 0.1 smu.source.level = 20...
  • Page 945: Trigger.model.load() - Sortbinning

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual trigger.model.load() — SortBinning This function loads a predefined trigger model configuration that sets up a sorting operation. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.model.load("SortBinning", components, startInLine, startDelay, endDelay,...
  • Page 946: Trigger.model.setblock() - Trigger.block_Branch_Always

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference The bit pattern that is sent when the measurement passes limit 4; range 1 limit4Pattern to 15; default is 8 The bit pattern that is sent when all limits have failed; 1 to 15; default is 15 allPattern The input line that starts the test;...
  • Page 947: Trigger.model.setblock() - Trigger.block_Branch_Counter

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details When the trigger model reaches a branch-always building block, it goes to the building block set by branchToBlock. Example trigger.model.setblock(6, trigger.BLOCK_BRANCH_ALWAYS, 20) When the trigger model reaches block 6, always branch to block 20.
  • Page 948: Trigger.model.setblock() - Trigger.block_Branch_Delta

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example trigger.model.setblock(4, trigger.BLOCK_BRANCH_COUNTER, 10, 2) print(trigger.model.getbranchcount(4)) When the trigger model reaches this block, the trigger model returns to block 2. This repeats 10 times. An example of the return if the trigger model has reached this block 5 times is: Also see trigger.model.getbranchcount()
  • Page 949 Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual If you do not define the measure or digitize block, it will compare measurements of a measure or digitize block that precedes the branch delta block. For example, if you have a measure block, a wait block, another measure block, another wait block, and then the branch delta block, the delta block compares the measurements from the second measure block.
  • Page 950: Trigger.model.setblock() - Trigger.block_Branch_Limit_Constant

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference trigger.model.setblock() — trigger.BLOCK_BRANCH_LIMIT_CONSTANT This function defines a trigger model block that goes to a specified block if a measurement meets preset criteria. Type TSP-Link accessible Affected by Where saved...
  • Page 951: Trigger.model.setblock() — Trigger.block_Branch_Limit_Dynamic

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual • Inside: The measurement is inside the values set by limits A and B; limit A must be the low value and Limit B must be the high value •...
  • Page 952: Trigger.model.setblock() — Trigger.block_Branch_On_Event

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Details The branch-on-dynamic-limits block defines a trigger model block that goes to a specified block in the trigger model if a measurement meets user-defined criteria. When you define this block, you set: •...
  • Page 953 Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details The branch-on-event block goes to a branching block after a specified trigger event occurs. If the trigger event has not yet occurred when the trigger model reaches the branch-on-event block, the trigger model continues to execute the blocks in the normal sequence.
  • Page 954: Trigger.model.setblock() - Trigger.block_Branch_Once

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference trigger.model.setblock() — trigger.BLOCK_BRANCH_ONCE This function causes the trigger model to branch to a specified building block the first time it is encountered in the trigger model. Type TSP-Link accessible...
  • Page 955: Trigger.model.setblock() - Trigger.block_Buffer_Clear

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details The branch-once-excluded block is ignored the first time the trigger model encounters it. After the first encounter, the trigger model goes to the specified branching block. The branch-once-excluded block is reset when the trigger model starts or is placed in idle.
  • Page 956: Trigger.model.setblock() - Trigger.block_Config_Next

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference trigger.model.setblock() — trigger.BLOCK_CONFIG_NEXT This function recalls the settings at the next index of a source or measure configuration list, or both a source and measure configuration list. Type...
  • Page 957: Trigger.model.setblock() — Trigger.block_Config_Prev

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example 2 trigger.model.load("Empty") trigger.model.setblock(1, trigger.BLOCK_CONFIG_RECALL, "measTrigList") trigger.model.setblock(2, trigger.BLOCK_BUFFER_CLEAR) trigger.model.setblock(3, trigger.BLOCK_CONFIG_NEXT, "measTrigList") print(trigger.model.getblocklist()) Clear the trigger model. Recall index 1 of a configuration list named measTrigList. Clear reading buffer named defbuffer1.
  • Page 958 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Details If two configuration lists are specified with this command, they must not be of the same type. For example, if the first configuration list is a measure configuration list, the second configuration list must be a source configuration list.
  • Page 959: Trigger.model.setblock() - Trigger.block_Config_Recall

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example 3 trigger.model.setblock(7, trigger.BLOCK_CONFIG_PREV, "measTrigList", "sourTrigList") Configure trigger block 7 to load the previous index in both the configuration list named measTrigList and the configuration list named sourTrigList.
  • Page 960: Trigger.model.setblock() - Trigger.block_Delay_Constant

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference When the trigger model reaches a configuration recall block, the settings in the specified configuration list are recalled if a single configuration list is specified. If both measure and source configuration lists are specified, measure and source settings are recalled from the next index in each list when this block is reached.
  • Page 961: Trigger.model.setblock() — Trigger.block_Delay_Dynamic

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example trigger.model.setblock(7, trigger.BLOCK_DELAY_CONSTANT, 30e-3) Configure trigger block 7 to delay the trigger model before the next block until a delay of 30 ms elapses. Also see None trigger.model.setblock() — trigger.BLOCK_DELAY_DYNAMIC This function adds a delay to the execution of the trigger model.
  • Page 962: Trigger.model.setblock() - Trigger.block_Digital_Io

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example smu.measure.userdelay[1] = 5 trigger.model.setblock(1, trigger.BLOCK_SOURCE_OUTPUT, smu.ON) trigger.model.setblock(2, trigger.BLOCK_DELAY_DYNAMIC, trigger.USER_DELAY_M1) trigger.model.setblock(3, trigger.BLOCK_MEASURE) trigger.model.setblock(4, trigger.BLOCK_SOURCE_OUTPUT, smu.OFF) trigger.model.setblock(5, trigger.BLOCK_BRANCH_COUNTER, 10, 1) trigger.model.initiate() Set user delay for measure 1 to 5 s.
  • Page 963: Trigger.model.setblock() — Trigger.block_Digitize

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual For this block to work as expected, make sure you configure the trigger type and line state of the digital line for use with the trigger model (use the digital line mode command).
  • Page 964: Trigger.model.setblock() - Trigger.block_Log_Event

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example reset() smu.digitize.func = smu.FUNC_DIGITIZE_VOLTAGE smu.digitize.samplerate = 50000 trigger.model.setblock(1, trigger.BLOCK_BUFFER_CLEAR, defbuffer1) trigger.model.setblock(2, trigger.BLOCK_DELAY_CONSTANT, 0) trigger.model.setblock(3, trigger.BLOCK_DIGITIZE, defbuffer1, trigger.COUNT_INFINITE) trigger.model.setblock(4, trigger.BLOCK_WAIT, trigger.EVENT_DISPLAY) trigger.model.setblock(5, trigger.BLOCK_DIGITIZE, defbuffer1, trigger.COUNT_STOP) trigger.model.setblock(6, trigger.BLOCK_NOTIFY, trigger.EVENT_NOTIFY1) trigger.model.initiate()
  • Page 965: Trigger.model.setblock() - Trigger.block_Measure

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details This block allows you to log an event in the event log when trigger model execution reaches this block. You can also force the trigger model to abort with this block. When the trigger model executes the block, the defined event is logged.
  • Page 966 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference If you are defining a user-defined reading buffer, you must create it before you define this block. When you set the count to a finite value, trigger model execution remains at the block until all measurements are complete.
  • Page 967: Trigger.model.setblock() - Trigger.block_Nop

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual trigger.model.setblock() — trigger.BLOCK_NOP This function creates a placeholder that performs no action in the trigger model; available only using remote commands. Type TSP-Link accessible Affected by Where saved...
  • Page 968: Trigger.model.setblock() - Trigger.block_Reset_Branch_Count

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example digio.line[3].mode = digio.MODE_TRIGGER_OUT trigger.model.setblock(5, trigger.BLOCK_NOTIFY, trigger.EVENT_NOTIFY2) trigger.digout[3].stimulus = trigger.EVENT_NOTIFY2 Define trigger model block 5 to be the notify 2 event. Assign the notify 2 event to be the stimulus for digital output line 3.
  • Page 969: Trigger.model.setblock() - Trigger.block_Source_Output

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example trigger.model.load("Empty") trigger.model.setblock(1, trigger.BLOCK_BUFFER_CLEAR) trigger.model.setblock(2, trigger.BLOCK_MEASURE) trigger.model.setblock(3, trigger.BLOCK_BRANCH_COUNTER, 5, 2) trigger.model.setblock(4, trigger.BLOCK_DELAY_CONSTANT, 1) trigger.model.setblock(5, trigger.BLOCK_BRANCH_COUNTER, 3, 2) trigger.model.setblock(6, trigger.BLOCK_RESET_BRANCH_COUNT, 3) trigger.model.initiate() waitcomplete() print(defbuffer1.n) Reset trigger model settings. Clear defbuffer1 at the beginning of the trigger model.
  • Page 970: Trigger.model.setblock() - Trigger.block_Source_Pulse_Output

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example trigger.model.setblock(2, trigger.BLOCK_SOURCE_OUTPUT, smu.ON) Set trigger model to turn the source on when it reaches block 2. Also see Wait block (on page 3-110) trigger.model.setblock() — trigger.BLOCK_SOURCE_PULSE_OUTPUT This function defines a pulse trigger block that turns the pulse source on or off.
  • Page 971: Trigger.model.setblock() - Trigger.block_Wait

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example 2 print(trigger.model.getblocklist()) Query the configuration of the blocks in the trigger model. Output: 4) SOURCE_OUTPUT OUTPUT: ON 5) SOURCE_PULSE_OUTPUT PULSE OUTPUT: ON Also see trigger.model.setblock() — trigger.BLOCK_SOURCE_OUTPUT (on page 8-296) trigger.model.setblock() —...
  • Page 972 Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference The event can occur before trigger model execution reaches the wait block. If the event occurs after trigger model execution starts but before the trigger model execution reaches the wait block, the trigger model records the event.
  • Page 973: Trigger.model.state()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual trigger.model.state() This function returns the present state of the trigger model. Type TSP-Link accessible Affected by Where saved Default value Function Usage status, status, n = trigger.model.state() The status of the trigger model: status •...
  • Page 974: Trigger.timer[N].Clear()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference trigger.timer[N].clear() This function clears the timer event detector and overrun indicator for the specified trigger timer number. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.timer[N].clear()
  • Page 975 Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example 1 Read trigger count for timer number 1. print(trigger.timer[1].count) Example 2 reset() trigger.timer[4].reset() trigger.timer[4].delay = 0.5 trigger.timer[4].start.stimulus = trigger.EVENT_NOTIFY8 trigger.timer[4].start.generate = trigger.OFF trigger.timer[4].count = 20 trigger.timer[4].enable = trigger.ON trigger.model.load("Empty")
  • Page 976: Trigger.timer[N].Delay

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference trigger.timer[N].delay This attribute sets and reads the timer delay. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script 10e-6 (10 µs) Instrument reset...
  • Page 977: Trigger.timer[N].Enable

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details Each time the timer is triggered after it is enabled, it uses the next delay period from the array. The default value is an array with one value of 10 µs.
  • Page 978: Trigger.timer[N].Reset()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference To use the timer as a simple delay or pulse generator with digital I/O lines, make sure the timer start time in seconds and fractional seconds is configured for a time in the past. To use the timer as an alarm, configure the timer start time in seconds and fractional seconds for the desired alarm time.
  • Page 979: Trigger.timer[N].Start.fractionalseconds

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual trigger.timer[N].start.fractionalseconds This attribute configures the fractional seconds of an alarm or a time in the future when the timer will start. Type TSP-Link accessible Affected by Where saved...
  • Page 980: Trigger.timer[N].Start.overrun

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example trigger.timer[4].reset() trigger.timer[4].delay = 0.5 trigger.timer[4].start.stimulus = trigger.EVENT_NOTIFY8 trigger.timer[4].start.generate = trigger.OFF trigger.timer[4].count = 20 trigger.timer[4].enable = trigger.ON Reset trigger timer 4. Set trigger timer 4 to have a 0.5 s delay.
  • Page 981: Trigger.timer[N].Start.seconds

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual trigger.timer[N].start.seconds This attribute configures the seconds of an alarm or a time in the future when the timer will start. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 982: Trigger.timer[N].Wait()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Trigger events are described in the table below. Trigger events Event description Event constant No trigger event trigger.EVENT_NONE Front-panel TRIGGER key press trigger.EVENT_DISPLAY Notify trigger block N (1 to 8) generates a trigger event when trigger.EVENT_NOTIFYN...
  • Page 983: Trigger.tsplinkin[N].Clear()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details If one or more trigger events were detected since the last time trigger.timer[N].wait() or trigger.timer[N].clear() was called, this function returns immediately. After waiting for a trigger with this function, the event detector is automatically reset and rearmed.
  • Page 984: Trigger.tsplinkin[N].Edge

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference trigger.tsplinkin[N].edge This attribute indicates which trigger edge controls the trigger event detector for a trigger line. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script trigger.EDGE_FALLING...
  • Page 985: Trigger.tsplinkin[N].Wait()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details This command indicates whether an event has been ignored because the event detector was already in the detected state when the event occurred. This is an indication of the state of the event detector built into the synchronization line itself.
  • Page 986: Trigger.tsplinkout[N].Assert()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Also see trigger.tsplinkin[N].clear() (on page 8-310) tsplink.line[N].mode (on page 8-319) trigger.tsplinkout[N].assert() This function simulates the occurrence of the trigger and generates the corresponding trigger event. Type TSP-Link accessible...
  • Page 987: Trigger.tsplinkout[N].Pulsewidth

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example Sets the trigger logic for tsplink.line[3].mode = tsplink.MODE_TRIGGER_OPEN_DRAIN synchronization line 3 to output a trigger.tsplinkout[3].logic = trigger.LOGIC_POSITIVE positive pulse. Also see trigger.tsplinkout[N].assert() (on page 8-313) tsplink.line[N].mode (on page 8-319) trigger.tsplinkout[N].pulsewidth...
  • Page 988: Trigger.tsplinkout[N].Release()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference trigger.tsplinkout[N].release() This function releases a latched trigger on the given TSP-Link trigger line. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.tsplinkout[N].release() The trigger line (1 to 3) Details Releases a trigger that was asserted with an indefinite pulse width.
  • Page 989 Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details To disable automatic trigger assertion on the synchronization line, set this attribute to trigger.EVENT_NONE. Do not use this attribute when triggering under script control. Use trigger.tsplinkout[N].assert() instead.
  • Page 990: Trigger.wait()

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference trigger.wait() This function waits for a trigger event. Type TSP-Link accessible Affected by Where saved Default value Function Usage triggered = trigger.wait(timeout) A trigger was detected during the timeout period: true...
  • Page 991: Tsplink.initialize()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details To remove the node from all groups, set the attribute value to 0. When the node is turned off, the group number for that node changes to 0.
  • Page 992: Tsplink.line[N].Mode

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example Perform a TSP-Link initialization and nodesFound = tsplink.initialize(2) indicate how many nodes are found. print("Nodes found = " .. nodesFound) Example output if two nodes are found:...
  • Page 993: Tsplink.line[N].Reset()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual tsplink.line[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.line[N].reset() The trigger line (1 to 3) Details The tsplink.line[N].reset() function resets the following attributes to their default values:...
  • Page 994: Tsplink.master

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Details Use tsplink.writeport() to write to all TSP-Link synchronization lines. The reset function does not affect the present states of the TSP-Link trigger lines. Example Assume line 3 is set high, and then the state is read.
  • Page 995: Tsplink.node

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual tsplink.node This attribute defines the node number. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory Usage nodeNumber = tsplink.node tsplink.node = nodeNumber...
  • Page 996: Tsplink.state

    Model 2461 Interactive SourceMeter® Instrument Reference Manual Section 8: TSP command reference Example Reads state of all three TSP-Link lines. data = tsplink.readport() Assuming line 2 is set high, the output is: print(data) 2.000000e+00 (binary 010) The format of the output may vary depending on the ASCII precision setting.
  • Page 997: Tspnet.clear()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Details The binary representation of data indicates the output pattern that is written to the I/O port. For example, a data value of 2 has a binary equivalent of 010. Line 2 is set high (1), and the other two lines are set low (0).
  • Page 998: Tspnet.connect()

    Model 2461 sends an abort command to the remote device on connection. The Model 2461 also enables TSP prompts on the remote device and event management. The Model 2461 places remote errors and events from the TSP-enabled device in its own event queue and prefaces these events with Remote Error, followed by an event description.
  • Page 999: Tspnet.disconnect()

    Section 8: TSP command reference Model 2461 Interactive SourceMeter® Instrument Reference Manual Example 2 Connect to a device that is instrumentID = tspnet.connect("192.0.2.1", 1394, "*rst\r\n") not TSP-enabled. if instrumentID then -- Use instrumentID as needed here tspnet.disconnect(instrumentID) Also see localnode.prompts (on page 8-86) localnode.showevents...
  • Page 1000: Tspnet.execute()

    (see tspnet.read() for format specifiers). When this command is sent to a TSP-enabled instrument, the Model 2461 suspends operation until a timeout error is generated or until the instrument responds. The TSP prompt from the remote instrument is read and discarded.

Table of Contents