Table of Contents

Advertisement

Quick Links

tek.com/keithley
Model 2606B
System SourceMeter
Instrument
®
Reference Manual
2606B-901-01 Rev. C November 2021
*P2606B-901-01C*
2606B-901-01C

Advertisement

Table of Contents
loading
Need help?

Need help?

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

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Tektronix KEITHLEY SourceMeter 2606B

  • Page 1 tek.com/keithley Model 2606B System SourceMeter Instrument ® Reference Manual 2606B-901-01 Rev. C November 2021 *P2606B-901-01C* 2606B-901-01C...
  • Page 2 Model 2606B ® System SourceMeter Instrument Reference Manual...
  • Page 3 © 2021, Keithley Instruments, LLC Cleveland, Ohio, U.S.A. All rights reserved. Any unauthorized reproduction, photocopy, or use of the information herein, in whole or in part, without the prior written approval of Keithley Instruments, LLC, is strictly prohibited. These are the original instructions in English. and TSP-Link are trademarks of Keithley Instruments, LLC.
  • Page 4 Safety precautions The following safety precautions should be observed before using this product and any associated instrumentation. Although some instruments and accessories would normally be used with nonhazardous voltages, there are situations where hazardous conditions may be present. This product is intended for use by personnel who recognize shock hazards and are familiar with the safety precautions required to avoid possible injury.
  • Page 5 For safety, instruments and accessories must be used in accordance with the operating instructions. If the instruments or accessories are used in a manner not specified in the operating instructions, the protection provided by the equipment may be impaired. Do not exceed the maximum signal levels of the instruments and accessories. Maximum signal levels are defined in the specifications and operating information and shown on the instrument panels, test fixture panels, and switching cards.
  • Page 6: Welcome

    Table of contents Introduction ......................1-1 Welcome ..........................1-1 Extended warranty ....................... 1-1 Contact information ......................1-1 2606B documentation ......................1-2 Product software and drivers ....................1-3 Capabilities and features...................... 1-4 What you should have received ................... 1-5 Instrument and module serial numbers ................1-5 General ratings ........................
  • Page 7 Table of contents Model 2606B System SourceMeter® Instrument Reference Manual Download reading buffer data using the web interface ............3-20 Use TSB Embedded ....................... 3-21 Flash Upgrade ......................... 3-21 Send individual commands using the web interface ..............3-21 Review events in the LXI Event Log ..................3-21 Help ............................
  • Page 8 Model 2606B System SourceMeter® Instrument Reference Manual Table of contents Source I ............................. 5-7 Source I measure I, source V measure V ................. 5-8 Measure only (voltage or current) ..................... 5-8 Contact check ........................... 5-9 Operation considerations for the ADC ................5-10 Autozero ..........................
  • Page 9 Table of contents Model 2606B System SourceMeter® Instrument Reference Manual List sweeps ..........................5-41 Pulse mode sweeps ........................ 5-42 Configuring and running sweeps ..................... 5-43 Sweeping using factory scripts ....................5-45 Sweep programming examples ....................5-46 Relative offset ........................5-47 Enabling and disabling relative offset from the front panel ............
  • Page 10 Model 2606B System SourceMeter® Instrument Reference Manual Table of contents Mode ............................7-11 Pulse width ..........................7-11 Trigger configuration on hardware lines .................. 7-11 Action overruns on hardware lines ..................7-13 Timers ..........................7-13 Timer attributes ........................7-13 Triggering a timer ........................7-14 Timer action overruns ......................
  • Page 11 Table of contents Model 2606B System SourceMeter® Instrument Reference Manual Measurement settling time considerations ................. 8-15 Effects of load on current source settling time ..............8-16 Creating pulses with the 2606B SMU ................8-17 Pulse rise and fall times ......................8-17 Pulse width ..........................
  • Page 12 Model 2606B System SourceMeter® Instrument Reference Manual Table of contents Standard Event Register ....................... 10-19 Operation Status Registers ....................10-21 Questionable Status Registers ....................10-22 Measurement Event Registers ....................10-22 Register programming example .................... 10-23 TSP-Link system status ....................10-24 Status model configuration example ..................
  • Page 13 Table of contents Model 2606B System SourceMeter® Instrument Reference Manual TSP-Link ..........................13-17 TSP-Net ..........................13-18 Userstrings ..........................13-18 Factory scripts ........................13-19 Running a factory script ......................13-19 Retrieving and modifying a factory script listing ..............13-20 KISweep factory script ......................13-20 KIPulse factory script ......................
  • Page 14 Model 2606B System SourceMeter® Instrument Reference Manual Table of contents Restore a script to the runtime environment ................. 14-50 Memory considerations for the runtime environment ............14-50 TSP-Link system expansion interface ................14-52 Master and subordinates ....................... 14-52 TSP-Link nodes ........................14-53 Connections ..........................
  • Page 15 Table of contents Model 2606B System SourceMeter® Instrument Reference Manual bufferVar.collecttimestamps ....................15-23 bufferVar.fillcount ........................15-24 bufferVar.fillmode ........................15-25 bufferVar.measurefunctions ....................15-25 bufferVar.measureranges ..................... 15-26 bufferVar.n ..........................15-28 bufferVar.readings ......................... 15-29 bufferVar.sourcefunctions ..................... 15-30 bufferVar.sourceoutputstates ....................15-31 bufferVar.sourceranges ......................15-31 bufferVar.sourcevalues ......................
  • Page 16 Model 2606B System SourceMeter® Instrument Reference Manual Table of contents display.trigger.clear() ......................15-84 display.trigger.EVENT_ID ..................... 15-84 display.trigger.overrun ......................15-84 display.trigger.wait() ......................15-85 display.waitkey() ........................15-86 errorqueue.clear() ......................... 15-87 errorqueue.count ........................15-88 errorqueue.next() ........................15-88 eventlog.all() .......................... 15-89 eventlog.clear() ........................15-90 eventlog.count ........................
  • Page 17 Table of contents Model 2606B System SourceMeter® Instrument Reference Manual lan.reset() ..........................15-135 lan.restoredefaults() ......................15-136 lan.status.dns.address[N] ....................15-137 lan.status.dns.name ......................15-137 lan.status.duplex ......................... 15-138 lan.status.gateway ......................15-139 lan.status.ipaddress ......................15-139 lan.status.macaddress ......................15-140 lan.status.port.dst ........................ 15-140 lan.status.port.rawsocket ....................15-141 lan.status.port.telnet ......................
  • Page 18 Model 2606B System SourceMeter® Instrument Reference Manual Table of contents script.factory.catalog() ......................15-178 script.load() ......................... 15-179 script.new().......................... 15-180 script.newautorun() ......................15-181 script.restore() ........................15-182 script.run() ........................... 15-182 script.user.catalog() ......................15-183 scriptVar.autorun ......................... 15-184 scriptVar.list() ........................15-185 scriptVar.name ........................15-185 scriptVar.run() ........................15-186 scriptVar.save() ........................
  • Page 19 Table of contents Model 2606B System SourceMeter® Instrument Reference Manual smuX.source.autorangeY ....................15-233 smuX.source.calibrateY() ....................15-234 smuX.source.compliance ....................15-235 smuX.source.delay ......................15-236 smuX.source.func ....................... 15-237 smuX.source.highc ......................15-237 smuX.source.levelY ......................15-238 smuX.source.limitY ......................15-239 smuX.source.lowrangeY ..................... 15-240 smuX.source.offfunc ......................15-241 smuX.source.offlimitY ......................
  • Page 20 Model 2606B System SourceMeter® Instrument Reference Manual Table of contents status.operation.instrument.smuX.* ..................15-303 status.operation.instrument.smuX.trigger_overrrun.* ............15-306 status.operation.instrument.trigger_blender.*..............15-308 status.operation.instrument.trigger_blender.trigger_overrun.* ..........15-309 status.operation.instrument.trigger_timer.* ................. 15-311 status.operation.instrument.trigger_timer.trigger_overrun.* ..........15-312 status.operation.instrument.tsplink.* ................... 15-315 status.operation.instrument.tsplink.trigger_overrun.* ............15-316 status.operation.measuring.*....................15-318 status.operation.remote.* ....................15-319 status.operation.sweeping.* ....................15-320 status.operation.trigger_overrun.* ..................
  • Page 21 Table of contents Model 2606B System SourceMeter® Instrument Reference Manual tsplink.readbit() ........................15-379 tsplink.readport() ......................... 15-379 tsplink.reset() ........................15-380 tsplink.state ......................... 15-381 tsplink.trigger[N].assert() ..................... 15-381 tsplink.trigger[N].clear() ....................... 15-382 tsplink.trigger[N].EVENT_ID ....................15-383 tsplink.trigger[N].mode ......................15-383 tsplink.trigger[N].overrun ..................... 15-385 tsplink.trigger[N].pulsewidth ....................15-386 tsplink.trigger[N].release() ....................
  • Page 22 Model 2606B System SourceMeter® Instrument Reference Manual Table of contents Voltage source accuracy ......................17-9 Voltage measurement accuracy .................... 17-11 Adjustment ........................17-12 Environmental conditions ...................... 17-12 Adjustment considerations ....................17-13 Calibration adjustment overview ................... 17-15 Calibration commands quick reference ................. 17-16 Adjustment procedure ......................
  • Page 24: Table Of Contents

    If you have any questions after you review the information in this documentation, please contact your local Keithley Instruments office, sales partner, or distributor. You can also call the Tektronix corporate headquarters (toll-free inside the U.S. and Canada only) at 1-800-833-9200. For worldwide...
  • Page 25: 2606B Documentation

    Section 1: Introduction Model 2606B System SourceMeter® Instrument Reference Manual 2606B documentation This reference manual contains the documentation for the 2606B. It is organized into the following sections: • Installation: Installation information, including dimension diagrams and power on information. • Instrument description: Descriptions of the front panel, rear panel, remote communications interfaces, and use of the virtual front panel.
  • Page 26: Product Software And Drivers

    Model 2606B System SourceMeter® Instrument Reference Manual Section 1: Introduction Product software and drivers Go to the Product Support and Downloads web page (tek.com/product-support) to download drivers and software for your instrument. Available drivers and software include: • KickStart Software: Enables quick test setup and data visualization when using one or more instruments.
  • Page 27: Capabilities And Features

    Section 1: Introduction Model 2606B System SourceMeter® Instrument Reference Manual Capabilities and features The 2606B has the following features: • 4.5, 5.5, or 6.5 digit display resolution • Resistance and power measurement functions • Two-quadrant source operation • Contact check function •...
  • Page 28: What You Should Have Received

    Model 2606B System SourceMeter® Instrument Reference Manual Section 1: Introduction What you should have received In addition to the 2606B, you should have received the items listed in the following table. Part number Description Quantity CA-180-16 LAN crossover cable, 0.41 m (16 in.) 174710700 Shielded crossover cable with RJ-45 connector, 1.5 m (5 ft.) Depends on country...
  • Page 29: General Ratings

    Section 1: Introduction Model 2606B System SourceMeter® Instrument Reference Manual General ratings The 2606B general ratings and connections of the instrument are listed in the following table. Category Specification Power supply 100 V ac to 240 V ac, 50 Hz or 60 Hz (autosensing); 425 VA maximum Input and output connections Front panel (on page 3-1) and...
  • Page 30 Section 2 Installation In this section: Installing the 2606B ..............2-1 Cooling vents ................2-1 Dimensions ................2-2 Turning the instrument on and off ..........2-4 Placing the 2606B in standby ........... 2-5 Warmup period ................. 2-5 Line frequency configuration ............ 2-6 System information ..............
  • Page 31: Dimensions

    Section 2: Installation Model 2606B System SourceMeter® Instrument Reference Manual To prevent damaging heat build-up and ensure specified performance, use the following guidelines. ▪ The rear exhaust vents and both side intake vents, and the front intake vents must be unobstructed to properly dissipate heat.
  • Page 32 Model 2606B System SourceMeter® Instrument Reference Manual Section 2: Installation Figure 1: 2606B dimensions - top view Figure 2: Dimensions - front view 2606B-901-01 Rev. C November 2021...
  • Page 33: Turning The Instrument On And Off

    Section 2: Installation Model 2606B System SourceMeter® Instrument Reference Manual Figure 3: Dimensions - side view Turning the instrument on and off The 2606B operates from a line voltage of 100 V to 240 V at a frequency of 50 Hz or 60 Hz. Line voltage is automatically sensed (there are no switches to set).
  • Page 34: Placing The 2606B In Standby

    Model 2606B System SourceMeter® Instrument Reference Manual Section 2: Installation Hazardous voltages may be present in the test system. To prevent injury or death, remove power from the instrument or test system and discharge any energy storage components (for example, capacitors or cables) before changing any connections that might allow contact with an uninsulated conductor.
  • Page 35: Line Frequency Configuration

    Section 2: Installation Model 2606B System SourceMeter® Instrument Reference Manual Line frequency configuration The factory configures the 2606B to detect the power line frequency automatically at each power-up. This detected line frequency (either 50 Hz or 60 Hz) is used for aperture (NPLC) calculations. In noisy environments, you can manually configure the instrument to match the actual line frequency.
  • Page 36 Section 3 Instrument description In this section: Front panel ................3-1 Rear panel................3-2 Remote communications interfaces ......... 3-3 Using the web interface ............3-15 Virtual Front Panel ..............3-24 Beeper ................... 3-33 Display mode ................. 3-34 Display operations ..............3-35 Front panel The front panel of the 2606B is shown below.
  • Page 37: Rear Panel

    Section 3: Instrument description Model 2606B System SourceMeter® Instrument Reference Manual Reverts the LAN settings and the instrument password to LAN RESET default values. Insert a straightened paper clip into the hole above LAN RESET to reset the LAN. See communications (on page 3-9).
  • Page 38: Remote Communications Interfaces

    Model 2606B System SourceMeter® Instrument Reference Manual Section 3: Instrument description Ground Ground terminal for connecting output HI or LO to Chassis ground chassis ground. This provides a connection terminal to the equipment frame. Line fuse and power receptacle Connect the line cord to the power receptacle and a grounded ac Line fuse and power outlet.
  • Page 39 Section 3: Instrument description Model 2606B System SourceMeter® Instrument Reference Manual Remote interface connections The remote interface connections are on the front panel. Each module has its own set of connections. Figure 6: Remote interface connections Output queue Response messages, such as those generated from print commands, are placed in the output queue. All remote command interfaces share the same output queue.
  • Page 40 Model 2606B System SourceMeter® Instrument Reference Manual Section 3: Instrument description Communicate with the instrument When using Virtual Instrument Software Architecture (VISA) to communicate with the USB device, you need to use a VISA communication driver. VISA requires a resource string in the following format to connect to the correct USB instrument: USB[board]::manufacturer ID::model code::serial number[::USB interface number][::INSTR]...
  • Page 41 Section 3: Instrument description Model 2606B System SourceMeter® Instrument Reference Manual Figure 8: Select Communication Bus dialog box 4. Select USB. 5. Select Next. The Select Instrument Driver dialog box is displayed. Figure 9: Select Instrument Driver dialog box 6. Select Auto-detect Instrument Driver - Model. 7.
  • Page 42 Model 2606B System SourceMeter® Instrument Reference Manual Section 3: Instrument description 8. Select Next. The Name Virtual Instrument dialog box is displayed. Figure 10: Name Virtual Instrument dialog box 9. In the Virtual Instrument Name box, enter a name that you want to use to refer to the instrument.
  • Page 43 Section 3: Instrument description Model 2606B System SourceMeter® Instrument Reference Manual 14. Select OK. 15. Send a command to the instrument and see if it responds. Figure 12: Send a command to the instrument If you have a full version of NI-VISA on your system, you can run NI-MAX or the VISA Interactive Utility.
  • Page 44 Model 2606B System SourceMeter® Instrument Reference Manual Section 3: Instrument description LAN communications The 2606B is an LXI version 1.4 Core 2011 compliant instrument that supports TCP/IP and complies with IEEE Std 802.3 (ethernet). The LAN ports for the modules are on the front panel of the 2606B and support full connectivity on a 10 Mbps or 100 Mbps network.
  • Page 45 Section 3: Instrument description Model 2606B System SourceMeter® Instrument Reference Manual LAN status LEDs The figure below illustrates the two status light-emitting diodes (LEDs) that are on the LAN port of the instrument. The table below the figure provides explanations of the LED states. The LED labeled 1 indicates the LAN port is connected to a 100 Mbps network.
  • Page 46 Model 2606B System SourceMeter® Instrument Reference Manual Section 3: Instrument description Instrument driver types There are several different styles of instrument drivers. Keithley Instruments provides the following instrument drivers for the 2606B: • A native LabVIEW driver • An IVI-C driver •...
  • Page 47 Section 3: Instrument description Model 2606B System SourceMeter® Instrument Reference Manual LabVIEW drivers Native LabVIEW drivers A native LabVIEW driver is a LabVIEW driver that is created using entirely built-in LabVIEW VIs. It does not make any calls to external DLLs or Library files. This makes the driver portable to all the platforms and operating systems that LabVIEW and VISA supports (such as Linux ®...
  • Page 48 Model 2606B System SourceMeter® Instrument Reference Manual Section 3: Instrument description Interchangeable Virtual Instruments (IVI) style drivers IVI Foundation (ivifoundation.org) defined a set of application programming interfaces (APIs) for instruments, including digital multimeters, arbitrary waveform/function generators, dc power supplies, ac power supplies, oscilloscopes, switches, spectrum analyzers, RF signal generators, and power meters.
  • Page 49 Section 3: Instrument description Model 2606B System SourceMeter® Instrument Reference Manual NI-VISA Runtime NI-VISA is National Instruments (NI ) implementation of the VISA standard. The Keithley I/O Layer (KIOL) contains a licensed version of the NI-VISA Runtime Engine that contains only the binary files (DLLs) that allow the NI-VISA drivers to operate.
  • Page 50: Using The Web Interface

    Model 2606B System SourceMeter® Instrument Reference Manual Section 3: Instrument description Using the web interface If you are connected to the 2606B using LAN communications, you can use an internet browser to connect to the instrument through the 2606B web interface. The LXI web interface allows you to change settings and control your instrument through the web interface.
  • Page 51 Section 3: Instrument description Model 2606B System SourceMeter® Instrument Reference Manual How to access the web interface When the LAN and instrument establish a connection, you can open the web page for the instrument. To access the web interface: 1. Open a web browser on the host computer. 2.
  • Page 52 Model 2606B System SourceMeter® Instrument Reference Manual Section 3: Instrument description Figure 15: Web interface Welcome page Use the ID button to identify the module You can select the ID button to determine which module you are communicating with. The ID button is below the menu on every page of the web interface. To identify the module: 1.
  • Page 53 Section 3: Instrument description Model 2606B System SourceMeter® Instrument Reference Manual To change the IP configuration using the instrument web page: 1. Access the internal web page as described in How to access the web interface (on page 3-16). 2. From the navigation bar on the left, select IP Configuration. 3.
  • Page 54 Model 2606B System SourceMeter® Instrument Reference Manual Section 3: Instrument description Set the instrument password You can change the instrument password from the web interface. The instrument password is used for access to the instrument from any remote interface. When password usage is enabled by the localnode.passwordmode command, you must supply a password to change the configuration or to control an instrument from a remote command interface.
  • Page 55 Section 3: Instrument description Model 2606B System SourceMeter® Instrument Reference Manual An example of the Reading Buffers page with the measurement and source functions displayed is shown in the following figure. Figure 17: Web interface Reading Buffers page Download reading buffer data using the web interface You can download reading buffer data to a .csv file from the Reading Buffers page of the web interface.
  • Page 56 Model 2606B System SourceMeter® Instrument Reference Manual Section 3: Instrument description Use TSB Embedded TSB Embedded is a script management tool that is available through the web interface of the instrument. You can use TSB Embedded to create, modify, and save test scripts, and to send individual commands.
  • Page 57 Section 3: Instrument description Model 2606B System SourceMeter® Instrument Reference Manual Logging LAN trigger events in the event log You can use the event log to record all LXI triggers generated and received by the 2606B. You can view the event log using any command interface or the embedded web interface. The following figure shows the view of the LXI event log from the Log option in the embedded web interface.
  • Page 58 Model 2606B System SourceMeter® Instrument Reference Manual Section 3: Instrument description Event log descriptions Column title Description Example A timestamp that identifies the time the event Timestamp occurred; the timestamp uses the following: ▪ PTP timestamp ▪ Seconds ▪ Fractional seconds; the 2606B does not support the IEEE Std 1588 standard;...
  • Page 59: Virtual Front Panel

    Section 3: Instrument description Model 2606B System SourceMeter® Instrument Reference Manual The string displays the same information as the web interface. Commas separate the fields. The fields output in the following order: • Received time (UTC time) • Event ID •...
  • Page 60 Model 2606B System SourceMeter® Instrument Reference Manual Section 3: Instrument description Virtual front panel options The virtual front panel of the 2606B is shown below. The descriptions of the controls and indicators follow the figure. Figure 19: Virtual front panel options 1.
  • Page 61 Section 3: Instrument description Model 2606B System SourceMeter® Instrument Reference Manual Performance control Sets the display resolution (4½, 5½, or 6½ digits). DIGITS Sets the measurement speed (FAST, MEDium, NORMAL, HI-ACCURACY, or OTHER). SPEED Speed and accuracy are set by controlling the measurement aperture. Also see Speed (on page 5-33).
  • Page 62 Model 2606B System SourceMeter® Instrument Reference Manual Section 3: Instrument description 3. Navigation wheel Turn the navigation wheel to: ▪ Move the cursor to the left and the right (the cursor indicates the selected value or item) ▪ While in edit mode, increase or decrease a selected source or compliance value Push the navigation wheel to: ▪...
  • Page 63 Section 3: Instrument description Model 2606B System SourceMeter® Instrument Reference Manual Display indicators (not shown) The items listed below represent the possible display indicators and their meanings. Indicator Meaning Remote (4-wire) sense is selected Source or measure autorange is selected AUTO Instrument is in editing mode EDIT...
  • Page 64 Model 2606B System SourceMeter® Instrument Reference Manual Section 3: Instrument description Menu trees You can configure instrument operation through the menus that are accessed from the virtual front panel. Main menu The main menu structure is summarized in the following figure and table. For other menu items, see Configuration menus (on page 3-30).
  • Page 65 Section 3: Instrument description Model 2606B System SourceMeter® Instrument Reference Manual Menu selection Description For more information, see: Saves and recalls user scripts Manage scripts (on page 14-3) SCRIPT - LOAD Loads scripts into nonvolatile memory - SAVE Saves scripts Saves and recalls user and factory setup Saved setups (on page 4-13)
  • Page 66 Model 2606B System SourceMeter® Instrument Reference Manual Section 3: Instrument description Figure 21: 2606B CONFIG menu tree Press the EXIT key to return to a previous menu. 2606B-901-01 Rev. C November 2021 3-31...
  • Page 67 Section 3: Instrument description Model 2606B System SourceMeter® Instrument Reference Manual The following table contains descriptions of the configuration menus with cross references to related information. To select a menu: 1. Select the CONFIG key. 2. Select CHANNEL-A, CHANNEL-B, or COMMON. COMMON accesses settings for TRIG and STORE.
  • Page 68: Beeper

    Model 2606B System SourceMeter® Instrument Reference Manual Section 3: Instrument description Setting source and compliance values When the 2606B is in the edit mode (EDIT indicator is on), the editing controls are used to set source and compliance values. Note that when you edit the source value, source autoranging is turned off and remains off until you turn it on again.
  • Page 69: Display Mode

    Section 3: Instrument description Model 2606B System SourceMeter® Instrument Reference Manual To turn the beeper on or off from the virtual front panel: 1. Press the MENU key, and then select BEEPER. 2. Select one of the following: ▪ ENABLE ▪...
  • Page 70: Display Operations

    Model 2606B System SourceMeter® Instrument Reference Manual Section 3: Instrument description Display operations This section describes methods for using the display and determining what is displayed. Display functions and attributes The display functions and attributes for the virtual front panel are described in this section. The following table lists each display function and attribute (in alphabetical order) and cross references it to the section topic where the function or attribute is explained.
  • Page 71 Section 3: Instrument description Model 2606B System SourceMeter® Instrument Reference Manual Display screen The virtual front panel displays source-measure values and readings or user-defined messages. The display screen options include: • Source-measure, compliance screens: Display SMU source-measure readings and compliance values. •...
  • Page 72 Model 2606B System SourceMeter® Instrument Reference Manual Section 3: Instrument description Display messages You can define text messages that can be displayed on the front panel of the instrument. Most of the display functions and attributes that are associated with display messaging automatically select the user screen.
  • Page 73 Section 3: Instrument description Model 2606B System SourceMeter® Instrument Reference Manual Cursor position When displaying a message, the cursor position determines where the message starts. On power-up, the cursor is positioned at row 1, column 1 (see the following figure). At this cursor position, a user-defined message is displayed on the top row (row 1).
  • Page 74 Model 2606B System SourceMeter® Instrument Reference Manual Section 3: Instrument description The following programming example illustrates how to position the cursor on row 2, column 1, and then read the cursor position: display.setcursor(2, 1) row, column = display.getcursor() print(row, column) Output: 2.00000e+00 1.00000e+00 Displaying text messages...
  • Page 75 Section 3: Instrument description Model 2606B System SourceMeter® Instrument Reference Manual The following programming example illustrates how to use the $N and $B character codes to display the message Test in Process on the top line and the blinking message Do Not Disturb on the bottom line: display.clear() display.settext("Test in Process $N$BDo Not Disturb")
  • Page 76 Model 2606B System SourceMeter® Instrument Reference Manual Section 3: Instrument description Sending the command without the row parameter returns both lines of the display. The $N character code is included to show where the top line ends and the bottom line begins. The $N character code is returned even if embellished is set to false.
  • Page 77 Section 3: Instrument description Model 2606B System SourceMeter® Instrument Reference Manual Parameter value prompting You can use the display.inputvalue() and display.prompt() functions to create an editable input field on the user screen at the present cursor position. The display.inputvalue() function uses the user screen at the present cursor position. Once the command is finished, it returns the user screen to its previous state.
  • Page 78 Model 2606B System SourceMeter® Instrument Reference Manual Section 3: Instrument description The following programming example illustrates how to prompt the operator to enter a source voltage value for SMU A: display.clear() value = display.prompt("0.00", "V", "Enter source voltage") display.screen = display.SMUA smua.source.levelv = value The script pauses after displaying the prompt message and waits for the operator to enter the voltage level.
  • Page 79 Section 3: Instrument description Model 2606B System SourceMeter® Instrument Reference Manual For example, assume the returned bitmap value is 34061. The binary equivalent of this value is as follows: 1000010100001101 For the above binary number, the following bits are set to 1: 16, 11, 9, 4, 3, and 1. Using the table, the following indicators are on: REL, REM, EDIT, AUTO, 4W, and FILT.
  • Page 80 Model 2606B System SourceMeter® Instrument Reference Manual Section 3: Instrument description Adding USER TESTS menu entries You can use the following function in either of two ways to add an entry into the USER TESTS menu: display.loadmenu.add(displayname, code) display.loadmenu.add(displayname, code, memory) Where: displayname The name string that is added to the USER TESTS menu.
  • Page 81 Section 3: Instrument description Model 2606B System SourceMeter® Instrument Reference Manual Deleting USER TESTS menu entries You can use the following function to delete an entry from the virtual front-panel USER TESTS menu: display.loadmenu.delete(displayname) Where: displayname Name to delete from the menu. The following programming example removes the entry named Part1 from the virtual front-panel USER TESTS menu: display.loadmenu.delete("Part1")
  • Page 82 Model 2606B System SourceMeter® Instrument Reference Manual Section 3: Instrument description display.getlastkey() The display.getlastkey() function immediately returns the key code for the last pressed key. The following programming example illustrates how to display the last key pressed: key = display.getlastkey() print(key) The above code returns the key code value (see the following table).
  • Page 83 Section 3: Instrument description Model 2606B System SourceMeter® Instrument Reference Manual The following programming example illustrates how to prompt the user to press the EXIT (LOCAL) key to abort the script, or any other key to continue it: display.clear() display.setcursor(1, 1) display.settext("Press EXIT to Abort") display.setcursor(2, 1) display.settext("or any key to continue")
  • Page 84 Section 4 Operation In this section: Limits ..................4-1 Fundamental circuit configurations ........... 4-2 DUT test connections ............... 4-3 Saved setups ................. 4-13 USB storage overview ............4-16 Displayed error and status messages ........4-18 Limits When sourcing voltage, the 2606B can be set to limit current or power. Conversely, when sourcing current, the 2606B can be set to limit voltage or power.
  • Page 85 Section 4: Operation Model 2606B System SourceMeter® Instrument Reference Manual Remote limit The table below summarizes basic commands to program a limit. For a more complete description of these commands, refer to the TSP command reference (on page 15-1). Limit commands Command Description smuX.source.limiti = limit...
  • Page 86 Model 2606B System SourceMeter® Instrument Reference Manual Section 4: Operation When sourcing current, you can measure voltage or current, as shown in the following figure. Figure 25: Fundamental source-measure configuration: Source I Current meter Current source ↑ Voltage meter Basic circuit configurations (on page 5-5) for detailed information.
  • Page 87 Section 4: Operation Model 2606B System SourceMeter® Instrument Reference Manual Input/output connectors ® The Keithley Instruments 2606B System SourceMeter instrument uses screw terminal connectors for input and output connections to devices under test (DUTs). You can remove a screw terminal connector from the rear panel by loosening the two captive retaining screws and pulling it off the rear panel.
  • Page 88 Model 2606B System SourceMeter® Instrument Reference Manual Section 4: Operation Figure 26: Input/output connectors Input/output LO and chassis ground The SMU input/output LOs are available at the rear-panel terminal blocks. Input/output LOs are not connected between channels and are electrically isolated from chassis ground. Figure 27: Input/output LO and chassis ground terminals The chassis screw is on the rear panel of the instrument and is connected to the metal chassis of the 2606B.
  • Page 89 Section 4: Operation Model 2606B System SourceMeter® Instrument Reference Manual Figure 28: 2606B chassis screw 2-wire local sensing connections You can use 2-wire local sensing measurements, shown in the following figure, for the following source-measure conditions: • Sourcing and measuring current. •...
  • Page 90 Model 2606B System SourceMeter® Instrument Reference Manual Section 4: Operation Use 4-wire remote sensing for the following source-measure conditions: • Sourcing or measuring voltage in low impedance (<1 kΩ) test circuits. • Enforcing voltage compliance limit directly at the DUT. When using 4-wire local sensing connections, make sure to properly configure the 2606B Sense mode selection...
  • Page 91 Section 4: Operation Model 2606B System SourceMeter® Instrument Reference Manual Safety shield A safety shield must be used whenever hazardous voltages (>30 V , 42 V ) will be PEAK present in the test circuit. To prevent electrical shock that could cause injury or death, never use the 2606B in a test circuit that may contain hazardous voltages without a properly installed and configured safety shield.
  • Page 92 Model 2606B System SourceMeter® Instrument Reference Manual Section 4: Operation Figure 31: Connections for guarding 1 Guard shield 2 Metal guard shield 3 Device under test (DUT) Noise shield Use a noise shield (see the following figure) to prevent unwanted signals from being introduced into the test circuit.
  • Page 93 Section 4: Operation Model 2606B System SourceMeter® Instrument Reference Manual Figure 32: Noise shield 1 Noise shield connected to LO 2 Noise shield 3 Device under test (DUT) Using shielding and guarding together The following figures show connections for a test system that uses a noise shield, a safety shield, and guarding.
  • Page 94 Model 2606B System SourceMeter® Instrument Reference Manual Section 4: Operation Figure 33: Connections for noise shield, safety shield, and guarding 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.
  • Page 95 Section 4: Operation Model 2606B System SourceMeter® Instrument Reference Manual Construction material: A metal test fixture must be connected to a known protective earth (safety ground) as described in the above WARNING. A nonconductive test fixture must be constructed of materials that are suitable for flammability, voltage, and temperature conditions that may exist in the test circuit.
  • Page 96 Model 2606B System SourceMeter® Instrument Reference Manual Section 4: Operation The 2606B connections for the floating configuration are shown below. Figure 35: Connections for floating a SMU All measurement connections should be considered to be hazardous. The maximum floating (common mode) voltage for a source-measure unit (SMU) is ±250 V. Exceeding this level may cause damage to the instrument and create a shock hazard.
  • Page 97 Section 4: Operation Model 2606B System SourceMeter® Instrument Reference Manual Saving user setups You can save the present 2606B setup to internal nonvolatile memory or a USB flash drive. To save a user setup to nonvolatile memory from the virtual front panel: 1.
  • Page 98 Model 2606B System SourceMeter® Instrument Reference Manual Section 4: Operation Recalling a saved setup using the front panel You can recall setups from internal nonvolatile memory or a USB flash drive. To recall a saved setup from the virtual front panel: 1.
  • Page 99 Section 4: Operation Model 2606B System SourceMeter® Instrument Reference Manual Restoring the factory default setups using remote commands Use one of the reset functions to return the 2606B to the original factory defaults. An example of each type of reset is shown in the following program examples. ®...
  • Page 100 Model 2606B System SourceMeter® Instrument Reference Manual Section 4: Operation Connecting the USB flash drive The 2606B supports flash drives that comply with USB 2.0 standards, 1.0, and 1.1 standards. You can save data to the USB flash drive from the virtual front panel, or you can create a script to save data to the USB flash drive.
  • Page 101 Section 4: Operation Model 2606B System SourceMeter® Instrument Reference Manual The instrument supports the following Lua fs commands: fs.chdir() (on page 15-103) fs.cwd() (on page 15-104) fs.is_dir() (on page 15-104) fs.is_file() (on page 15-105) fs.mkdir() (on page 15-106) fs.readdir() (on page 15-107) fs.rmdir() (on page 15-107) The following Lua fs commands are not supported:...
  • Page 102 Section 5 Sourcing and measuring In this section: Basic operation ................ 5-1 Basic circuit configurations ............5-5 Operation considerations for the ADC ........5-10 Sense mode selection ............5-11 Triggering in local mode ............5-12 Configuring for measure-only tests using the MODE key ..5-14 Voltmeter and ammeter measurements .........
  • Page 103 Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual Source-measure capabilities From the virtual front panel, you can configure the instrument to perform the following source-measure operations: • Source voltage: Measure and display current, voltage, resistance, or power •...
  • Page 104 Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring Step 2: Set the compliance limit To edit the compliance limit value: 1. Select the CONFIG key. 2. Select the LIMIT key. 3. Select CURRENT or VOLTAGE. 4. Select the ENTER key or the navigation wheel. 5.
  • Page 105 Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual Remote source-measure commands Basic source-measurement procedures can also be performed through a remote interface. To do this, send the appropriate commands. The following table summarizes basic source-measure commands. Introduction to TSP operation (on page 13-1) for more information on using these commands.
  • Page 106: Basic Circuit Configurations

    Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring Source-measure programming example The following SMU programming example illustrates the setup and command sequence of a basic source-measure procedure with the following parameters: • Source function and range: Voltage, autorange •...
  • Page 107 Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual Sense circuitry is used to monitor the output voltage continuously and make adjustments to the V-source as needed. The V-meter senses the voltage at the HI / LO terminals (2-wire local sense) or at the device-under-test (DUT) (4-wire remote sense using the sense terminals) and compares it to the programmed voltage level.
  • Page 108 Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring Source I When the instrument is configured to source current (I-source), as shown in the figure below, the instrument functions as a high-impedance current source with voltage limit capability and can measure current (I-meter) or voltage (V-meter).
  • Page 109 Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual Source I measure I, source V measure V ® The System SourceMeter instrument can measure the same function that it is sourcing. For example, when sourcing a voltage, you can measure voltage. Conversely, if you are sourcing current, you can measure the output current.
  • Page 110 Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring Figure 40: 2606B measure current only Contact check When a contact check measurement is made, two small current sources switch between the HI and SENSE HI terminals and the LO and SENSE LO terminals. By controlling the switches illustrated in the following figure, the current from these sources flows through the test leads and through the contact resistance, as shown.
  • Page 111: Operation Considerations For The Adc

    Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual Operation considerations for the ADC The following paragraphs discuss autozero and NPLC caching with the analog-to-digital converter (ADC) (on page 8-14). Autozero The ADC of the 2606B uses a ratiometric analog to digital (A/D) conversion technique. To ensure reading accuracy, the instrument must periodically obtain fresh measurements of its internal ground and voltage reference.
  • Page 112: Sense Mode Selection

    Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring Remote command autozero To set autozero from a remote interface: Use the autozero command with the appropriate option shown in the following table to set autozero through a remote interface (see smuX.measure.autozero (on page 15-212)).
  • Page 113: Triggering In Local Mode

    Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual Selecting the sense from the remote interface To select the remote sense from the remote interface: Set the smuX.sense attribute to control the sense state by remote. The programming example below illustrates how to configure the 2606B for 4-wire remote sensing: smua.sense = smua.SENSE_REMOTE The following table summarizes the commands to select the sense mode.
  • Page 114 Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring Figure 42: Local triggering Configuring trigger attributes in local mode From the virtual front panel, press the CONFIG key, and then select TRIG. The following menu items are available: •...
  • Page 115: Configuring For Measure-Only Tests Using The Mode Key

    Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual Front-panel triggering example This example uses the virtual front panel to configure the trigger parameters to meet the following requirements: • Manual triggering (TRIG key) • Infinite trigger count (cycle indefinitely through measurement cycles) •...
  • Page 116: Voltmeter And Ammeter Measurements

    Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring Voltmeter and ammeter measurements You can make voltmeter and ammeter measurements without using the MODE key, such as when configuring measure-only tests over the remote interface. To use the 2606B to measure voltage or current: 1.
  • Page 117 Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual Ohms ranging The virtual front-panel ohms function does not use ranging. The instrument formats a calculated resistance reading (V/I) to best fit the display. There may be leading zeros if the ohms reading is less than 1 mΩ.
  • Page 118 Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring Ohms programming example The following programming example illustrates the setup and command sequence of a typical ohms measurement procedure with the following parameters: • Source function: Current, 10 mA range, 10 mA output •...
  • Page 119 Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual Ohms sensing Ohms measurements can be made using either 2-wire or 4-wire sensing. See DUT test connections (on page 4-3) for information on connections and sensing methods. The 2-wire sensing method has the advantage of requiring only two test leads. However, as shown in the following figure (2-wire resistance sensing), test lead resistance can seriously affect the accuracy of 2-wire resistance measurements, particularly with lower resistance values.
  • Page 120: Power Measurements

    Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring The 4-wire sensing method, as shown in the following figure (4-wire resistance sensing), minimizes or eliminates the effects of lead resistance by measuring the voltage across the resistor under test with a second set of test leads.
  • Page 121 Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual Basic power measurement procedure If you need to customize the standard wattmeter configuration of the MODE key, perform the following steps to make power measurements. The following procedure assumes that the 2606B is already connected to the device under test (DUT) as explained in DUT test connections page 4-3).
  • Page 122 Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring Power measurements using the remote interface The following paragraphs summarize basic power measurement commands using the remote interface and also give a programming example for a typical power measurement situation. Remote power reading command The programming example below illustrates how to get a power reading from SMU A: reading = smua.measure.p()
  • Page 123: Contact Check Measurements

    Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual Contact check measurements The contact check function prevents measurements that may be in error due to excessive resistance in the force or sense leads when making remotely sensed (Kelvin) measurements. Potential sources for this resistance include poor contact at the device under test (DUT), failing relay contacts on a switching card, and wires that are too long or thin.
  • Page 124 Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring Contact check commands The following table summarizes the basic contact check commands. For a more complete description of these commands, refer to the TSP command reference (on page 15-1). For connection information, refer to Contact check connections (on page 5-23).
  • Page 125: Multiple Smu Connections

    Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual Multiple SMU connections Connecting two 2606B channels in parallel or in series may result in voltages or power levels that exceed the safety mechanisms. This increases the risk of instrument damage and the possibility of personal injury or death due to electric shock.
  • Page 126: Output-Off Modes

    Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring Figure 46: Three channels connected to a 3-terminal device Output-off modes Carefully consider and configure the appropriate output-off state, source function, and compliance limits before connecting the 2606B to a device that can deliver energy (for example, other voltage sources, batteries, capacitors, solar cells, or other 2606B instruments).
  • Page 127 Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual High-impedance output-off mode For the high-impedance output-off mode (HI-Z), the output relay opens when the output is turned off. This disconnects external circuitry from the input/output of the source-measure unit (SMU). To prevent excessive wear on the output relay, do not use this output-off mode for tests that turn the output off and on frequently.
  • Page 128 Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring You can set the output-off function to CURRENT or VOLTAGE through the CONFIG menu on the virtual front panel, or by using the smuX.source.offfunc attribute from a remote interface. VOLTAGE is the default output-off function.
  • Page 129 Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual Output-off limits (compliance) You can set output-off limits (compliance) for the current and voltage output-off functions using the CONFIG menu on the 2606B virtual front panel, or by setting the smuX.source.offlimitY attribute from a remote interface.
  • Page 130: Range

    Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring Range The selected measurement range affects the accuracy of the measurements and the maximum signal that can be measured. If the range is changed, the virtual front-panel display may contain dashes instead of a reading (for example, --.---- mA).
  • Page 131 Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual Manual ranging To select a range from the virtual front panel, use the range keys, • To set the source range, press the SRC key, and then use the RANGE keys to set the range. •...
  • Page 132 Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring Range considerations The source range and measure range settings can interact depending on the source function. Additionally, the output state (on or off) can affect how the range is set. The following table describes these interactions.
  • Page 133: Digits

    Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual Source range and limit commands Command* Description smuX.source.autorangei = smuX.AUTORANGE_ON Enable current source autorange. smuX.source.autorangei = smuX.AUTORANGE_OFF Disable current source autorange. smuX.source.autorangev = smuX.AUTORANGE_ON Enable voltage source autorange. smuX.source.autorangev = smuX.AUTORANGE_OFF Disable voltage source autorange.
  • Page 134: Speed

    Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring Setting display resolution from the virtual front panel To set the display resolution, press the DIGITS key until the correct number of digits is displayed. Available display resolutions are 4.5, 5.5, and 6.5 digits. Setting display resolution from a remote interface The following table summarizes use of the display.smuX.digits command.
  • Page 135: Sweep Operation

    Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual Setting the speed from the virtual front panel Press the SPEED key (or use the CONFIG menu) to display the following menu items: • FAST: Sets the measurement speed to 0.01 PLC (fast performance, but accuracy is reduced). •...
  • Page 136 Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring Figure 47: DC and pulsed linear staircase sweeps DC and pulsed logarithmic staircase sweeps: In this type of sweep, the current or voltage increases or decreases geometrically, beginning with a start voltage or current and ending with a stop voltage or current.
  • Page 137 Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual Linear staircase sweeps As shown below, this sweep type steps from a start voltage or current value to an ending (stop) value. When enabled, a measurement is made at each point after the source and measurement settling time.
  • Page 138 Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring To configure a linear staircase sweep, use the smuX.trigger.source.linearY() command. This function configures the source values the SMU outputs when performing a linear sweep. After configuring the sweep, you must also enable the source action by setting the following attribute:* smuX.trigger.source.action * smuX can be smua for channel A or smub for channel B Example:...
  • Page 139 Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual Figure 51: Increasing logarithmic sweep Figure 52: Decreasing logarithmic sweep Solving for k and b provides the following formulas: 5-38 2606B-901-01 Rev. C November 2021...
  • Page 140 Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring Where: = The source value at the end point = The source value at the start point start = The number of points in the sweep = The asymptote value The number of points in a sweep is one greater than the number of steps in the sweep.
  • Page 141 Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual In this example: A = 0, V = 1, V = 10, N = 5 start Using the formula above, k = 1 Step size (b) for the sweep in the above figure is calculated as follows: (log step size) Therefore, b = 10 = 1.7783...
  • Page 142 Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring List sweeps Use a list sweep to configure a sweep with arbitrary steps. When enabled, a measurement is made at each point after source and measurement settling time. To configure a list sweep, use the smuX.trigger.source.listY()function.
  • Page 143 Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual Pulse mode sweeps To create a pulse sweep for any of the sweep types, configure the end pulse action. To configure a pulse sweep for source-measure unit (SMU) A, send: smua.trigger.endpulse.action = smua.SOURCE_IDLE To configure a dc sweep for SMU A, send: smua.trigger.endpulse.action = smua.SOURCE_HOLD...
  • Page 144 Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring Pulse duty cycle Duty cycle is the percentage of time during the pulse period that the output is on. It is calculated as follows: Duty cycle = Pulse width / (Pulse width + Off time) For example, if the pulse width is 10 ms and the off time is 90 ms, the duty cycle is calculated as follows: Duty cycle...
  • Page 145 Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual Configuring measurements during a sweep You can make measurements during a sweep using the smuX.trigger.measure.Y() function. When sweeps are run, measurements are stored in the specified reading buffer for later recall. You can specify which reading buffer stores the readings.
  • Page 146 Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring Initiating and running sweeps To run a sweep, you must configure the number of sweep points to output and the number of sweeps to perform. See Triggering (on page 7-1) for more information. Examples: To start a sweep, use the smuX.trigger.initiate() function.
  • Page 147 Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual Sweep programming examples The following topics provide procedures for programming and running a sweep. Each of these procedures includes commands for a typical sweep example. The following table summarizes parameters for each of these examples.
  • Page 148: Relative Offset

    Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring Pulse current sweep example The programming example below illustrates a pulse sweep. -- Restore 2606B defaults. 1. Configure source functions. smua.reset() Restores defaults and sets the -- Set compliance to 10 V. compliance to 10 V.
  • Page 149 Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual Enabling and disabling relative offset from the front panel To enable and use the relative offset feature, press the REL key on the virtual front panel. The reading (which becomes the relative offset value) is subtracted from itself, causing the SMU to display a zero value.
  • Page 150: Filters

    Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring Filters The filter feature lets you set the filter response to stabilize noisy measurements. The 2606B uses a digital filter, which is based on reading conversions. The displayed, stored, or transmitted reading is calculated using one or more reading conversions (from 1 to 100).
  • Page 151 Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual The moving filter uses a first-in, first-out stack. When the stack (filter count) becomes full, the measurement conversions are averaged, yielding a reading. For each subsequent conversion placed into the stack, the oldest conversion is discarded.
  • Page 152 Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring Configuring the filter from the front panel Filter type and count are configured from the filter configuration menu on the virtual front panel. The same filter configuration is used for all measurement functions. To configure the filter: 1.
  • Page 153 Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual High-capacitance mode The Keithley Instruments 2606B has a high-capacitance mode. Because the source-measure unit (SMU) can measure low current, issues can arise when driving a capacitive load. The pole formed by the load capacitance and the current range resistor can cause a phase shift in the SMU voltage control loop.
  • Page 154 Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring Source settling times Each 2606B source-measure unit (SMU) can drive up to 50 µF of a capacitance in high-capacitance mode. To accomplish this, the speed of the 2606B SMU is reduced. Source settling times increase when high-capacitance mode is enabled.
  • Page 155 Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual The total response times while in high-capacitance mode are a combination of the time spent charging the capacitor (current limit) or the response time, whichever is greater. There is a direct relationship between the current limit and the charging time.
  • Page 156 Model 2606B System SourceMeter® Instrument Reference Manual Section 5: Sourcing and measuring To enable high-capacitance mode from the virtual front panel: 1. Press the CONFIG key. 2. Press the SRC key and then select HIGHC-MODE. 3. Select SRC-ENABLE and then press the navigation wheel (or the ENTER key). 4.
  • Page 157 Section 5: Sourcing and measuring Model 2606B System SourceMeter® Instrument Reference Manual Script example Use the smuX.source.highc attribute to set and control the options for high-capacitance mode. The programming examples and figure below illustrate how to enable high-capacitance mode on SMU A.
  • Page 158 Section 6 Reading buffers In this section: Overview .................. 6-1 Front-panel reading buffer control ..........6-1 Remote reading buffer programming ........6-6 Buffer examples ..............6-13 Overview Reading buffers capture measurements, ranges, instrument status, and output state of the Keithley Instruments 2606B.
  • Page 159 Section 6: Reading buffers Model 2606B System SourceMeter® Instrument Reference Manual Reading buffer options The following list outlines the menu structure and menu items associated with virtual front-panel reading buffer control. This section provides a description for each reading buffer option. Use the procedure in Configuring reading buffers (on page 6-3) as a guideline to configure these reading...
  • Page 160 Model 2606B System SourceMeter® Instrument Reference Manual Section 6: Reading buffers Configuring reading buffers To configure reading buffers from the virtual front panel: Enabling or disabling the source value or the timestamp is optional. 1. Press the CONFIG key. 2. Press the STORE key and then choose one of the following: ▪...
  • Page 161 Section 6: Reading buffers Model 2606B System SourceMeter® Instrument Reference Manual Appending or overwriting existing reading buffers When storing data to a reading buffer that already holds data, the new data can be appended to the reading buffer data, or it can overwrite the old data. To configure the instrument to append or overwrite measurements the next time data is acquired: 1.
  • Page 162 Model 2606B System SourceMeter® Instrument Reference Manual Section 6: Reading buffers Saving reading buffers You can save the dedicated reading buffers to nonvolatile memory or you can save them to a USB flash drive. The instrument restores the dedicated reading buffers from internal nonvolatile memory when the instrument is turned off and back on.
  • Page 163 Section 6: Reading buffers Model 2606B System SourceMeter® Instrument Reference Manual Recalling readings To recall the data stored in a reading buffer from the virtual front panel: 1. Press the RECALL key. 2. Select DATA or STATISTICS. 3. Select the buffer to display: CHANA-BUFF1 or CHANB-BUFF2. The data or statistics are displayed.
  • Page 164 Model 2606B System SourceMeter® Instrument Reference Manual Section 6: Reading buffers Dedicated reading buffer designations Each source-measure unit (SMU) contains dedicated reading buffers: • smua.nvbuffer1 (buffer 1 for channel A) • smua.nvbuffer2 (buffer 2 for channel A) • smub.nvbuffer1 (buffer 1 for channel B) •...
  • Page 165 Section 6: Reading buffers Model 2606B System SourceMeter® Instrument Reference Manual Command Description Commands to store readings smuX.measure.count = count The number of measurements to acquire. smuX.measure.overlappedi(rbuffer) Makes current measurements; stores readings in rbuffer. smuX.measure.overlappediv(ibuffer, Makes both current and voltage measurements; stores vbuffer) current readings in ibuffer and stores voltage readings in vbuffer.
  • Page 166 Model 2606B System SourceMeter® Instrument Reference Manual Section 6: Reading buffers Buffer storage control attributes The following table contains buffer storage control attributes. Before changing the collectsourcevalues, collecttimestamps, or timestampresolution attributes, you must clear the buffer using the smuX.nvbuffer1.clear() or smuX.nvbuffer2.clear() command.
  • Page 167 Section 6: Reading buffers Model 2606B System SourceMeter® Instrument Reference Manual Buffer read-only attributes The following table contains buffer read-only attributes that access the buffer parameters. Attribute Description basetimestamp The timestamp of when the reading at rb[1] was stored, in seconds from midnight January 1, 1970 GMT.
  • Page 168 Model 2606B System SourceMeter® Instrument Reference Manual Section 6: Reading buffers Statistic attributes Use the smuX.buffer.getstats() function to access the reading buffer data statistics. The table below lists the attributes that you can use to access the reading buffer statistics. Attributes for accessing reading buffer data Attribute When returned...
  • Page 169 Section 6: Reading buffers Model 2606B System SourceMeter® Instrument Reference Manual Example: The following programming example illustrates how to output mean and standard deviation statistics from buffer 1: statistics = smua.buffer.getstats(smua.nvbuffer1) print(statistics.mean, statistics.stddev) Reading buffer attributes Use the reading buffer attributes to access the reading buffer data. The table below displays the attributes that you can use to access the reading buffer data.
  • Page 170 Model 2606B System SourceMeter® Instrument Reference Manual Section 6: Reading buffers Buffer status The buffer reading status attribute includes the status information as a numeric value; see the following table for values. For example, to access status information for the second element of SMU channel A buffer 1, use the following command: stat_info = smua.nvbuffer1.statuses[2] Buffer status bits...
  • Page 171 Section 6: Reading buffers Model 2606B System SourceMeter® Instrument Reference Manual -- Restore 2606B defaults. smua.reset() -- Select channel A display. display.screen = display.SMUA -- Display current. display.smua.measure.func = display.MEASURE_DCAMPS -- Select measure I autorange. smua.measure.autorangei = smua.AUTORANGE_ON -- Select ASCII data format. format.data = format.ASCII -- Clear buffer 1.
  • Page 172 Model 2606B System SourceMeter® Instrument Reference Manual Section 6: Reading buffers Dual buffer example The programming example below shows a script that stores current and voltage readings using buffer 1 for current and buffer 2 for voltage readings. The 2606B stores 100 current and voltage readings and then recalls all 100 sets of readings.
  • Page 173 Section 6: Reading buffers Model 2606B System SourceMeter® Instrument Reference Manual Dynamically allocated buffer example The programming example below illustrates how to store data to an allocated buffer called mybuffer. The 2606B stores 100 current readings in mybuffer and then recalls all the readings. -- Restore 2606B defaults.
  • Page 174 Section 7 Triggering In this section: Triggering ................. 7-1 Remote triggering overview............7-1 Using the remote trigger model ..........7-3 SMU event detectors ..............7-7 Using trigger events to start actions on trigger objects ... 7-10 Digital I/O port and TSP-Link synchronization lines ....7-11 Timers ..................
  • Page 175 Section 7: Triggering Model 2606B System SourceMeter® Instrument Reference Manual Both programming methods use trigger objects. Trigger objects generate and monitor trigger events. ® External triggers are possible using digital I/O, TSP-Link synchronization lines, LAN, command interface, and the manual trigger (the TRIG key). The following figure graphically represents all the trigger objects of the 2606B instrument.
  • Page 176 Model 2606B System SourceMeter® Instrument Reference Manual Section 7: Triggering Trigger events are identified by means of an event ID. The following table describes the trigger event IDs. Trigger event IDs* Event ID** Event description smuX.trigger.SWEEPING_EVENT_ID Occurs when the source-measure unit (SMU) transitions from the idle state to the arm layer of the trigger model smuX.trigger.ARMED_EVENT_ID...
  • Page 177 Section 7: Triggering Model 2606B System SourceMeter® Instrument Reference Manual Figure 60: Remote trigger model: Normal (synchronous) mode 2606B-901-01 Rev. C November 2021...
  • Page 178 Model 2606B System SourceMeter® Instrument Reference Manual Section 7: Triggering Figure 61: Remote trigger model: Asynchronous mode When the smuX.trigger.measure.action attribute is set to smuX.DISABLE or smuX.ENABLE, the trigger model operates in synchronous measurement mode. When it is set to smuX.ASYNC, it operates in asynchronous mode.
  • Page 179 Section 7: Triggering Model 2606B System SourceMeter® Instrument Reference Manual Each section of the trigger model performs a function: If a sweep is not in process, the SMU is in the idle state. Use the Idle state smuX.trigger.initiate() function to move the SMU from the idle state to the arm layer.
  • Page 180: Smu Event Detectors

    Model 2606B System SourceMeter® Instrument Reference Manual Section 7: Triggering For more information about the sweep functions, refer to Sweep operations (on page 5-34). Configured source and measure delays are imposed when the SMU executes the source and measure action blocks. Additionally, if the measure count setting is greater than one, then the measure count is satisfied each time the measure action is performed.
  • Page 181 Section 7: Triggering Model 2606B System SourceMeter® Instrument Reference Manual Event detectors Event detector Function Controls entry into the trigger layer of the trigger model. Source Controls execution of the source action. Measure Controls execution of the measurement action. End pulse Controls execution of the end pulse action.
  • Page 182 Model 2606B System SourceMeter® Instrument Reference Manual Section 7: Triggering -- Configure a 10-point source voltage sweep. smua.trigger.source.linearv(1, 10, 10) smua.trigger.source.action = smua.ENABLE -- Configure the TRIG key press as an input trigger for source action. smua.trigger.source.stimulus = display.trigger.EVENT_ID -- Configure the SMU to execute a single 10-point sweep. smua.trigger.count = 10 smua.trigger.arm.count = 1 -- Turn on the output in preparation for the sweep.
  • Page 183: Using Trigger Events To Start Actions On Trigger Objects

    Section 7: Triggering Model 2606B System SourceMeter® Instrument Reference Manual Using trigger events to start actions on trigger objects You can configure trigger objects to respond to events generated by other trigger objects, such as using a digital I/O trigger to initiate a sweep. To configure a trigger object to monitor for an event, assign the event ID of the trigger event to the stimulus input.
  • Page 184: Digital I/O Port And Tsp-Link Synchronization Lines

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

    Model 2606B System SourceMeter® Instrument Reference Manual Section 7: Triggering Action overruns on hardware lines ® An action overrun occurs when a trigger event is received before the digital I/O or TSP-Link line is ready to process it. The generation of an action overrun is dependent upon the trigger mode selected for that line.
  • Page 187 Section 7: Triggering Model 2606B System SourceMeter® Instrument Reference Manual Pass-through mode When enabled, the timer generates a trigger event immediately when it is triggered. The timer generates additional trigger events each time a delay expires. If the pass-through attribute is disabled, the timer does not generate a trigger event until after the first delay elapses.
  • Page 188 Model 2606B System SourceMeter® Instrument Reference Manual Section 7: Triggering Timer action overruns The timer receives an action overrun when it generates a trigger event while a timer delay is still in progress. Use the status model to monitor for the occurrence of action overruns. For details, see Status model (on page 10-1).
  • Page 189 Section 7: Triggering Model 2606B System SourceMeter® Instrument Reference Manual Figure 66: Single-pulse triggering Single pulse example code Even though no measurements are made in this example, a measure range is set. When sourcing voltage, it is good practice to set the current measure range equal to the triggered source limit range. This is especially important when the triggered limit is greater than 100 mA.
  • Page 190 Model 2606B System SourceMeter® Instrument Reference Manual Section 7: Triggering -- Reset SourceMeter instrument to default conditions. reset() -- Generate a single pulse with the following characteristics: Bias (idle) level = 0 V Pulse level = 5 V Pulse width = 500 us -- Configure the source function.
  • Page 191 Section 7: Triggering Model 2606B System SourceMeter® Instrument Reference Manual Pulse train example The SMU programming example below illustrates how to use two timers: One to control the pulse period, a second to control the pulse width. The example configures the timers and SMU as follows: Timer 1: Pulse period timer •...
  • Page 192 Model 2606B System SourceMeter® Instrument Reference Manual Section 7: Triggering The following figure shows the trigger setup for this example. Figure 68: Pulse train triggering 2606B-901-01 Rev. C November 2021 7-19...
  • Page 193 Section 7: Triggering Model 2606B System SourceMeter® Instrument Reference Manual Pulse train example code Even though no measurements are made in this example, a measure range is set. When sourcing voltage, it is good practice to set the current measure range equal to the triggered source limit range. This is especially important when the triggered limit is greater than 100 mA.
  • Page 194: Event Blenders

    Model 2606B System SourceMeter® Instrument Reference Manual Section 7: Triggering -- Set the trigger source limit, which can be different than the bias limit. -- This is an important setting for pulsing in the extended operating area. smua.trigger.source.limiti = 1 smua.measure.rangei = 1 -- Trigger SMU source action with the period timer event.
  • Page 195: Lan Triggering Overview

    Section 7: Triggering Model 2606B System SourceMeter® Instrument Reference Manual Assigning input trigger events Each event blender has four stimulus inputs. You can assign a different trigger event ID to each stimulus input. The programming example below illustrates how to assign the source complete event IDs of SMU A and SMU B to stimulus inputs 1 and 2 of event blender 1: trigger.blender[1].stimulus[1] = smua.SOURCE_COMPLETE_EVENT_ID trigger.blender[1].stimulus[2] = smub.SOURCE_COMPLETE_EVENT_ID...
  • Page 196 Model 2606B System SourceMeter® Instrument Reference Manual Section 7: Triggering LXI trigger edge detection Stateless event Hardware value Pseudo line state Falling edge Rising edge flag Detected Detected Detected Detected Detected Detected Detected Detected Set the LAN trigger mode to configure the edge detection method in incoming LXI trigger packets. The mode that is selected also determines the hardware value in outgoing LXI trigger packets.
  • Page 197: Command Interface Triggering

    Section 7: Triggering Model 2606B System SourceMeter® Instrument Reference Manual Make sure to use the same LXI domain on both the 2606B instrument and the other instrument. If the 2606B has a different LXI domain than the instrument at the other end of the trigger connection, the LXI trigger packets are ignored by both instruments.
  • Page 198: Manual Triggering

    Model 2606B System SourceMeter® Instrument Reference Manual Section 7: Triggering Manual triggering The TRIG key is used for manual triggering. Each time the TRIG key is pressed, a trigger event is generated. You can monitor for a manual trigger event using the event ID display.trigger.EVENT_ID.
  • Page 199 Section 7: Triggering Model 2606B System SourceMeter® Instrument Reference Manual Using the assert function to generate output triggers You can use certain trigger objects to generate output triggers on demand. These trigger objects are the digital I/O lines, TSP-Link synchronization lines, and the LAN. The programming example below illustrates how to generate an output trigger using the assert function of the trigger object.
  • Page 200 Model 2606B System SourceMeter® Instrument Reference Manual Section 7: Triggering Using the set function to bypass SMU event detectors The set functions are useful whenever you want the source-measure unit (SMU) to continue operation without waiting for a programmed trigger event. There is a set function for each SMU event detector.
  • Page 201 Section 7: Triggering Model 2606B System SourceMeter® Instrument Reference Manual Examples using interactive triggering The following examples demonstrate how to use interactive triggering. Command interface interactive trigger example The programming example below illustrates how to clear triggers, turn on the SMU output, and then enable a 30-second timeout to wait for a command interface trigger.
  • Page 202: Hardware Trigger Modes

    Model 2606B System SourceMeter® Instrument Reference Manual Section 7: Triggering Digital I/O triggering interactive example The programming example below illustrates how to configure digital I/O line 2 as an input trigger and digital I/O line 14 as an output trigger. The 2606B to wait for an external input trigger on digital I/O line 2.
  • Page 203 Section 7: Triggering Model 2606B System SourceMeter® Instrument Reference Manual Falling edge trigger mode The falling edge trigger mode generates low pulses and detects all falling edges. The figure titled "Falling edge input trigger" shows the characteristics of the falling edge input trigger; the figure titled "Falling edge output trigger"...
  • Page 204 Model 2606B System SourceMeter® Instrument Reference Manual Section 7: Triggering Rising edge master trigger mode Use the rising edge master (RisingM) trigger mode (see the figure titled "RisingM output trigger") to synchronize with non-Keithley instruments that require a high pulse. Input trigger detection is not available in this trigger mode.
  • Page 205 Section 7: Triggering Model 2606B System SourceMeter® Instrument Reference Manual Output characteristics: • In addition to trigger events from other trigger objects, the digio.trigger[N].assert() and tsplink.trigger[N].assert() commands generate a low pulse that is similar to the falling edge trigger mode. Figure 73: RisingA output trigger Either edge trigger mode The either edge trigger mode generates a low pulse and detects both rising and falling edges.
  • Page 206: Understanding Synchronous Triggering Modes

    Model 2606B System SourceMeter® Instrument Reference Manual Section 7: Triggering Output characteristics: • In addition to trigger events from other trigger objects, the digio.trigger[N].assert() and tsplink.trigger[N].assert() commands generate a low pulse that is similar to the falling edge trigger mode. •...
  • Page 207 Section 7: Triggering Model 2606B System SourceMeter® Instrument Reference Manual Use the SynchronousM trigger mode to receive notification when the triggered action on all nodes is complete. Input characteristics: • All rising edges are input triggers. • When all external drives release the physical line, the rising edge is detected as an input trigger. •...
  • Page 208 Model 2606B System SourceMeter® Instrument Reference Manual Section 7: Triggering Synchronous acceptor trigger mode (SynchronousA) Use the synchronous acceptor trigger mode (SynchronousA) on a trigger subordinate that operates with a trigger master configured for the SynchronousM trigger mode. The roles of the internal and external drives are reversed in the SynchronousA trigger mode.
  • Page 209 Section 7: Triggering Model 2606B System SourceMeter® Instrument Reference Manual Synchronous trigger mode The synchronous trigger mode is a combination of SynchronousA and SynchronousM trigger modes. Use the Synchronous trigger mode for compatibility with older Keithley Instruments products. Keithley Instruments recommends using SynchronousA and SynchronousM modes only. Input characteristics: •...
  • Page 210: Digital I/O

    Model 2606B System SourceMeter® Instrument Reference Manual Section 7: Triggering Digital I/O The 2606B has a digital input/output port on each module that can be used to control external digital circuitry. For example, you can use a handler that performs binning operations with a digital I/O port. Port configuration The digital I/O port, a standard DB-25 socket connector (shown below), is on the front panel.
  • Page 211 Section 7: Triggering Model 2606B System SourceMeter® Instrument Reference Manual Digital I/O configuration The following figure shows the basic configuration of the digital I/O port. Writing a 1 to a line sets that line high (~ +5 V). Writing a 0 to a line sets that line low (~0 V). Note that an external device pulls an I/O line low by shorting it to ground, so that a device must be able to sink at least 960 μA per I/O line.
  • Page 212 Model 2606B System SourceMeter® Instrument Reference Manual Section 7: Triggering To write-protect specific digital I/O lines to prevent their values from being changed: 1. Press the MENU key, then select DIGOUT and then press the ENTER key or the navigation wheel. 2.
  • Page 213 Section 7: Triggering Model 2606B System SourceMeter® Instrument Reference Manual You can use the digital I/O lines for both input and output. You must write a 1 to all digital I/O lines that are to be used as inputs. Remote digital I/O commands Command Description digio.readbit(bit)
  • Page 214: Tsp-Link Trigger Lines

    Model 2606B System SourceMeter® Instrument Reference Manual Section 7: Triggering Figure 84: Using the output enable line Front-panel control of output enable To activate the output enable line from the virtual front panel: 1. Press the CONFIG key followed by the OUTPUT ON/OFF control. 2.
  • Page 215 Section 7: Triggering Model 2606B System SourceMeter® Instrument Reference Manual Each trigger line is an open-drain signal. When using the TSP-Link trigger lines for digital I/O, any node that sets the programmed line state to zero (0) causes all nodes to read 0 from the line state. This occurs regardless of the programmed line state of any other node.
  • Page 216 Section 8 Theory of operation In this section: Source-measure concepts ............8-1 Analog-to-digital converter ............. 8-14 Measurement settling time considerations ......8-15 Effects of load on current source settling time......8-16 Creating pulses with the 2606B SMU ........8-17 Source-measure concepts This section provides detailed information about source-measure concepts, including: •...
  • Page 217 Section 8: Theory of operation Model 2606B System SourceMeter® Instrument Reference Manual Overheating protection Proper ventilation is required to keep the 2606B from overheating. Even with proper ventilation, the 2606B can overheat if the ambient temperature is too high. The 2606B has an overtemperature protection circuit that turns the output off if the instrument overheats.
  • Page 218 Model 2606B System SourceMeter® Instrument Reference Manual Section 8: Theory of operation Duty cycle The value from 0 to 1 that represents the amount of time spent at pulse level versus bias level: For dc operation where the off state is 0 V or 0 A, Duty Cycle = 1. and V The voltage and current levels when the instrument is on.
  • Page 219 Section 8: Theory of operation Model 2606B System SourceMeter® Instrument Reference Manual Figure 85: 2606B continuous power operating boundaries V-source operating boundaries The following figures show the operating boundaries for the voltage source. Only the first quadrant of operation is shown. Operation in the other quadrant is similar. The following figure shows the output characteristics for the voltage source.
  • Page 220 Model 2606B System SourceMeter® Instrument Reference Manual Section 8: Theory of operation The following figure shows the limit lines for the voltage source. The voltage source limit line represents the maximum source value possible for the presently selected voltage source range. For example, if you are using the 20 V source range, the voltage source limit line is at 20.2 V.
  • Page 221 Section 8: Theory of operation Model 2606B System SourceMeter® Instrument Reference Manual Figure 88: Normal voltage source operation Voltage source operation in current compliance In the following figure, the resistance of the load is decreased to 800 Ω. The DUT load line for 800 Ω intersects the current compliance limit line, placing the 2606B in compliance.
  • Page 222 Model 2606B System SourceMeter® Instrument Reference Manual Section 8: Theory of operation Voltage source operation in power compliance The figure below shows what happens if a power limit of 60 mW is applied. As the instrument attempts to output the programmed source value of 10 V, the power compliance limit line is reached, placing the 2606B in power compliance.
  • Page 223 Section 8: Theory of operation Model 2606B System SourceMeter® Instrument Reference Manual Figure 91: Programmed voltage source sweep operation in current and power compliance I-source operating boundaries The following figures show the operating boundaries for the current source. Only the first quadrant of operation is shown;...
  • Page 224 Model 2606B System SourceMeter® Instrument Reference Manual Section 8: Theory of operation The following figure shows the limit lines for the current source. The current source limit line represents the maximum source value possible for the presently selected current source range. The voltage compliance limit line represents the actual compliance that is in effect (see Limits page 4-1)).
  • Page 225 Section 8: Theory of operation Model 2606B System SourceMeter® Instrument Reference Manual Figure 94: Normal current source operation Current source operation in voltage compliance The following figure shows what happens if the resistance of the load is increased to 200 Ω. The DUT load line for 200 Ω...
  • Page 226 Model 2606B System SourceMeter® Instrument Reference Manual Section 8: Theory of operation Current source operation in power compliance The following figure shows the results when a power limit of 600 mW is applied. As the instrument attempts to output the programmed source value of 100 mA, the power limited voltage compliance limit line is reached, placing the instrument in power compliance.
  • Page 227 Section 8: Theory of operation Model 2606B System SourceMeter® Instrument Reference Manual Figure 97: Current source sweep operation in voltage and power compliance Guard GUARD is at the same potential as output HI. If hazardous voltages are present at output HI, they are also present at the GUARD terminal.
  • Page 228 Model 2606B System SourceMeter® Instrument Reference Manual Section 8: Theory of operation Guard connections Guard is typically used to drive the guard shields of cables and test fixtures. Guard is extended to a test fixture from the cable guard shield. Inside the test fixture, the guard can be connected to a guard plate or shield that surrounds the device-under-test (DUT).
  • Page 229 Section 8: Theory of operation Model 2606B System SourceMeter® Instrument Reference Manual Figure 98: Unguarded measurements Figure 99: Guarded measurements Analog-to-digital converter The 2606B SMUs have integrating analog-to-digital converter (ADCs). The integrating ADCs use a ratiometric analog-to-digital conversion technique. Depending on the configuration of the integrating ADCs, periodic fresh reference measurements are required to minimize drift.
  • Page 230 Model 2606B System SourceMeter® Instrument Reference Manual Section 8: Theory of operation Measurement settling time considerations Several outside factors can influence measurement settling times. Effects such as dielectric absorption, cable leakages, and noise can all extend the times required to make stable measurements.
  • Page 231 Section 8: Theory of operation Model 2606B System SourceMeter® Instrument Reference Manual The delay factor is used to multiply the default delays. Setting this value above 1.0 increases the delays; a value below 1.0 decreases the delay. Setting this value to 0.0 essentially turns off measurement delays.
  • Page 232 Model 2606B System SourceMeter® Instrument Reference Manual Section 8: Theory of operation Creating pulses with the 2606B SMU Although the 2606B is not a pulse generator, you can create pulses by programming the SMU to output a dc value and then return to an idle level. For information on how to create pulses, refer to Sweep operation (on page 5-34) and Using the remote trigger model...
  • Page 233 Section 8: Theory of operation Model 2606B System SourceMeter® Instrument Reference Manual Range and pulse settling Each SMU range has different specifications for source settling times. This causes different rise and fall time characteristics depending on the set range. In addition, pulse performance is dependent on the pulse setting as a percent of full scale. For example, a 100 mA pulse on the 1 A range (which is 10% of full scale) performs differently than a 1 A pulse on the 1 A range (which is full scale).
  • Page 234 Section 9 LAN concepts and settings In this section: Overview .................. 9-1 Install the crossover cable ............9-1 Connecting to the LAN ............. 9-2 Establishing a point-to-point connection ........9-5 LAN speeds................9-7 Duplex mode ................9-7 Viewing LAN status messages ..........9-8 Viewing the network settings ............
  • Page 235: Connecting To The Lan

    Section 9: LAN concepts and settings Model 2606B System SourceMeter® Instrument Reference Manual Figure 101: LAN connection Connect the crossover cable into the same computer LAN port used during instrument configuration to ensure that the system is using the correct network card. Connecting to the LAN Each device on the LAN (corporate or private) requires a unique IP address.
  • Page 236 Model 2606B System SourceMeter® Instrument Reference Manual Section 9: LAN concepts and settings Set the IP address to be set automatically When the TCP/IP configuration mode is set to Automatic, a DHCP server automatically sets the IP address, subnet mask, and the default gateway. To use this option, a DHCP server must be available on the network.
  • Page 237 Section 9: LAN concepts and settings Model 2606B System SourceMeter® Instrument Reference Manual To use the LAN RESET switch to select manual mode using fixed settings: 1. If the instrument power is on, turn it off. You set the LAN RESET switch as the instrument powers 2.
  • Page 238: Establishing A Point-To-Point Connection

    Model 2606B System SourceMeter® Instrument Reference Manual Section 9: LAN concepts and settings To enable or disable DNS registration: 1. From the virtual front panel, press the MENU key and select LAN > CONFIG > DNS > DYNAMIC. 2. Turn the navigation wheel to select either ENABLE or DISABLE. DNS registration works with the DHCP to register the host name specified in the lan.config.dns.hostname attribute with the DNS server.
  • Page 239 Section 9: LAN concepts and settings Model 2606B System SourceMeter® Instrument Reference Manual Record all network configurations before modifying any existing network configuration information on the network interface card. Once the network configuration settings are updated, the previous information is lost. This may cause a problem reconnecting the host computer to a corporate network, particularly if DHCP Enabled = NO (disabled).
  • Page 240: Lan Speeds

    Model 2606B System SourceMeter® Instrument Reference Manual Section 9: LAN concepts and settings 6. Change the subnet mask from the LAN CONFIG menu: Select CONFIG > SUBNETMASK, and then press the ENTER key. The SUBNETMASK menu item is to the right of GATEWAY. Use the navigation wheel to scroll through the options. Modify the SUBNETMASK value to match the computer settings recorded earlier (or 255.255.255.000 if DHCP Enabled = YES).
  • Page 241: Viewing Lan Status Messages

    Section 9: LAN concepts and settings Model 2606B System SourceMeter® Instrument Reference Manual Viewing LAN status messages To view the LAN status messages: 1. From the virtual front panel, press the MENU key and select LAN > STATUS > CONFIG/FAULT. 2.
  • Page 242: Viewing The Network Settings

    Model 2606B System SourceMeter® Instrument Reference Manual Section 9: LAN concepts and settings Viewing the network settings To view the active network settings: 1. From the virtual front panel, press the MENU key, and then select LAN > STATUS. 2. Use the navigation wheel to select one of the following network settings: ▪...
  • Page 243: Selecting A Lan Interface Protocol

    Section 9: LAN concepts and settings Model 2606B System SourceMeter® Instrument Reference Manual Confirming port numbers To view the port number assigned to each remote interface protocol: 1. From the virtual front panel, press the MENU key, and then select LAN > STATUS > PORT. 2.
  • Page 244 Model 2606B System SourceMeter® Instrument Reference Manual Section 9: LAN concepts and settings Raw socket connection All Keithley instruments that have LAN connections support raw socket communication. This means that you can connect to the TCP/IP port on the instrument and send and receive commands. A programmer can easily communicate with the instrument using the Winsock API on computers with ®...
  • Page 245: Logging Lan Trigger Events In The Event Log

    Section 9: LAN concepts and settings Model 2606B System SourceMeter® Instrument Reference Manual Logging LAN trigger events in the event log You can use the event log to record all LXI triggers generated and received by the 2606B. You can view the event log using any command interface or the embedded web interface.
  • Page 246 Model 2606B System SourceMeter® Instrument Reference Manual Section 9: LAN concepts and settings The timestamp, event identifier, IP address, and the domain name identify the incoming and outgoing LXI trigger packets. The following table provides detailed descriptions for the columns in the event log.
  • Page 247 Section 9: LAN concepts and settings Model 2606B System SourceMeter® Instrument Reference Manual Accessing the event log from the command interface You can access the event log from any remote command interface. The event log must be enabled before LXI trigger events can be viewed. To enable the event log, send: eventlog.enable = 1 To view the event log from a remote interface, send: print(eventlog.all())
  • Page 248 Section 10 Status model In this section: Overview ................10-1 Clearing registers ..............10-13 Programming enable and transition registers ....... 10-13 Reading registers ..............10-14 Status byte and service request (SRQ) ........ 10-14 Status register sets .............. 10-18 TSP-Link system status ............10-24 Overview Each Keithley Instruments 2606B provides status registers and queues that are collectively referred to as the status model.
  • Page 249 Section 10: Status model Model 2606B System SourceMeter® Instrument Reference Manual An event is represented by a condition register bit changing from a 1 to 0 or 0 to 1. When an event occurs and the appropriate NTR or PTR bit is set, the corresponding event register bit is set to 1. The event bit remains latched to 1 until the event register is read or the status model is reset.
  • Page 250 Model 2606B System SourceMeter® Instrument Reference Manual Section 10: Status model Error queue The error queue holds error and status messages. As programming errors and status messages occur, a message that defines the error or status is placed in the error queue. An error or status message is cleared from the error queue when it is read.
  • Page 251 Section 10: Status model Model 2606B System SourceMeter® Instrument Reference Manual Status function summary Type Function or attribute status.operation.* Operation status status.operation.calibrating.* status.operation.instrument.* status.operation.instrument.digio.* status.operation.instrument.digio.trigger_overrun.* status.operation.instrument.lan.* status.operation.instrument.lan.trigger_overrun.* status.operation.instrument.smua.* status.operation.instrument.smub.* status.operation.instrument.smua.trigger_overrun.* status.operation.instrument.smub.trigger_overrun.* status.operation.instrument.trigger_blender.* status.operation.instrument.trigger_blender.trigger_overrun.* status.operation.instrument.trigger_timer.* status.operation.instrument.trigger_timer.trigger_overrun.* status.operation.instrument.tsplink.* status.operation.instrument.tsplink.trigger_overrun.* status.operation.measuring.* status.operation.remote.* status.operation.sweeping.* status.operation.trigger_overrun.* status.operation.user.* status.questionable.*...
  • Page 252 Model 2606B System SourceMeter® Instrument Reference Manual Section 10: Status model Figure 104: Status byte and service request enable register 2606B-901-01 Rev. C November 2021 10-5...
  • Page 253 Section 10: Status model Model 2606B System SourceMeter® Instrument Reference Manual Figure 105: System summary and standard event registers 10-6 2606B-901-01 Rev. C November 2021...
  • Page 254 Model 2606B System SourceMeter® Instrument Reference Manual Section 10: Status model Measurement event registers Figure 106: Measurement event registers 2606B-901-01 Rev. C November 2021 10-7...
  • Page 255 Section 10: Status model Model 2606B System SourceMeter® Instrument Reference Manual Figure 107: Operation status registers 10-8 2606B-901-01 Rev. C November 2021...
  • Page 256 Model 2606B System SourceMeter® Instrument Reference Manual Section 10: Status model Figure 108: Operation status trigger overrun registers 2606B-901-01 Rev. C November 2021 10-9...
  • Page 257 Section 10: Status model Model 2606B System SourceMeter® Instrument Reference Manual Figure 109: Operation status trigger timer, trigger blender, and remote registers 10-10 2606B-901-01 Rev. C November 2021...
  • Page 258 Model 2606B System SourceMeter® Instrument Reference Manual Section 10: Status model Figure 110: Operation status digital I/O and TSP-Link registers 2606B-901-01 Rev. C November 2021 10-11...
  • Page 259 Section 10: Status model Model 2606B System SourceMeter® Instrument Reference Manual Figure 111: Questionable status registers 10-12 2606B-901-01 Rev. C November 2021...
  • Page 260: Clearing Registers

    Model 2606B System SourceMeter® Instrument Reference Manual Section 10: Status model Clearing registers You can use commands to reset the status registers. *CLS resets the bits of the event and NTR registers to 0 and sets all PTR register bits on. This command also clears the output queue.
  • Page 261: Reading Registers

    Section 10: Status model Model 2606B System SourceMeter® Instrument Reference Manual Reading registers Any register in the status structure can be read either by sending the common command query (where applicable), or by including the script command for that register in either the print() or print(tostring()) command.
  • Page 262 Model 2606B System SourceMeter® Instrument Reference Manual Section 10: Status model Figure 113: Status byte and service request (SRQ) The bits of the Status Byte Register are: • Bit B0, Measurement Summary Bit (MSB): When set, indicates that an enabled measurement event has occurred.
  • Page 263 Section 10: Status model Model 2606B System SourceMeter® Instrument Reference Manual • Bit B5, Event Summary Bit (ESB): When set, indicates that an enabled standard event has occurred. • Bit B6, Request Service (RQS)/Master Summary Status (MSS): When set, indicates that an enabled summary bit of the Status Byte Register is set.
  • Page 264 Model 2606B System SourceMeter® Instrument Reference Manual Section 10: Status model SRQs can be managed by the serial poll sequence of the instrument. If an SRQ does not occur, bit B6 (RQS) of the Status Byte Register remains cleared, and the program proceeds normally after the serial poll is performed.
  • Page 265: Status Register Sets

    Section 10: Status model Model 2606B System SourceMeter® Instrument Reference Manual Enable and transition registers In general, there are three types of user-writable registers that are used to configure which bits feed the register summary bit and when it occurs. The registers are identified in each applicable command (as listed in TSP commands (on page 15-7)) as follows:...
  • Page 266 Model 2606B System SourceMeter® Instrument Reference Manual Section 10: Status model In a TSP-Link system, you can configure the status model so that a status event in any node in the system can set the RQS (request for service) bit of the Master Node Status Byte. See TSP-Link system status (on page 10-24) for details on using the status model in a TSP-Link system.
  • Page 267 Section 10: Status model Model 2606B System SourceMeter® Instrument Reference Manual • Bit B5, Command Error (CME): Set bit indicates that a command error has occurred. Command errors include: ▪ IEEE Std 488.2 syntax error: The 2606B instrument received a message that does not follow the defined syntax of IEEE Std 488.2.
  • Page 268 Model 2606B System SourceMeter® Instrument Reference Manual Section 10: Status model Operation Status Registers As shown in the Operation status registers (on page 10-7) diagram of the status model, there are 22 register sets associated with operation status. Commands are summarized in Status register set contents (on page 10-1).
  • Page 269 Section 10: Status model Model 2606B System SourceMeter® Instrument Reference Manual Questionable Status Registers This register set feeds to bit B3 (QSB) of the Status Byte. The bits used in the Questionable Status Register set are described as follows: • Bit B8, Calibration (CAL): Set bit indicates that calibration is questionable.
  • Page 270 Model 2606B System SourceMeter® Instrument Reference Manual Section 10: Status model When reading a register, a numeric value is returned. The binary equivalent of this value indicates which bits in the register are set. For details, see Reading registers (on page 10-14). For example, the following command reads the Measurement Event Enable Register: print(status.measurement.enable) This register set feeds to bit B0 (MSB) of the Status Byte.
  • Page 271: Tsp-Link System Status

    Section 10: Status model Model 2606B System SourceMeter® Instrument Reference Manual TSP-Link system status ® The TSP-Link expansion interface allows instruments to communicate with each other. The test system can be expanded to include up to 32 TSP-enabled instruments. In a TSP-Link system, one node (instrument) is the master and the other nodes are the subordinates.
  • Page 272 Model 2606B System SourceMeter® Instrument Reference Manual Section 10: Status model Status configuration (enable) commands For the following registers, the commands listed, which are sent from the master node, enable the appropriate register bits for the status model configuration example. Node 15 status registers: The following commands enable the current limit events for SMU A and B of node 15: node[15].status.measurement.current_limit.enable = 6...
  • Page 273 Section 10: Status model Model 2606B System SourceMeter® Instrument Reference Manual Figure 115: TSP-Link status model configuration example 10-26 2606B-901-01 Rev. C November 2021...
  • Page 274 Section 11 Maintenance In this section: Introduction ................11-1 Line fuse replacement ............11-1 Upgrading the firmware ............11-2 Introduction This section describes routine maintenance of the instrument that an operator can perform. Line fuse replacement Fuses on the 2606B rear panel protect the power line input of the instrument. Disconnect the line cord at the rear panel and remove all test leads connected to the instrument before replacing a line fuse.
  • Page 275 Section 11: Maintenance Model 2606B System SourceMeter® Instrument Reference Manual To replace a line fuse: 1. Power off the instrument and remove the line cord. 2. There is a small tab at the bottom of the fuse drawer. Using a small screwdriver, pry this tab from the ac receptacle.
  • Page 276 Model 2606B System SourceMeter® Instrument Reference Manual Section 11: Maintenance To upgrade or downgrade the firmware from the web interface: 1. Turn the instrument power off. Wait a few seconds. 2. Turn the instrument power on. 3. Open a web browser on the host computer. 4.
  • Page 277 Section 11: Maintenance Model 2606B System SourceMeter® Instrument Reference Manual 5. For Select or enter a firmware image file, use the browser to select the new firmware. 6. For Select a replacement mode, select Upgrade to install a newer version of firmware or Downgrade to install an older of firmware.
  • Page 278 Section 12 Troubleshooting guide In this section: Introduction ................12-1 Error levels ................12-1 Effects of errors on scripts............12-1 Retrieving errors ..............12-2 Error summary list ..............12-2 LAN troubleshooting suggestions ........... 12-6 Introduction Troubleshooting information includes information on the Keithley Instruments 2606B errors (including a complete list of error messages) and LAN troubleshooting suggestions.
  • Page 279 Section 12: Troubleshooting guide Model 2606B System SourceMeter® Instrument Reference Manual Retrieving errors When errors occur, the error messages are placed in the error queue. Use errorqueue commands to request error message information. For example, the following commands request the complete set of information about the next message in the error queue.
  • Page 280 Model 2606B System SourceMeter® Instrument Reference Manual Section 12: Troubleshooting guide Error summary Error number Error level Error message -108 RECOVERABLE Parameter not allowed -105 RECOVERABLE Trigger not allowed -104 RECOVERABLE Data type error NO_SEVERITY Queue Is Empty RECOVERABLE Calibration overflow RECOVERABLE Reading buffer data lost RECOVERABLE...
  • Page 281 Section 12: Troubleshooting guide Model 2606B System SourceMeter® Instrument Reference Manual Error summary Error number Error level Error message 1501 RECOVERABLE Invalid parity setting 1502 RECOVERABLE Invalid terminator setting 1503 RECOVERABLE Invalid bits setting 1504 RECOVERABLE Invalid flow control setting 1700 RECOVERABLE Display area boundary exceeded...
  • Page 282 Model 2606B System SourceMeter® Instrument Reference Manual Section 12: Troubleshooting guide Error summary Error number Error level Error message 2411 RECOVERABLE TSPnet connection failed 2412 RECOVERABLE TSPnet invalid termination 2413 RECOVERABLE TSPnet invalid reading buffer table 2414 RECOVERABLE TSPnet invalid reading buffer index range 2415 RECOVERABLE TSPnet feature only supported on TSP connections...
  • Page 283 Section 12: Troubleshooting guide Model 2606B System SourceMeter® Instrument Reference Manual Error summary Error number Error level Error message 5044 RECOVERABLE Cannot perform requested operation while current measure autorange is enabled 5045 RECOVERABLE Cannot perform requested operation while filter is enabled 5046 SERIOUS SMU too hot...
  • Page 284 Section 13 Introduction to TSP operation In this section: Introduction to TSP operation..........13-1 About TSP commands ............13-3 Factory scripts ..............13-19 Introduction to TSP operation ® Instruments that are enabled for Test Script Processor (TSP ) operate like conventional instruments by responding to a sequence of commands sent by the controller.
  • Page 285 Section 13: Introduction to TSP operation Model 2606B System SourceMeter® Instrument Reference Manual Functions Function-based commands control actions or activities. A function-based command performs an immediate action on the instrument. Each function consists of a function name followed by a set of parentheses ( ). Only include information in the parentheses if the function takes a parameter.
  • Page 286 Model 2606B System SourceMeter® Instrument Reference Manual Section 13: Introduction to TSP operation Example 3: Read an attribute using a function print(format.data) Reads the data format by passing the attribute to the print function. If the data format is set to 3, the output is: 3.00000e+00 This shows that the data format is set to double precision floating point.
  • Page 287 Section 13: Introduction to TSP operation Model 2606B System SourceMeter® Instrument Reference Manual Bit manipulation and logic operations The bit functions perform bitwise logic operations on two given numbers, and bit operations on one given number. Logic and bit operations truncate the fractional part of given numbers to make them integers.
  • Page 288 Model 2606B System SourceMeter® Instrument Reference Manual Section 13: Introduction to TSP operation Data queue Use the data queue commands to: • Share data between test scripts running in parallel • ® Access data from a remote group or a local node on a TSP-Link network at any time The data queue in the Test Script Processor (TSP ®...
  • Page 289 Section 13: Introduction to TSP operation Model 2606B System SourceMeter® Instrument Reference Manual Display display.clear() (on page 15-65) display.getannunciators() (on page 15-65) display.getcursor() (on page 15-67) display.getlastkey() (on page 15-68) display.gettext() (on page 15-69) display.inputvalue() (on page 15-70) display.loadmenu.add() (on page 15-72) display.loadmenu.catalog() (on page 15-73) display.loadmenu.delete()
  • Page 290 Model 2606B System SourceMeter® Instrument Reference Manual Section 13: Introduction to TSP operation File I/O You can use the file I/O commands to open and close directories and files, write data, or to read a file on an installed USB flash drive. File I/O commands are organized into two groups: •...
  • Page 291 Section 13: Introduction to TSP operation Model 2606B System SourceMeter® Instrument Reference Manual io.input() (on page 15-118) io.open() (on page 15-119) io.output() (on page 15-119) io.read() (on page 15-121) io.type() (on page 15-122) io.write() (on page 15-123) os.remove() (on page 15-167) os.rename() (on page 15-167) The following standard I/O commands are not supported:...
  • Page 292 Model 2606B System SourceMeter® Instrument Reference Manual Section 13: Introduction to TSP operation lan.config.method (on page 15-131) lan.config.speed (on page 15-132) lan.config.subnetmask (on page 15-133) lan.linktimeout (on page 15-133) lan.lxidomain (on page 15-134) lan.nagle (on page 15-135) lan.reset() (on page 15-135) lan.restoredefaults() (on page 15-136) lan.status.dns.address[N]...
  • Page 293 Section 13: Introduction to TSP operation Model 2606B System SourceMeter® Instrument Reference Manual Parallel script execution dataqueue.add() (on page 15-49) dataqueue.CAPACITY (on page 15-50) dataqueue.clear() (on page 15-50) dataqueue.count (on page 15-51) dataqueue.next() (on page 15-52) node[N].execute() (on page 15-164) node[N].getglobal() (on page 15-165) node[N].setglobal()
  • Page 294 Model 2606B System SourceMeter® Instrument Reference Manual Section 13: Introduction to TSP operation bufferVar.measurefunctions (on page 15-25) bufferVar.measureranges (on page 15-26) bufferVar.n (on page 15-28) bufferVar.readings (on page 15-29) bufferVar.sourcefunctions (on page 15-30) bufferVar.sourceoutputstates (on page 15-31) bufferVar.sourceranges (on page 15-31) bufferVar.sourcevalues (on page 15-32) bufferVar.statuses...
  • Page 295 Section 13: Introduction to TSP operation Model 2606B System SourceMeter® Instrument Reference Manual Scripting Scripting helps you combine commands into a block of code that the instrument can run. Scripts help you communicate with the instrument efficiently. These commands describe how to create, load, modify, run, and exit scripts.
  • Page 296 Model 2606B System SourceMeter® Instrument Reference Manual Section 13: Introduction to TSP operation smuX.measure.overlappedY() (on page 15-223) smuX.measure.rangeY (on page 15-224) smuX.measure.rel.enableY (on page 15-226) smuX.measure.rel.levelY (on page 15-227) smuX.measure.Y() (on page 15-228) smuX.measureYandstep() (on page 15-229) smuX.nvbufferY (on page 15-230) smuX.reset() (on page 15-231) smuX.savebuffer()
  • Page 297 Section 13: Introduction to TSP operation Model 2606B System SourceMeter® Instrument Reference Manual smuX.trigger.SOURCE_COMPLETE_EVENT_ID (on page 15-270) smuX.trigger.SWEEP_COMPLETE_EVENT_ID (on page 15-271) smuX.trigger.SWEEPING_EVENT_ID (on page 15-271) SMU calibration smuX.cal.adjustdate (on page 15-196) smuX.cal.date (on page 15-197) smuX.cal.due (on page 15-198) smuX.cal.lock() (on page 15-199) smuX.cal.password (on page 15-199)
  • Page 298 Model 2606B System SourceMeter® Instrument Reference Manual Section 13: Introduction to TSP operation status.operation.instrument.tsplink.* (on page 15-315) status.operation.instrument.tsplink.trigger_overrun.* (on page 15-316) status.operation.measuring.* (on page 15-318) status.operation.remote.* (on page 15-319) status.operation.sweeping.* (on page 15-320) status.operation.trigger_overrun.* (on page 15-322) status.operation.user.* (on page 15-324) status.questionable.* (on page 15-326) status.questionable.calibration.*...
  • Page 299 Section 13: Introduction to TSP operation Model 2606B System SourceMeter® Instrument Reference Manual digio.trigger[N].reset() (on page 15-60) digio.trigger[N].stimulus (on page 15-61) digio.trigger[N].wait() (on page 15-62) display.trigger.clear() (on page 15-84) display.trigger.EVENT_ID (on page 15-84) display.trigger.overrun (on page 15-84) display.trigger.wait() (on page 15-85) lan.trigger[N].assert() (on page 15-144) lan.trigger[N].clear()
  • Page 300 Model 2606B System SourceMeter® Instrument Reference Manual Section 13: Introduction to TSP operation trigger.blender[N].EVENT_ID (on page 15-362) trigger.blender[N].orenable (on page 15-363) trigger.blender[N].overrun (on page 15-363) trigger.blender[N].reset() (on page 15-364) trigger.blender[N].stimulus[M] (on page 15-365) trigger.blender[N].wait() (on page 15-366) trigger.clear() (on page 15-367) trigger.EVENT_ID (on page 15-367) trigger.generator[N].assert()
  • Page 301 Section 13: Introduction to TSP operation Model 2606B System SourceMeter® Instrument Reference Manual tsplink.trigger[N].pulsewidth (on page 15-386) tsplink.trigger[N].release() (on page 15-386) tsplink.trigger[N].reset() (on page 15-387) tsplink.trigger[N].stimulus (on page 15-388) tsplink.trigger[N].wait() (on page 15-389) tsplink.writebit() (on page 15-390) tsplink.writeport() (on page 15-390) tsplink.writeprotect (on page 15-391) TSP-Net...
  • Page 302 Model 2606B System SourceMeter® Instrument Reference Manual Section 13: Introduction to TSP operation Factory scripts The 2606B is shipped with one or more factory scripts saved in its flash firmware memory. A factory script is made up of a number of functions. Some of them can be called from the virtual front-panel LOAD TEST menu.
  • Page 303 Section 13: Introduction to TSP operation Model 2606B System SourceMeter® Instrument Reference Manual Retrieving and modifying a factory script listing The script listing for a factory script can be retrieved and modified. However, it cannot be saved as a factory script. The modified script can be saved as a user script using the same name or a new name. An imported factory script can only be reloaded into the 2606B as a user script.
  • Page 304 Model 2606B System SourceMeter® Instrument Reference Manual Section 13: Introduction to TSP operation Use the configuration KIPulse tag parameter pulse functions (on page 13-21) to configure a pulse train and assign the configuration to the tag parameter (use QueryPulseConfig() to inspect configured pulse trains).
  • Page 305 Section 13: Introduction to TSP operation Model 2606B System SourceMeter® Instrument Reference Manual Advanced features for KIPulse tag parameter pulse functions Variable off time between pulses in a pulse train The KIPulse “Configure” functions accept the toff parameter as a table or as a number. The table allows you to define different off times to be used after each pulse.
  • Page 306 Section 14 Instrument programming In this section: Fundamentals of scripting for TSP ......... 14-1 Fundamentals of programming for TSP ....... 14-14 Test Script Builder ..............14-32 Password management ............14-36 Working with TSB Embedded ..........14-38 Advanced scripting for TSP ..........14-42 TSP-Link system expansion interface ........
  • Page 307 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual What is a script? A script is a collection of instrument control commands and programming statements. Scripts that you create are referred to as user scripts. Your scripts can be interactive. Interactive scripts display messages on the virtual front panel of the instrument that prompt the operator to enter parameters.
  • Page 308 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming Commands that cannot be used in scripts Though the instrument accepts the following commands, you cannot use these commands in scripts. Commands that cannot be used in scripts General commands IEEE Std 488.2 common commands abort *CLS...
  • Page 309 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual Anonymous scripts If a script is created with the loadscript or loadandrunscript command with no name defined, it is called the anonymous script. There can only be one anonymous script in the runtime environment. If another anonymous script is loaded into the runtime environment, it replaces the existing anonymous script.
  • Page 310 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming Figure 119: Loadscript and endscript example To load a named script by sending commands: 1. Send the command loadscript scriptName, where scriptName is the name of the script. The name must be a legal Lua variable name. 2.
  • Page 311 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual Load a script from the instrument front panel You can also load scripts from a USB flash drive to the runtime environment of the instrument. Depending on the content of the TSP file on the drive, the script can be loaded either as an anonymous script without a designated name, or as a named script with a user-defined name.
  • Page 312 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming 8. If the script has the same name as a script that is already in memory, you are prompted to overwrite the script. ▪ Select Yes to continue. ▪ Select No to return to the list of files.
  • Page 313 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual Run the anonymous script The anonymous script can be run many times without reloading it. It remains in the runtime environment until a new anonymous script is created or until the instrument is turned off. To run the anonymous script, use any one of these commands: •...
  • Page 314 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming To run a script directly without adding it to the USER menu: 1. Select the LOAD key. 2. Select SCRIPTS and select the ENTER key. There may be a short pause before a menu is displayed that represents the scripts in the instrument.
  • Page 315 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual Autoexec script The autoexec script runs automatically when the instrument is turned on. It runs after all the scripts have loaded and any scripts defined as autorun have run. To create a script that executes automatically, create and load a new script and name it autoexec.
  • Page 316 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming Save a user script You can save scripts to nonvolatile memory using commands or TSB Embedded. Only named scripts can be saved to nonvolatile memory. The anonymous script must be named before it can be saved to nonvolatile memory.
  • Page 317 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual Save a script from the instrument front panel You can save scripts from the runtime environment to nonvolatile memory or the USB port on the instrument front panel. If you want to save the anonymous script to nonvolatile memory, you must name it first. See Save the anonymous script as a named script (on page 14-11).
  • Page 318 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming Programming example: Interactive script An interactive script prompts the operator to input values using virtual front panel controls. The following example script uses display messages to prompt the operator to: •...
  • Page 319: Fundamentals Of Programming For Tsp

    Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual Fundamentals of programming for TSP To conduct a test, a computer (controller) is programmed to send sequences of commands to an instrument. The controller orchestrates the actions of the instrumentation. The controller is typically programmed to request measurement results from the instrumentation and make test sequence decisions based on those measurements.
  • Page 320 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming Function and variable name restrictions You cannot use factory script names, functions created by factory scripts, Lua reserved words and top-level command names for function or variable names. For information on factory script names, see Factory scripts (on page 13-19).
  • Page 321 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual Variable types Variables can be one of the following types. Variable types and values Variable type returned Value Notes "nil" The type of the value nil, whose main property is not declared to be different from any other value;...
  • Page 322 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming Example: Function function add_two(first_value, function second_value) return first_value + second_value print(add_two(3, 4), type(add_two)) Example: Table atable = {1, 2, 3, 4} Defines a table with four numeric elements. print(atable, type(atable)) Note that the table value (shown here as a096cd30) print(atable[1]) varies.
  • Page 323 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual To execute a function, substitute appropriate values for parameterX and insert them into a message formatted as: myFunction(valueForParameterX, valueForParameterY) Where valueForParameterX and valueForParameterY represent the values to be passed to the function call for the given parameters.
  • Page 324 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming Create functions using scripts You can use scripts to define functions. Scripts that define a function are like any other script: They do not cause any action to be performed on the instrument until they are executed. The global variable of the function does not exist until the script that created the function is executed.
  • Page 325 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual When calling the function, you must specify a string for the name argument of the function. For example, to set the name to John, call the function as follows: myDisplay("John") Example: User script User script created in Test Script Builder or...
  • Page 326 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming The example output you get may vary depending on the data format settings of the instrument. Example print(10 or errorqueue.next()) 1.00000e+01 print(nil or "a") print(nil and 10) print(false and errorqueue.next()) false print(false and nil) false...
  • Page 327 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual You can use parentheses to change the precedences in an expression. The concatenation ("..") and exponentiation ("^") operators are right associative. All other binary operators are left associative. The examples below show equivalent expressions.
  • Page 328 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming Example: If and else x = 2 Output: if not x then This is from the else block print("This is from the if block") else print("This is from the else block") Example: Else and elseif x = 1 y = 2...
  • Page 329 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual 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 14-22) statements. while expression do block Where:...
  • Page 330 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming Example: Repeat until list = {"One", "Two", "Three", "Four", "Five", "Six"} print("Count elements in list using repeat:") element = 1 repeat print(element, list[element]) element = element + 1 until not list[element] Output: Count elements in list using repeat:...
  • Page 331 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual Example: Generic for days = {"Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"} for i, v in ipairs(days) do print(days[i], i, v) The generic for statement works by using functions called iterators. On each iteration, the iterator function is called to produce a new value, stopping when this new value is nil.
  • Page 332 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming Example: Break with while statement enclosed by comment delimiters local numTable = {5, 4, 3, 2, 1} This example defines a break value local k = table.getn(numTable) (breakValue), but the break value line is -- local breakValue = 3 preceded by comment delimiters so that the while k >...
  • Page 333 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual The output you get from this example may vary depending on the data format settings of the instrument. Example: Loop array atable = {1, 2, 3, 4} Defines a table with four numeric elements. i = 1 Loops through the array and prints each element.
  • Page 334 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming Base library functions Base library functions Function Description collectgarbage() Sets the garbage-collection threshold to the given limit (in kilobytes) and collectgarbage(limit) checks it against the byte counter. If the new threshold is smaller than the byte counter, Lua immediately runs the garbage collector.
  • Page 335 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual String library functions This library provides generic functions for string manipulation, such as finding and extracting substrings. When indexing a string in Lua, the first character is at position 1 (not 0, as in ANSI C). Indices may be negative and are interpreted as indexing backward from the end of the string.
  • Page 336 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming Math library functions This library is an interface to most of the functions of the ANSI C math library. All trigonometric functions work in radians. The functions math.deg() and math.rad() convert between radians and degrees.
  • Page 337: Test Script Builder

    Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual Programming example: User script The following script puts a message on the virtual front panel display slowly, one character at a time. The intent of this example is to demonstrate: •...
  • Page 338 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming Using Test Script Builder (TSB) Keithley Instruments Test Script Builder (TSB) is a software tool that simplifies building test scripts. You can use TSB to perform the following operations: •...
  • Page 339 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual Figure 120: Example of the Test Script Builder workspace Item Description Project navigator Script editor; right-click to run the script that is displayed Outline view Programming interaction Help; includes detailed information on using Test Script Builder Project navigator The project navigator consists of project folders and the script files (.tsp) created for each project.
  • Page 340 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming Script editor The script editor is where you write, modify, and debug scripts. To open and display a script file, double-click the file name in the project navigator. You can have multiple script files open in the script editor at the same time.
  • Page 341: Password Management

    Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual Programming interaction This part of the workspace is where you interact with the scripts that you are building in Test Script Builder (TSB). The actual contents of the programming interaction area of the workspace can vary. You can send commands from the Instrument Console command line, retrieve data, view variables and errors, and view and set breakpoints when using the debug feature.
  • Page 342 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming To set the password using the web interface: 1. From the web interface, select Set Password. The LXI - Keithley Instruments - 2606B - Administration page is displayed. 2. In Current Password, type the existing password. The default is admin. 3.
  • Page 343: Working With Tsb Embedded

    Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual Working with TSB Embedded TSB Embedded is a script management tool that is available through the web interface of the instrument. You can use TSB Embedded to create, modify, and save test scripts, and to send individual commands.
  • Page 344 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming Create a script using TSB Embedded If you are using TSB Embedded to create scripts, you do not need to use the commands loadscript or loadandrunscript and endscript. You can create a script from the instrument web interface with TSB Embedded. When you save the script, it is loaded into the runtime environment and saved in the nonvolatile memory of the instrument.
  • Page 345 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual Delete a script You cannot retrieve a deleted script. Be sure to back up your script to your computer before deleting. To delete a script from TSB Embedded: 1. Select the script from the User Scripts list. 2.
  • Page 346 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming Export a script to a computer You can download a script from TSB Embedded to the host computer. TSP scripts have the extension .tsp. To export a script to a computer: 1.
  • Page 347: Advanced Scripting For Tsp

    Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual To copy information from the Output box: 1. Right-click in the Output box. 2. Select Copy. The information is copied to the clipboard. Advanced scripting for TSP The following topics describe advanced information that can help you understand how the Test Script ®...
  • Page 348 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming Figure 122: Global variables and scripts in the runtime environment Create a script using the script.new() command Use the script.new() function to copy an existing script from the local node to a remote node. This enables parallel script execution.
  • Page 349 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual For example, to set up a two-second beep, you can send the command: beepTwoSec = script.new("beeper.enable = 1 beeper.beep(2, 2400)", "beepTwoSec") To run the new script, send the command: beepTwoSec() When you add beepTwoSec, the global variable and script.user.scripts table entries are made to the runtime environment, as shown in the following figure.
  • Page 350 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming Figure 124: Create an unnamed script A script becomes unnamed if you create a new script with the same name. In this circumstance, the name of the script in the script.user.scripts table is set to an empty string before it is replaced by the new script.
  • Page 351 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual Figure 125: Create a new script with the name of an existing script Rename a script You can rename a script. You might want to rename a script if you need to name another script the same name as the existing script.
  • Page 352 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming If the new name is the same as a name that is already used for a script, the name of the existing script is removed and that script becomes unnamed. This removes the existing script if there are no other variables that reference the previous script.
  • Page 353 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual Retrieve a user script There are several ways to retrieve the source code of a user script: • One line at a time: Use scriptVar.list() to retrieve the source code one line at a time •...
  • Page 354 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming Retrieve a script as a single string To retrieve the entire user script source code as a single string, use the scriptVar.source attribute. The loadscript or loadandrunscript and endscript keywords are not included. To retrieve the source code as a single string, send the command: print(scriptVar.source) Where scriptVar is the name of the script.
  • Page 355 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual 3. Remove the script from nonvolatile memory. To delete the script from nonvolatile memory, send the command: script.delete("name") Where name is the name that the script was saved as. For example, to delete "beepTwoSec", send: script.delete("beepTwoSec") Restore a script to the runtime environment...
  • Page 356 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming The amount of memory used by a sweep configuration is based on the number of source points. The actual memory consumption can vary greatly depending on the source-measure unit (SMU) settings, but as a general rule, each source point can be expected to consume at least 24 bytes.
  • Page 357: Tsp-Link System Expansion Interface

    Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual TSP-Link system expansion interface ® The TSP-Link expansion interface allows the 2606B instrument to communicate with other Test ® Script Processor (TSP ) enabled instruments. The test system can be expanded to include up to 32 TSP-Link enabled instruments.
  • Page 358 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming TSP-Link nodes ® Each instrument (node) attached to the TSP-Link network must be identified by assigning it a unique TSP-Link node number. Commands for remote nodes are stored in the node table. An individual node is accessed as node[N], where N is the node number assigned to the node.
  • Page 359 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual Figure 127: 2606B TSP-Link connections Initialization ® Before you can use a TSP-Link system, it must be initialized. For initialization to succeed, each instrument in a TSP-Link system must be assigned a different node number. Assigning node numbers At the factory, each module of the 2606B instrument is assigned as node 1.
  • Page 360 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming To determine the node number of an instrument, you can read the tsplink.node attribute by sending the following command: print(tsplink.node) The above print command outputs the node number. For example, if the node number is 1, a 1 is displayed.
  • Page 361 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual The programming example below illustrates a TSP-Link reset operation and displays its state: tsplink.reset() print(tsplink.state) If the reset operation is successful, online is output to indicate that communications with all nodes have been established.
  • Page 362 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming Using the reset() command in a TSP-Link network differs from using the tsplink.reset() command. The tsplink.reset() command reinitializes the TSP-Link network and turns off the output of any TSP-linked instrument; it may change the state of individual nodes in the system. Use node[N].reset() or localnode.reset() to reset only one of the nodes.
  • Page 363 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual There are two methods you can use to run test scripts simultaneously: • Create multiple TSP-Link networks • Use a single TSP-Link network with groups The following figure displays the first method, which consists of multiple TSP-Link networks. Each TSP-Link network has a master node and a remote connection to the computer.
  • Page 364 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming Another method you can use to run simultaneous test scripts is to use groups with a single TSP-Link network. Each group on the TSP-Link network can run a test while other groups are running different tests.
  • Page 365 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual The following table shows an example of the functions of a single TSP-Link network. Each group in this example runs a different test script than the other groups, which allows the system to run multiple tests simultaneously.
  • Page 366 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming Group leader overview Each group has a dynamic group leader. The last node in a group that performs any operation initiated by the master node is the group leader. The group leader: •...
  • Page 367 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual To run a script defined on the remote node: node[N].execute("scriptVar()") It is recommended that you copy large scripts to a remote node to improve system performance. See Copying test scripts across the TSP-Link network (on page 14-63) for more information.
  • Page 368 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming Using the data queue for real-time communication Nodes that are running test scripts at the same time can store data in the data queue for real-time communication. Each instrument has an internal data queue that uses the first-in, first-out (FIFO) structure to store data.
  • Page 369: Tsp-Net

    Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual When you run Lua code remotely, it can cause reading buffer data that is held in the cache to become stale. If the values in the reading buffer change while the Lua code runs remotely, another node can hold stale values.
  • Page 370 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming Using TSP-Net commands with TSP-enabled instruments, a 2606B can download a script to another TSP-enabled instrument and have both instruments run scripts independently. The 2606B 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 371 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual To communicate to a remote ethernet device from the 2606B: 1. Connect to the remote device using one of the above procedures. If the 2606B cannot make a connection to the remote device, it generates a timeout event. Use tspnet.timeout to set the timeout value.
  • Page 372 Model 2606B System SourceMeter® Instrument Reference Manual Section 14: Instrument programming TSP-Net compared to TSP-Link to communicate with TSP-enabled devices ® The TSP-Link network interface is the preferred communication method for most applications where communication occurs between the 2606B and another TSP-enabled instrument. One of the advantages of using the TSP-Link network interface is that TSP-Link connections have three trigger lines that are available to each device on the TSP-Link network.
  • Page 373 Section 14: Instrument programming Model 2606B System SourceMeter® Instrument Reference Manual Example: Using tspnet commands function telnetConnect(ipAddress, userName, password) -- Connect through Telnet to a computer. id = tspnet.connect(ipAddress, 23, "") -- Read the title and login prompt from the computer. print(string.format("from computer-->...
  • Page 374 Section 15 TSP command reference In this section: TSP command programming notes ........15-1 Using the TSP command reference ........15-3 TSP commands ..............15-7 TSP command programming notes This section contains general information about using TSP commands. Placeholder text This manual uses italicized text to represent the parts of remote commands that must be replaced by user specified values.
  • Page 375 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Example 3: smuX.trigger.measure.Y(rbuffer) Where: X refers to the source-measure unit (SMU) channel (use a for SMU A). Y is the measurement type that you specify (v, i, r, or p). rbuffer is the reading buffer object where the readings are stored.
  • Page 376 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Using the TSP command reference ® The Test Script Processor (TSP ) command reference contains detailed descriptions of each of the TSP commands that you can use to control your instrument. Each command description is broken into subsections.
  • Page 377 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Figure 131: TSP command name and summary table 1. Instrument command name. Indicates the beginning of the command description. It is followed by a brief description of what the command does. 2.
  • Page 378 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Command usage The Usage section of the remote command listing shows how to properly structure the command. Each line in the Usage section is a separate variation of the command usage. All possible command usage options are shown.
  • Page 379 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Example section The Example section of the remote command description shows examples of how you can use the command. Figure 134: TSP example code Actual example code that you can copy from this table and paste into your own programming application.
  • Page 380 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference TSP commands The TSP commands available for the instrument are listed in alphabetical order. beeper.beep() This function generates an audible tone. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
  • Page 381 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual beeper.enable This command allows you to turn the beeper on or off. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Recall setup Saved setup 1 (beeper.ON) Instrument reset Usage state = beeper.enable...
  • Page 382 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Example testResult = bit.bitand(10, 9) print(testResult) Performs a logical AND operation on decimal 10 (binary 1010) with decimal 9 (binary 1001), which returns a value of decimal 8 (binary 1000). Output: 8.00000e+00 Also see...
  • Page 383 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual bit.bitxor() This function performs a bitwise logical XOR (exclusive OR) operation on two numbers. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.bitxor(value1, value2) result Result of the logical XOR operation value1...
  • Page 384 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details Any fractional part of value is truncated to make it an integer. The returned result is also an integer. The least significant bit of value is at index position 1; the most significant bit is at index position 32.
  • Page 385 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Also see Bit manipulation and logic operations (on page 13-4) bit.clear() (on page 15-10) bit.set() (on page 15-13) bit.test() (on page 15-15) bit.toggle() (on page 15-16) bit.getfield() This function returns a field of bits from the value starting at the specified index position. Type TSP-Link accessible Affected by...
  • Page 386 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference bit.set() This function sets a bit at the specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.set(value, index) result Result of the bit manipulation value Specified number index...
  • Page 387 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual bit.setfield() This function overwrites a bit field at a specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.setfield(value, index, width, fieldValue) result Result of the bit manipulation value...
  • Page 388 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference bit.test() This function returns the Boolean value (true or false) of a bit at the specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.test(value, index) result...
  • Page 389 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual bit.toggle() This function toggles the value of a bit at a specified index position. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = bit.toggle(value, index) result Result of the bit manipulation value...
  • Page 390 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference bufferVar.appendmode This attribute sets the state of the append mode of the reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable See Details 0 (disabled) Usage state = bufferVar.appendmode...
  • Page 391 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual bufferVar.basetimestamp This attribute contains the timestamp that indicates when the first reading was stored in the buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable See Details Usage...
  • Page 392 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference bufferVar.cachemode This attribute enables or disables the reading buffer cache (on or off). Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Not saved 1 (enabled) Usage cacheMode = bufferVar.cachemode...
  • Page 393 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual bufferVar.capacity This attribute sets the number of readings a buffer can store. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable See Details Not applicable Usage bufferCapacity = bufferVar.capacity bufferCapacity...
  • Page 394 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference bufferVar.clear() This function empties the buffer. Type TSP-Link accessible Affected by Where saved Default value Function Usage bufferVar.clear() bufferVar The reading buffer; can be a dynamically allocated user-defined buffer or a dedicated reading buffer Details This function clears all readings and related recall attributes from the buffer (for example,...
  • Page 395 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual To avoid this, you can include explicit calls to the bufferVar.clearcache() function to remove stale values from the reading buffer cache. Example smua.nvbuffer1.clearcache() Clears the reading buffer cache for dedicated reading buffer 1. Also see bufferVar.fillmode (on page 15-25)
  • Page 396 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Also see bufferVar.clear() (on page 15-21) Reading buffers (on page 6-1) smuX.measure.overlappedY() (on page 15-223) smuX.measure.Y() (on page 15-228) smuX.nvbufferY (on page 15-230) smuX.trigger.measure.action (on page 15-257) smuX.trigger.measure.Y() (on page 15-261) bufferVar.collecttimestamps This attribute sets whether or not timestamp values are stored with the readings in the buffer.
  • Page 397 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Also see bufferVar.clear() (on page 15-21) Reading buffers (on page 6-1) smuX.measure.overlappedY() (on page 15-223) smuX.measure.Y() (on page 15-228) smuX.nvbufferY (on page 15-230) smuX.trigger.measure.Y() (on page 15-261) bufferVar.fillcount This attribute sets the reading buffer fill count.
  • Page 398 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference bufferVar.fillmode This attribute sets the reading buffer fill mode. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable See Details 0 (smuX.FILL_ONCE) Usage fillMode = bufferVar.fillmode bufferVar.fillmode = fillMode fillMode The reading buffer fill mode;...
  • Page 399 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Usage measurefunction = bufferVar.measurefunctions[N] measurefunction The measurement function used (Current, Voltage, Ohms, or Watts) to acquire reading number N in the specified buffer bufferVar The reading buffer; can be a dynamically allocated buffer (user-defined), or a dedicated reading buffer (such as smua.nvbuffer1) The reading number (1 to bufferVar.n) Details...
  • Page 400 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Usage measurerange = bufferVar.measureranges[N] measurerange The measurement range used to acquire reading number N in the specified buffer bufferVar The reading buffer; can be a dynamically allocated buffer (user-defined), or a dedicated reading buffer (such as smua.nvbuffer1) The reading number (1 to bufferVar.n) Details...
  • Page 401 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual bufferVar.n This attribute contains the number of readings in the buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Clearing the buffer See Details Not applicable Usage numberOfReadings = bufferVar.n numberOfReadings...
  • Page 402 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference bufferVar.readings This attribute contains the readings stored in a specified reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Clearing the buffer See Details Not applicable Usage reading = bufferVar.readings[N]...
  • Page 403 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual bufferVar.sourcefunctions This attribute contains the source function that was being used when the readings were stored in a specified reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Clearing the buffer...
  • Page 404 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference bufferVar.sourceoutputstates This attribute indicates the state of the source output for readings that are stored in a specified buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Clearing the buffer See Details...
  • Page 405 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Usage sourcerange = bufferVar.sourceranges[N] sourcerange The source range used to acquire reading number N in the specified buffer bufferVar The reading buffer; can be a dynamically allocated buffer (user-defined), or a dedicated reading buffer (such as smua.nvbuffer1) The reading number (1 to bufferVar.n) Details...
  • Page 406 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Usage sourcevalue = bufferVar.sourcevalues[N] sourcevalue The output value of the source when reading N of the specified buffer was acquired bufferVar The reading buffer; can be a dynamically allocated buffer (user-defined) or a dedicated reading buffer (such as smua.nvbuffer1) The reading number (1 to bufferVar.n) Details...
  • Page 407 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual bufferVar.statuses This attribute contains the status values of readings in the reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Clearing the buffer See Details Not applicable Usage statusInformation = bufferVar.statuses[N]...
  • Page 408 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Example reset() Reset the instrument. smua.source.func = smua.OUTPUT_DCVOLTS Set the voltage source function to dc volts. smua.source.autorangev = smua.AUTORANGE_ON Set the range to auto. smua.source.levelv = 5 Set the voltage source to 5 V. smua.source.limiti = 10e-3 Set current measure limit to 10 mA.
  • Page 409 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual For dedicated reading buffers, all buffer attributes are saved to nonvolatile memory only when the reading buffer is saved to nonvolatile memory. Example smua.nvbuffer1.timestampresolution = 0.000008 Sets the timestamp resolution of dedicated reading buffer 1 to 8 μs.
  • Page 410 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Also see bufferVar.clear() (on page 15-21) bufferVar.collecttimestamps (on page 15-23) bufferVar.measurefunctions (on page 15-25) bufferVar.measureranges (on page 15-26) bufferVar.n (on page 15-28) bufferVar.readings (on page 15-29) bufferVar.sourcefunctions (on page 15-30) bufferVar.sourceoutputstates (on page 15-31) bufferVar.sourceranges...
  • Page 411 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual sync_in_timeout Specifies the length of time (in seconds) to wait for input trigger; default value is 10 s sync_in_abort Specifies whether or not to abort the pulse if an input trigger is not received; if pulse aborts because of a missed trigger, a timer timeout message is returned;...
  • Page 412 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference ConfigPulseIMeasureVSweepLin() This KIPulse factory script function configures a linear pulsed current sweep with a voltage measurement at each point. Type TSP-Link accessible Affected by Where saved Default value Function Usage f, msg = ConfigPulseIMeasureVSweepLin(smu, bias, start, stop, limit, ton, toff,...
  • Page 413 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual The magnitude of the first pulse is start amperes; the magnitude of the last pulse is stop amperes. The magnitude of each pulse in between is step amperes larger than the previous pulse, where: step = (stop - start) / (points - 1) This function does not cause the specified smu to output a pulse train.
  • Page 414 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference ConfigPulseIMeasureVSweepLog() This KIPulse factory script (on page 13-20) function configures a voltage pulse train with a current measurement at each point. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
  • Page 415 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Data for pulsed voltage measurements are stored in the reading buffer specified by the buffer input parameter. This function configures a logarithmic pulsed current sweep with a voltage measurement at each point.
  • Page 416 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference ConfigPulseVMeasureI() This KIPulse factory script function configures a voltage pulse train with a current measurement at each point. Type TSP-Link accessible Affected by Where saved Default value Function Usage f, msg = ConfigPulseVMeasureI(smu, bias, level, limit, ton, toff, points, buffer, tag, sync_in, sync_out, sync_in_timeout, sync_in_abort)
  • Page 417 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Figure 139: ConfigPulseVMeasureI() Example 1 ConfigPulseVMeasureI(smua, 0, 20, 1, 0.001, 0.080, 10, smua.nvbuffer1, 2) Set up a pulse train that uses channel A. The pulse amplitude is 20 V and returns to 0 V after 1 ms. The pulse remains at 0 V for 80 ms, and the current limit is 1 A during the pulse.
  • Page 418 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference ConfigPulseVMeasureISweepLin() This KIPulse factory script function configures a voltage pulse train with a current measurement at each point. Type TSP-Link accessible Affected by Where saved Default value Function Usage f, msg = ConfigPulseVMeasureISweepLin(smu, bias, start, stop, limit, ton, toff, points, buffer, tag, sync_in, sync_out, sync_in_timeout, sync_in_abort)
  • Page 419 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual The magnitude of the first pulse is start volts; the magnitude of the last pulse is stop volts. The magnitude of each pulse in between is step volts larger than the previous pulse, where: step = (stop - start) / (points - 1) This function does not cause the specified smu to output a pulse train.
  • Page 420 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference ConfigPulseVMeasureISweepLog() This KIPulse factory script function configures a voltage pulse train with a current measurement at each point. Type TSP-Link accessible Affected by Where saved Default value Function Usage f, msg = ConfigPulseVMeasureISweepLog(smu, bias, start, stop, limit, ton, toff, points, buffer, tag, sync_in, sync_out, sync_in_timeout, sync_in_abort)
  • Page 421 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual The magnitude of the first pulse is start volts; the magnitude of the last pulse is stop volts. The magnitude of each pulse in between is LogStep volts larger than the previous pulse, where: LogStepSize = (log10(stop) - log10(start)) / (points -1) LogStep = (n - 1) * (LogStepSize), where n = [2, points]...
  • Page 422 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference dataqueue.add() This function adds an entry to the data queue. Type TSP-Link accessible Affected by Where saved Default value Function Usage result = dataqueue.add(value) result = dataqueue.add(value, timeout) result The resulting value of true or false based on the success of the function value...
  • Page 423 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual dataqueue.CAPACITY This constant is the maximum number of entries that you can store in the data queue. Type TSP-Link accessible Affected by Where saved Default value Constant Usage count = dataqueue.CAPACITY count The variable that is assigned the value of dataqueue.CAPACITY...
  • Page 424 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Example MaxCount = dataqueue.CAPACITY while dataqueue.count < MaxCount do dataqueue.add(1) print("There are " .. dataqueue.count .. " items in the data queue") dataqueue.clear() print("There are " .. dataqueue.count ..
  • Page 425 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Example MaxCount = dataqueue.CAPACITY while dataqueue.count < MaxCount do dataqueue.add(1) print("There are " .. dataqueue.count .. " items in the data queue") dataqueue.clear() print("There are " .. dataqueue.count ..
  • Page 426 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Example dataqueue.clear() for i = 1, 10 do dataqueue.add(i) print("There are " .. dataqueue.count .. " items in the data queue") while dataqueue.count > 0 do x = dataqueue.next() print(x) print("There are "...
  • Page 427 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Example beeper.beep(0.5, 2400) delay(0.250) beeper.beep(0.5, 2400) Emit a double-beep at 2400 Hz. The sequence is 0.5 s on, 0.25 s off, 0.5 s on. Also see None digio.readbit() This function reads one digital I/O line.
  • Page 428 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details The binary equivalent of the returned value indicates the value of the input lines on the I/O port. The least significant bit (bit B1) of the binary number corresponds to line 1; bit B14 corresponds to line 14. For example, a returned value of 170 has a binary equivalent of 000000010101010, which indicates that lines 2, 4, 6, and 8 are high (1), and the other 10 lines are low (0).
  • Page 429 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual digio.trigger[N].clear() This function clears the trigger event on a digital I/O line. Type TSP-Link accessible Affected by Where saved Default value Function Usage digio.trigger[N].clear() Digital I/O trigger line (1 to 14) Details The event detector of a trigger enters the detected state when an event is detected.
  • Page 430 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference digio.trigger[N].mode This attribute sets the mode in which the trigger event detector and the output trigger generator operate on the given trigger line. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)
  • Page 431 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual To control the line state, set the mode to digio.TRIG_BYPASS and use the digio.writebit() and digio.writeport() commands. Example digio.trigger[4].mode = 2 Sets the trigger mode for I/O line 4 to digio.TRIG_RISING. Also see digio.trigger[N].clear() (on page 15-56)
  • Page 432 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference digio.trigger[N].pulsewidth This attribute describes the length of time that the trigger line is asserted for output triggers. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved 10e-6 (10 µs)
  • Page 433 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Also see digio.trigger[N].assert() (on page 15-55) digio.trigger[N].pulsewidth (on page 15-59) digio.trigger[N].reset() This function resets trigger values to their factory defaults. Type TSP-Link accessible Affected by Where saved Default value Function Usage digio.trigger[N].reset()
  • Page 434 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference digio.trigger[N].stimulus This attribute selects the event that causes a trigger to be asserted on the digital output line. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved Digital I/O trigger N reset...
  • Page 435 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Example 1 digio.trigger[3].stimulus = 0 Clear the trigger stimulus of digital I/O line 3. Example 2 digio.trigger[3].stimulus = Set the trigger smua.trigger.SOURCE_COMPLETE_EVENT_ID stimulus of digital I/O line 3 to be the source complete event.
  • Page 436 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference digio.writebit() This function sets a digital I/O line high or low. Type TSP-Link accessible Affected by Where saved Default value Function Usage digio.writebit(N, data) Digital I/O trigger line (1 to 14) data The value to write to the bit: ▪...
  • Page 437 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details The binary representation of data indicates the output pattern to be written to the I/O port. For example, a data value of 170 has a binary equivalent of 00000010101010. Lines 2, 4, 6, and 8 are set high (1), and the other 10 lines are set low (0).
  • Page 438 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference display.clear() This function clears all lines of the virtual front-panel display. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.clear() Details This function switches to the user screen and then clears the virtual front-panel display. The display.clear(), display.setcursor(), and display.settext() functions are overlapped commands.
  • Page 439 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Annunciator (indicator) bitmasked values and equivalent constants Indicator Weighted Equivalent constant value display.ANNUNCIATOR_FILTER FILT display.ANNUNCIATOR_MATH MATH display.ANNUNCIATOR_4_WIRE display.ANNUNCIATOR_AUTO AUTO display.ANNUNCIATOR_ARM display.ANNUNCIATOR_TRIGGER TRIG display.ANNUNCIATOR_STAR * (asterisk) display.ANNUNCIATOR_SAMPLE SMPL display.ANNUNCIATOR_EDIT EDIT display.ANNUNCIATOR_ERROR display.ANNUNCIATOR_REMOTE...
  • Page 440 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference display.getcursor() This function reads the present position of the cursor on the virtual front-panel display. Type TSP-Link accessible Affected by Where saved Default value Function Usage row, column, style = display.getcursor() The row where the cursor is: 1 (top row);...
  • Page 441 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual display.getlastkey() This function retrieves the key code for the last pressed key. Type TSP-Link accessible Affected by Where saved Default value Function Usage keyCode = display.getlastkey() keyCode A returned value that represents the last virtual front-panel key pressed; see Details for more information Details A history of the key code for the last pressed virtual front-panel key is maintained by the instrument.
  • Page 442 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference You cannot use this function to track the OUTPUT ON/OFF controls for SMU A or SMU B. Example key = display.getlastkey() print(key) On the virtual front panel, press the MENU key and then send the code shown here. This retrieves the key code for the last pressed key.
  • Page 443 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Example 1 display.clear() display.setcursor(1, 1) display.settext("ABCDEFGHIJ$DKLMNOPQRST") display.setcursor(2, 1) display.settext("abcdefghijklm$Bnopqrstuvwxyz$F123456") print(display.gettext()) print(display.gettext(true)) print(display.gettext(false, 2)) print(display.gettext(true, 2, 9)) print(display.gettext(false, 2, 9, 10)) This example shows how to retrieve the display text in multiple ways. The output is: ABCDEFGHIJKLMNOPQRST$Nabcdefghijklmnopqrstuvwxyz123456 $RABCDEFGHIJ$DKLMNOPQRST$N$Rabcdefghijklm$Bnopqrstuvwxyz$F123456 abcdefghijklmnopqrstuvwxyz123456...
  • Page 444 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details The format parameter uses zeros (0), the decimal point, polarity sign, and exponents to define how the input field is formatted. The format parameter can include the options shown in the following table.
  • Page 445 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual display.loadmenu.add() This function adds an entry to the USER menu, which can be accessed by pressing the LOAD key on the virtual front panel. Type TSP-Link accessible Affected by Where saved Default value Function...
  • Page 446 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Example 2 display.loadmenu.add("Test", "DUT1() beeper.beep(2, 500)", display.SAVE) Assume a script with a function named “DUT1” is loaded into the instrument, and the script has not been saved in nonvolatile memory. Now assume you want to add a test named “Test”...
  • Page 447 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Also see display.loadmenu.add() (on page 15-72) display.loadmenu.delete() (on page 15-74) display.loadmenu.delete() This function removes an entry from the USER menu, which can be accessed using the LOAD key on the virtual front panel.
  • Page 448 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details Set display.locallockout to display.LOCK to prevent the user from interrupting remote operation by pressing the EXIT (LOCAL) key. Set this attribute to display.UNLOCK to allow the EXIT (LOCAL) key to interrupt script or remote operation.
  • Page 449 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual display.numpad This attribute controls whether the virtual front panel keys act as a numeric keypad during value entry. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup 1 (display.ENABLE)
  • Page 450 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details This function creates an editable input field at the present cursor position, and an input prompt message on the bottom line. Example of a displayed input field and prompt: 0.00V Input 0 to +2V The format parameter uses zeros (0), the decimal point, polarity sign, and exponents to define how...
  • Page 451 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual display.screen This attribute contains the selected display screen. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup 2 (display.SMUA_SMUB) Recall setup Usage displayID = display.screen display.screen = displayID displayID...
  • Page 452 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Key codes Value Key list Value Key list display.KEY_RANGEUP display.KEY_MEASB display.KEY_MODEB display.KEY_DIGITSB display.KEY_RELB display.KEY_RECALL display.KEY_MENU display.KEY_MEASA display.KEY_MODEA display.KEY_DIGITSA display.KEY_RELA display.KEY_OUTPUTA display.KEY_RUN display.KEY_LIMITB display.KEY_DISPLAY display.KEY_SPEEDB display.KEY_AUTO display.KEY_TRIG display.KEY_FILTERB display.KEY_LIMITA display.KEY_EXIT display.KEY_SPEEDA display.KEY_SRCB...
  • Page 453 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details Sending this command selects the user screen and then moves the cursor to the given location. The display.clear(), display.setcursor(), and display.settext() functions are overlapped commands. That is, the script does not wait for one of these commands to complete. These functions do not immediately update the virtualdisplay.
  • Page 454 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference The display.clear(), display.setcursor(), and display.settext() functions are overlapped commands. That is, the script does not wait for one of these commands to complete. These functions do not immediately update the virtualdisplay. For performance considerations, they update the display as soon as processing time becomes available.
  • Page 455 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual display.smuX.digits This attribute sets the virtual front-panel display resolution of the selected measurement. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup 5 (display.DIGITS_5_5) Recall setup Usage...
  • Page 456 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details Selects the displayed limit function: primary (IV) or power (P). SMU A and SMU B can be set for different display functions. Example display.smua.limit.func = display.LIMIT_P Specify the power limit value is displayed for SMU Channel A. Also see display.smuX.measure.func (on page 15-83)
  • Page 457 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual display.trigger.clear() This function clears the virtual front-panel trigger event detector. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.trigger.clear() Details The trigger event detector remembers if an event has been detected since the last display.trigger.wait() call.
  • Page 458 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Usage overrun = display.trigger.overrun overrun The trigger overrun state (true or false) Details Indicates if a trigger event was ignored because the event detector was already in the detected state when the TRIG button was pressed.
  • Page 459 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual display.waitkey() This function captures the key code value for the next virtual front-panel action. Type TSP-Link accessible Affected by Where saved Default value Function Usage keyCode = display.waitkey() keyCode See Details for more information Details...
  • Page 460 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference When using this function, use built-in constants such as display.KEY_RIGHT (rather than the numeric value of 103). This allows for better forward compatibility with firmware revisions. Example key = display.waitkey() print(key) Pause script execution until the operator presses a key or the navigation wheel, or rotates the navigation wheel.
  • Page 461 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual errorqueue.count This attribute gets the number of entries in the error queue. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Power cycle Not applicable Not applicable Clearing error queue Reading error messages Usage...
  • Page 462 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Returned severity levels are described in the following table. Number Error level Description NO_SEVERITY The message is information only. This level is used when the error queue is empty; the message does not represent an error. INFORMATIONAL The message is information only.
  • Page 463 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Example print(eventlog.all()) Get and print all entries from the event log and remove the entries from the log. Output: 17:26:35.690 10 Oct 2019, LAN0, 192.168.1.102, LXI, 0, 1570728395, 1192037155.733269000, 0, 0x0 17:26:39.009 10 Oct 2019, LAN5, 192.168.1.102, LXI, 0, 1570728399, 1192037159.052777000, 0, 0x0...
  • Page 464 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Example print(eventlog.count) Displays the present number of events in the instrument event log. Output looks similar to: 3.00000e+00 Also see eventlog.all() (on page 15-89) eventlog.clear() (on page 15-90) eventlog.enable (on page 15-91) eventlog.next()
  • Page 465 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual eventlog.next() This function returns the oldest unread event message from the event log and removes it from the event log. Type TSP-Link accessible Affected by Where saved Default value Function Usage logString = eventlog.next()
  • Page 466 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference eventlog.overwritemethod This attribute controls how the event log processes events if the event log is full. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved 1 (eventlog.DISCARD_OLDEST) Recall setup...
  • Page 467 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Also see waitcomplete() (on page 15-407) fileVar:close() This function closes the file that is represented by the fileVar variable. Type TSP-Link accessible Affected by Where saved Default value Function Usage fileVar:close()
  • Page 468 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference fileVar:flush() This function writes buffered data to a file. Type TSP-Link accessible Affected by Where saved Default value Function Usage fileVar:flush() fileVar The file descriptor variable to flush Details The fileVar:write() or io.write() functions buffer data, which may not be written immediately to the USB flash drive.
  • Page 469 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual fileVar:read() This function reads data from a file. Type TSP-Link accessible Affected by Where saved Default value Function Usage data1 = fileVar:read() data1 = fileVar:read(format1) data1, data2 = fileVar:read("format1", "format2") data1, ..., datan = fileVar:read("format1", ..., "formatn") data1 First data read from the file...
  • Page 470 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Example local fileName = "/usb1/myfile.txt" if fs.is_file(fileName) then os.remove(fileName) print("Removing file") else print("Nothing removed") print("fileVar:read") myfile, myfile_err, myfile_errnum = io.open(fileName, "w") myfile:write("Line 1") myfile:close() myfile, myfile_err, myfile_errnum = io.open(fileName, "r") contents = myfile:read("*a") print(contents) myfile:close()
  • Page 471 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details The whence parameters may be any of the following: "set": Beginning of file "cur": Current position "end": End of file If an error is encountered, it is logged to the error queue, and the command returns nil and the error string.
  • Page 472 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference fileVar:write() This function writes data to a file. Type TSP-Link accessible Affected by Where saved Default value Function Usage fileVar:write(data) fileVar:write(data1, data2) fileVar:write(data1, ..., datan) fileVar The file descriptor variable data Write all data to the file data1...
  • Page 473 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual format.asciiprecision This attribute sets the precision (number of digits) for all numbers returned in the ASCII format. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved Recall setup...
  • Page 474 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Usage order = format.byteorder format.byteorder = order order Byte order value as follows: ▪ Most significant byte first: 0, format.NORMAL, format.NETWORK, or format.BIGENDIAN ▪ Least significant byte first: 1, format.SWAPPED or format.LITTLEENDIAN Details This attribute selects the byte order in which data is written when you are printing data values with the printnumber() and printbuffer() functions.
  • Page 475 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual format.data This attribute sets the data format for data that is printed using the printnumber() and printbuffer() functions. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved 1 (format.ASCII)
  • Page 476 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Also see format.asciiprecision (on page 15-100) format.byteorder (on page 15-100) printbuffer() (on page 15-170) printnumber() (on page 15-171) fs.chdir() This function sets the current working directory. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 477 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual fs.cwd() This function returns the absolute path of the current working directory. Type TSP-Link accessible Affected by Where saved Default value Function Usage path = fs.cwd() path The absolute path of the current working directory Example if fs.is_dir("/usb1/temp") == true then fs.chdir("/usb1/temp")
  • Page 478 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Example 1 print("Is directory: ", fs.is_dir("/usb1/")) Because /usb1/ is always the root directory of an inserted flash drive, you can use this command to verify that USB flash drive is inserted. Example 2 if fs.is_dir("/usb1/temp") == false then fs.mkdir("/usb1/temp")
  • Page 479 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual fs.mkdir() This function creates a directory at the specified path. Type TSP-Link accessible Affected by Where saved Default value Function Usage path = fs.mkdir("newPath") path The returned path of the new directory newpath Location (path) of where to create the new directory Details...
  • Page 480 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference fs.readdir() This function returns a list of the file system entries in the directory. Type TSP-Link accessible Affected by Where saved Default value Function Usage files = fs.readdir("path") files A table containing the names of all the file system entries in the specified directory path...
  • Page 481 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details This path may be absolute or relative to the present working directory. An error is logged to the error queue if the given path does not exist or does not represent a directory. An error is also logged if the directory is not empty.
  • Page 482 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Also see settimezone() (on page 15-189) gm_isweep() This KIParlib factory script function performs a linear current sweep and calculates the transconductance (G ) at each point. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 483 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual gm_vsweep() This KIParlib factory script function performs a linear voltage sweep and calculates the transconductance (G ) at each point. Type TSP-Link accessible Affected by Where saved Default value Function Usage gm_array, ibuf, vbuf = gm_vsweep(smu, start_v, stop_v, points)
  • Page 484 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference i_leakage_measure() This KIHighC factory script function performs a current leakage measurement after stepping the output voltage. Type TSP-Link accessible Affected by Where saved Default value Function Usage imeas = i_leakage_measure(smuX, levelv, limiti, sourcedelay, measurei, measuredelay) imeas The measured current Instrument channel (for example, smua refers to SMU channel A)
  • Page 485 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Also see i_leakage_threshold() (on page 15-112) High-capacitance mode (on page 5-52) KIHighC factory script (on page 13-22) i_leakage_threshold() This KIHighC factory script function measures the current and compares it to a threshold. This continues until either the measured current drops below the threshold or the timeout expires.
  • Page 486 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Example smua.source.highc = smua.ENABLE smua.source.levelv = 5 smua.source.output = smua.OUTPUT_ON delay(1) pass = i_leakage_threshold(smua, 0, 1, 300e-3, 10e-6, 100e-3, 1e-6, 1) Enable high-capacitance mode. Charge the capacitor. The parameters passed on to the i_threshold_measure() function in this example are: smu = smua levelv = 0 V limiti = 1 A...
  • Page 487 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Example smua.reset() smua.source.rangev = 5 smua.source.rangei = 1 smua.source.levelv = 0 smua.measure.rangev = 5 smua.measure.rangei = 1 smua.measure.nplc = 0.01 smua.measure.autozero = smua.AUTOZERO_ONCE smua.nvbuffer1.clear() smua.nvbuffer1.appendmode = 1 smua.source.output = smua.OUTPUT_ON f1, msg1 = ConfigPulseVMeasureI(smua, 0, 5, 1, 0.002, 0.2, 10, smua.nvbuffer1, 1) if f1 == true then f2, msg2 = InitiatePulseTest(1)
  • Page 488 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference InitiatePulseTestDual() (on page 13-20) function initiates the pulse configuration assigned tag1 and tag2. This KIPulse factory script Type TSP-Link accessible Affected by Where saved Default value Function Usage f, msg = InitiatePulseTestDual(tag1, tag2) A Boolean flag;...
  • Page 489 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Example smua.reset() smua.source.rangev = 5 smua.source.rangei = 1 smua.source.levelv = 0 smua.measure.rangev = 5 smua.measure.rangei = 1 smua.measure.nplc = 0.01 smua.measure.autozero = smua.AUTOZERO_ONCE smua.nvbuffer1.clear() smua.nvbuffer1.appendmode = 1 smua.source.output = smua.OUTPUT_ON smub.reset() smub.source.func = smub.OUTPUT_DCAMPS smub.source.rangei = 1...
  • Page 490 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference io.close() This function closes a file. Type TSP-Link accessible Affected by Where saved Default value Function Yes (see Details) Usage io.close() io.close(file) file The descriptor of the file to close Details If a file is not specified, the default output file closes.
  • Page 491 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual This function only flushes the default output file. Using this command removes the need to close a file after writing to it and allows it to be left open to write more data.
  • Page 492 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference io.open() This function opens a file for later reference. Type TSP-Link accessible Affected by Where saved Default value Function Usage fileVar, errorMsg = io.open("path") fileVar, errorMsg = io.open("path", "mode") fileVar The descriptor of the opened file errorMsg...
  • Page 493 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details The path of the file to open may be absolute or relative to the current working directory. When accessed from a remote node using the TSP-Link network, this command does not accept a file descriptor parameter and does not return a value.
  • Page 494 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference io.read() This function reads data from the default input file. Type TSP-Link accessible Affected by Where saved Default value Function Usage data1 = io.read() data1 = io.read("format1") data1, data2 = io.read("format1", "format2") data1, ..., dataN = io.read("format1", ..., "formatN") data1 The data read from the file...
  • Page 495 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Example local fileName = "/usb1/myfile.txt" if fs.is_file(fileName) then os.remove(fileName) print("Removing file") else print("Nothing removed") errorqueue.clear() -- io.read print("\n*** io.read") myfile, myfile_err, myfile_errnum = io.open(fileName, "w") myfile:write("Line 1\n") myfile:flush() myfile:close() fileHandle = io.input(fileName) value = io.read("*a")
  • Page 496 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Example local fileName = "/usb1/myfile.txt" if fs.is_file(fileName) then os.remove(fileName) print("Removing file") else print("Nothing removed") errorqueue.clear() print("\n*** io.type") myfile, myfile_err, myfile_errnum = io.open(fileName, "w") myfile:write("Line 1") myfile:close() fileHandle = io.output(fileName) state = io.type(fileHandle) print(state) io.close(fileHandle)
  • Page 497 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details All data parameters must be either strings or numbers. Data is not immediately written to a file when you use the io.write() function. The io.write() function buffers data; it may not be written to the USB flash drive immediately. Use the io.flush() function to immediately write buffered data to the drive.
  • Page 498 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference lan.applysettings() This function re-initializes the LAN interface with new settings. Type TSP-Link accessible Affected by Where saved Default value Function Usage lan.applysettings() Details Disconnects all existing LAN connections to the instrument and re-initializes the LAN with the present configuration settings.
  • Page 499 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Set this attribute to lan.ENABLE to automatically reset the LAN connection after the LAN link is established. Example lan.autoconnect = lan.ENABLE Enable LAN link monitoring. Also see lan.linktimeout (on page 15-133) lan.restoredefaults() (on page 15-136)
  • Page 500 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference lan.config.dns.domain Configures the dynamic DNS domain. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory "" Usage domain = lan.config.dns.domain lan.config.dns.domain = "domain" domain Dynamic DNS registration domain;...
  • Page 501 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details Dynamic DNS registration works with DHCP to register the host name with the DNS server. The host name is specified in the lan.config.dns.hostname attribute. Example print(lan.config.dns.dynamic) Outputs the dynamic registration state. If dynamic DNS registration is enabled, the response is: 1.00000e+00 Also see...
  • Page 502 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Example print(lan.config.dns.hostname) Outputs the present dynamic DNS host name. Also see lan.config.dns.dynamic (on page 15-127) lan.restoredefaults() (on page 15-136) lan.config.dns.verify This attribute defines the DNS host name verification state. Type TSP-Link accessible Affected by...
  • Page 503 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Usage duplex = lan.config.duplex lan.config.duplex = duplex duplex LAN duplex setting can be one of the following values: ▪ 1 or lan.FULL: Selects full-duplex operation ▪ 0 or lan.HALF: Selects half-duplex operation Details This attribute does not indicate the actual setting currently in effect.
  • Page 504 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference lan.config.ipaddress This command specifies the LAN IP address. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory "192.168.0.2" Usage ipAddress = lan.config.ipaddress lan.config.ipaddress = "ipAddress"...
  • Page 505 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details This attribute controls how the LAN IP address, subnet mask, default gateway address, and DNS server addresses are determined. When method is lan.AUTO, the instrument first attempts to configure the LAN settings using dynamic host configuration protocol (DHCP).
  • Page 506 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference lan.config.subnetmask This attribute contains the LAN subnet mask. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory "255.255.255.0" Usage mask = lan.config.subnetmask lan.config.subnetmask = "mask"...
  • Page 507 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details You must enable the command lan.autoconnect before you can use this attribute. The timeout value represents the amount of time that passes before the instrument disconnects from the LAN due to the loss of the LAN link integrity. The LAN interface does not disconnect if the connection to the LAN is reestablished before the timeout value expires.
  • Page 508 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference lan.nagle This attribute controls the state of the LAN Nagle algorithm. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Power cycle Not saved 0 (lan.DISABLE) Usage state = lan.nagle lan.nagle = state...
  • Page 509 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual lan.restoredefaults() This function resets LAN settings to default values. Type TSP-Link accessible Affected by Where saved Default value Function Usage lan.restoredefaults() Details The settings that are restored are shown in the following table. Settings that are restored to default Attribute Default setting...
  • Page 510 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference lan.status.dns.address[N] This attribute contains the DNS server IP addresses. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage dnsAddress = lan.status.dns.address[N] dnsAddress DNS server IP address Entry index (1, 2, or 3)
  • Page 511 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details A fully qualified domain name (FQDN) specifies its exact location in the tree hierarchy of the Domain Name System (DNS). A FQDN is the complete domain name for a specific computer or host on the LAN. The FQDN consists of two parts: The host name and the domain name.
  • Page 512 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference lan.status.gateway This attribute contains the gateway address presently in use by the LAN interface. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage gatewayAddress = lan.status.gateway...
  • Page 513 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual lan.status.macaddress This attribute contains the LAN MAC address. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage macAddress = lan.status.macaddress macAddress The instrument MAC address Details...
  • Page 514 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference lan.status.port.rawsocket This attribute contains the LAN raw socket connection port number. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage port = lan.status.port.rawsocket port...
  • Page 515 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual lan.status.port.vxi11 This attribute contains the LAN VXI-11 connection port number. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage port = lan.status.port.vxi11 port LAN VXI-11 port number...
  • Page 516 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference lan.status.subnetmask This attribute contains the LAN subnet mask that is presently in use by the LAN interface. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable...
  • Page 517 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual lan.trigger[N].assert() This function simulates the occurrence of the trigger and generates the corresponding event ID. Type TSP-Link accessible Affected by Where saved Default value Function Usage lan.trigger[N].assert() The LAN event number (1 to 8) Details Generates and sends a LAN trigger packet for the LAN event number specified.
  • Page 518 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details The trigger event detector enters the detected state when an event is detected. This function clears a trigger event detector and discards the history of the trigger packet. This function clears all overruns associated with this LAN trigger.
  • Page 519 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual lan.trigger[N].connected This attribute stores the LAN event connection state. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage connected = lan.trigger[N].connected connected The LAN event connection state: ▪...
  • Page 520 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details For TCP connections, this closes the TCP connection. The LAN trigger automatically disconnects when either the lan.trigger[N].protocol or lan.trigger[N].ipaddress attributes for this event are changed. Also see lan.trigger[N].ipaddress (on page 15-147) lan.trigger[N].protocol...
  • Page 521 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details Sets the IP address for outgoing trigger events. Set to "0.0.0.0" for multicast. After changing this setting, the lan.trigger[N].connect() command must be called before outgoing messages can be sent. Example lan.trigger[3].protocol = lan.TCP lan.trigger[3].ipaddress = "192.168.1.100"...
  • Page 522 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference lan.TRIG_RISING and lan.TRIG_RISINGA are the same. lan.TRIG_RISING and lan.TRIG_RISINGM are the same. Use of either lan.TRIG_SYNCHRONOUSA or lan.TRIG_SYNCHRONOUSM instead of lan.TRIG_SYNCHRONOUS is preferred. Use of lan.TRIG_SYNCHRONOUS is provided for compatibility with older products and other Keithley Instruments products.
  • Page 523 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual lan.trigger[N].protocol This attribute sets the LAN protocol to use for sending trigger messages. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved 0 (lan.TCP) LAN trigger N reset Recall setup...
  • Page 524 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details This attribute can be set to initialize the pseudo line state to a known value. Setting this attribute does not cause the LAN trigger to generate any events or output packets. Example print(lan.trigger[1].pseudostate) Get the present simulated line state for the LAN event 1.
  • Page 525 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Trigger event IDs* Event ID Event description display.trigger.EVENT_ID Occurs when the TRIG key on the virtual front panel is pressed trigger.EVENT_ID Occurs when a *TRG command is received on the remote interface USB only: Occurs when a USBTMC TRIGGER message is received...
  • Page 526 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details If one or more trigger events have been detected since the last time lan.trigger[N].wait() or lan.trigger[N].clear() was called, this function returns immediately. After waiting for a LAN trigger event with this function, the event detector is automatically reset and rearmed regardless of the number of events detected.
  • Page 527 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual localnode.description This attribute stores a user-defined description and mDNS service name of the instrument. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory Instrument specific (see Details) Usage localnode.description = "description"...
  • Page 528 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Also see None localnode.linefreq This attribute contains the power line frequency setting that is used for NPLC calculations. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory 60 (60 Hz)
  • Page 529 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Example print(localnode.model) Outputs the model number of the local node. For example: 2606B Also see localnode.serialno (on page 15-161) localnode.password This attribute stores the remote access password. Type TSP-Link accessible Affected by Where saved...
  • Page 530 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference localnode.passwordmode This attribute stores the password enable mode for remote access to the instrument. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory 1 (localnode.PASSWORD_WEB) Usage mode = localnode.passwordmode...
  • Page 531 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual localnode.prompts This attribute determines if the instrument generates prompts in response to command messages. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Power cycle Not saved 0 (disabled) Usage prompting = localnode.prompts...
  • Page 532 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Also see localnode.showerrors (on page 15-161) tsplink.reset() (on page 15-380) localnode.prompts4882 This attribute enables and disables the generation of prompts for IEEE Std 488.2 common commands. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 533 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details If you want to reset a specific instrument or a subordinate node, use the node[X].reset() command. A local node reset includes: • Source-measure unit (SMU) attributes affected by a SMU reset are reset •...
  • Page 534 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference localnode.serialno This attribute stores the serial number of the module. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage serialno = localnode.serialno serialno The serial number of the module...
  • Page 535 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details If this attribute is set to 1, the instrument automatically sends any generated errors stored in the error queue, and then clears the queue. Errors are processed after executing a command message (just before issuing a prompt if prompts are enabled).
  • Page 536 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference makesetter() This function creates a function that, when called, sets the value of an attribute. Type TSP-Link accessible Affected by Where saved Default value Function Usage setter = makesetter(table, "attributeName") setter Function that sets the value of the attribute table...
  • Page 537 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details This function returns two values: • The amount of free dynamically allocated memory available in kilobytes • The total amount of dynamically allocated memory on the instrument in kilobytes The difference between the two values is the amount presently used.
  • Page 538 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Example 3 node[32].execute(TestDut.source) Runs the test script stored in the variable TestDut (previously stored on the master node) on node 32. Also see TSP advanced features (on page 14-57) tsplink.group (on page 15-377) node[N].getglobal()
  • Page 539 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual node[N].setglobal() This function sets the value of a global variable. Type TSP-Link accessible Affected by Where saved Default value Function Usage node[N].setglobal("name", value) The node number of this instrument (1 to 64) name The global variable name to set value...
  • Page 540 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Example opc() waitcomplete() print("1") Output: Also see Status model (on page 10-1) waitcomplete() (on page 15-407) os.remove() This function deletes the file or directory with a given name. Type TSP-Link accessible Affected by...
  • Page 541 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details If this function fails, it returns nil (for success) and an error message string (for msg). Example os.rename("testFile", "exampleFile") Changes the name of the existing file testFile to the name exampleFile. Also see os.remove() (on page 15-167)
  • Page 542 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference print() This function generates a response message. Type TSP-Link accessible Affected by Where saved Default value Function Usage print(value1) print(value1, value2) print(value1, ..., valueN) value1 The first argument to output value2 The second argument to output valueN...
  • Page 543 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual printbuffer() This function prints data from tables or reading buffer subtables. Type TSP-Link accessible Affected by Where saved Default value Function Usage printbuffer(startIndex, endIndex, bufferVar) printbuffer(startIndex, endIndex, bufferVar, bufferVar2) printbuffer(startIndex, endIndex, bufferVar, ..., bufferVarN) startIndex Beginning index of the buffer to print;...
  • Page 544 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Also see bufferVar.n (on page 15-28) bufferVar.readings (on page 15-29) format.asciiprecision (on page 15-100) format.byteorder (on page 15-100) format.data (on page 15-102) printnumber() This function prints numbers using the configured format. Type TSP-Link accessible Affected by...
  • Page 545 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual PulseIMeasureV() This KIPulse factory script function performs a specified number of pulse I, measure V cycles. Type TSP-Link accessible Affected by Where saved Default value Function Usage PulseIMeasureV(smu, bias, level, ton, toff, points) Instrument channel (for example, smua refers to SMU channel A) bias Bias level in amperes...
  • Page 546 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference PulseVMeasureI() This KIPulse factory script function performs a specified number of pulse V, measure I cycles. Type TSP-Link accessible Affected by Where saved Default value Function Usage PulseVMeasureI(smu, bias, level, ton, toff, points) Instrument channel (for example, smua refers to SMU channel A) bias Bias level in volts...
  • Page 547 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual QueryPulseConfig() This KIPulse factory script function allows you to inspect the settings of the preconfigured pulse train assigned to tag. Type TSP-Link accessible Affected by Where saved Default value Function Usage tbl = QueryPulseConfig(tag)
  • Page 548 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Example smua.reset() Configure channel A to generate a pulse train, query configuration, and then display as a string. smua.source.rangev = 5 Channel A pulses voltage from a bias level of 0 V smua.source.rangei = 1 to a pulse level of 5 V.
  • Page 549 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual reset() This function resets commands to their default settings. Type TSP-Link accessible Affected by Where saved Default value Function Usage reset() reset(system) system What to reset: ▪ true: If the node is the master, the entire system is reset (default) ▪...
  • Page 550 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details Use this function to save the specified buffer to a USB flash drive. This function only saves to a USB flash drive. You are not required to qualify the path to the USB flash drive, but you can add /usb1/ before the fileName (see Example 2).
  • Page 551 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Also see Anonymous scripts (on page 14-4) scriptVar.autorun (on page 15-184) scriptVar.list() (on page 15-185) scriptVar.name (on page 15-185) scriptVar.run() (on page 15-186) scriptVar.save() (on page 15-187) scriptVar.source (on page 15-188) script.delete() This function deletes a script from nonvolatile memory.
  • Page 552 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Example for name in script.factory.catalog() do Retrieve the catalog listing for factory scripts. print(name) Also see None script.load() This function creates a script from a specified file. Type TSP-Link accessible Affected by Where saved...
  • Page 553 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Example myTest8 = Loads the script myTest8 from the USB script.load("/usb1/filename.tsp", flash drive. "myTest8") Also see script.new() (on page 15-180) script.new() This function creates a script. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 554 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Also see Create a script using the script.new() command (on page 14-43) Global variables and the script.user.scripts table (on page 14-42) Named scripts (on page 14-4) scriptVar.save() (on page 15-187) script.newautorun() (on page 15-181) script.newautorun()
  • Page 555 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Also see Create a script using the script.new() command (on page 14-43) Global variables and the script.user.scripts table (on page 14-42) Named scripts (on page 14-4) script.new() (on page 15-180) scriptVar.autorun (on page 15-184) scriptVar.save()
  • Page 556 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Example run() Runs the anonymous script. Also see script.anonymous (on page 15-177) script.user.catalog() This function returns an iterator that can be used in a for loop to iterate over all the scripts stored in nonvolatile memory.
  • Page 557 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual scriptVar.autorun This attribute controls the autorun state of a script. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable See Details See Details Usage scriptVar.autorun = "state"...
  • Page 558 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference scriptVar.list() This function generates a script listing. Type TSP-Link accessible Affected by Where saved Default value Function Usage scriptVar.list() scriptVar The name of the variable that references the script Details This function generates output in the form of a sequence of response messages (one message for each line of the script).
  • Page 559 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details When setting the script name, this attribute renames the script that the variable scriptVar references. This attribute must be either a valid Lua identifier or the empty string. Changing the name of a script changes the index that is used to access the script in the script.user.scripts table.
  • Page 560 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details The scriptVar.run() function runs the script referenced by scriptVar. You can also run the script by using scriptVar(). To run a factory script, use script.factory.scripts.scriptName(), replacing scriptName with the name of the factory script.
  • Page 561 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual scriptVar.source This attribute contains the source code of a script. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Not saved Not applicable (see Details) Usage code = scriptVar.source scriptVar.source = nil...
  • Page 562 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details This function sets the date and time of the instrument based on the time parameter (specified in UTC time). UTC time is specified as the number of seconds since Jan 1, 1970, UTC. You can use UTC time from a local time specification, or you can use UTC time from another source (for example, your computer).
  • Page 563 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual For example, to set the UTC-5 time zone, you specify the string "5", because UTC-5 is 5 hours behind UTC and you must add 5 hours to the local time to determine UTC time. To specify the time zone UTC4, you specify "-4", because UTC4 is 4 hours ahead of UTC and 4 hours must be subtracted from the local time to determine UTC.
  • Page 564 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details When id = 0, the instrument uses the factory default setup when it is turned on. When id is set to 1 to 5, it uses the setup saved with setup.save(). Only setups stored in nonvolatile memory are available (you cannot recall a script from a USB flash drive with this command).
  • Page 565 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Also see Saved setups (on page 4-13) setup.save() (on page 15-192) setup.save() This function saves the present setup as a user-saved setup. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
  • Page 566 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference smuX.abort() This function terminates all overlapped operations on the specified source-measure unit (SMU). Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.abort() Source-measure unit (SMU) channel (for example, smua.abort() applies to SMU channel A) Details The smuX.abort() function does not turn the output off or change any settings.
  • Page 567 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual The statistics parameter has the attributes described in the following table. Attribute When returned Description Always The number of data points on which the statistics are based mean When n >...
  • Page 568 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Example reset() smua.nvbuffer1.clear() smua.measure.count = 10 smua.measure.v(smua.nvbuffer1) stats = smua.buffer.getstats(smua.nvbuffer1) print("n= "..stats.n) print("mean= "..stats.mean) print("stddev= "..stats.stddev) print("min= "..stats.min.reading) print("max= "..stats.max.reading) Make measurements and store them in nvbuffer1. Print the statistics for the data. Example output: n= 10 mean= -2.3851394871599e-05...
  • Page 569 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual smuX.cal.adjustdate This attribute stores the date of the last calibration adjustment. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU cal. restore SMU nonvolatile memory Initially set to factory calibration date Usage...
  • Page 570 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference smuX.cal.date This attribute stores the calibration date of the active calibration set. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU calibration restore SMU nonvolatile memory Initially set to factory calibration date Usage...
  • Page 571 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual smuX.cal.due This attribute stores the calibration due date for the next calibration. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU cal. restore SMU nonvolatile memory Usage calDue = smuX.cal.due smuX.cal.due = calDue...
  • Page 572 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference smuX.cal.lock() This function disables the commands that change calibration settings. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.cal.lock() Source-measure unit (SMU) channel (for example, smua.cal.lock() specifies SMU channel A) Details Before you can lock calibration, the calibration constants must be written to nonvolatile memory or a previous calibration set must be restored.
  • Page 573 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Also see Adjustment (on page 17-12) smuX.cal.unlock() (on page 15-204) smuX.cal.polarity This attribute controls which calibration constants are used for all subsequent measurements. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)
  • Page 574 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Also see Adjustment (on page 17-12) reset() (on page 15-176) smuX.cal.lock() (on page 15-199) smuX.cal.unlock() (on page 15-204) smuX.measure.calibrateY() (on page 15-214) smuX.reset() (on page 15-231) smuX.source.calibrateY() (on page 15-234) smuX.cal.restore() This function loads a stored set of calibration constants.
  • Page 575 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual smuX.cal.save() This function stores the active calibration constants to nonvolatile memory. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.cal.save() Source-measure unit (SMU) channel (for example, smua.cal.save() applies to SMU channel A) Details This function stores the active set of calibration constants to nonvolatile memory.
  • Page 576 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference smuX.cal.state This attribute returns the present calibration state. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not saved Not applicable Usage calState = smuX.cal.state calState The present calibration state;...
  • Page 577 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual smuX.cal.unlock() This function enables the commands that change calibration settings. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.cal.unlock(password) Source-measure unit (SMU) channel (for example, smua.cal.unlock() applies to SMU channel A) password Calibration password...
  • Page 578 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details Contact check measurement calibration does not require range information. Typically, points one and two are near 0 Ω and 50 Ω, respectively. All four measurements (cp1Measured, cp1Reference, cp2Measured, and cp2Reference) must be made with the calibration set that is active.
  • Page 579 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual smuX.contact.calibratelo() This function adjusts the low/sense low contact check measurement. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.contact.calibratelo(cp1Measured, cp1Reference, cp2Measured, cp2Reference) Source-measure unit (SMU) channel (for example, smua.contact.calibratelo() applies to SMU channel A) cp1Measured The value measured by this SMU for point 1...
  • Page 580 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference smuX.contact.check() This function determines if contact resistance is lower than the threshold. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.contact.check() Source-measure unit (SMU) channel (for example, smua.contact.check() applies to SMU channel A) Details This function returns true if the contact resistance is below the threshold;...
  • Page 581 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual smuX.contact.r() This function measures aggregate contact resistance. Type TSP-Link accessible Affected by Where saved Default value Function Usage rhi, rlo = smuX.contact.r() The measured aggregate contact resistance on the HI/sense HI side The measured aggregate contact resistance on the LO/sense LO side Source-measure unit (SMU) channel (for example, smua.contact.r() applies to SMU channel A)
  • Page 582 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference smuX.contact.speed This attribute stores the speed setting for contact check measurements. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved 0 (smuX.CONTACT_FAST) SMU reset Recall setup Usage...
  • Page 583 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual smuX.contact.threshold This attribute stores the resistance threshold for the smuX.contact.check() function. Type TSP-Link accessible Affected by Where saved Default value 50 (50 Ω) Attribute (RW) Instrument reset Not saved SMU reset Recall setup Usage...
  • Page 584 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details You can use this function to create and dynamically allocate reading buffers. Use bufferSize to designate the number of readings the buffer can store. You can use dynamically allocated reading buffers interchangeably with the smuX.nvbufferY buffers.
  • Page 585 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details This attribute indicates the measurement autorange state. Its value is smuX.AUTORANGE_OFF when the SMU measure circuit is on a fixed range and smuX.AUTORANGE_ON when it is in autorange mode.
  • Page 586 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details The analog-to-digital converter (ADC) uses a ratiometric A/D conversion technique. To ensure the accuracy of readings, the instrument must periodically obtain new measurements of its internal ground and voltage reference. The time interval between updates to these reference measurements is determined by the integration aperture being used for measurements.
  • Page 587 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual smuX.measure.calibrateY() This function generates and activates new measurement calibration constants. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.measure.calibrateY(range, cp1Measured, cp1Reference, cp2Measured, cp2Reference) Source-measure unit (SMU) channel (for example, smua.measure.calibratev() applies to SMU channel A) SMU measurement function (v = voltage, i = current) range...
  • Page 588 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Also see Adjustment (on page 17-12) smuX.cal.lock() (on page 15-199) smuX.cal.restore() (on page 15-201) smuX.cal.save() (on page 15-202) smuX.cal.unlock() (on page 15-204) smuX.source.calibrateY() (on page 15-234) smuX.measure.count This attribute sets the number of measurements made when a measurement is requested. Type TSP-Link accessible Affected by...
  • Page 589 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual smuX.measure.delay This attribute controls the measurement delay. Type TSP-Link accessible Affected by Where saved Default value −1 (smuX.DELAY_AUTO) Attribute (RW) Instrument reset Saved setup SMU reset Recall setup Usage mDelay = smuX.measure.delay smuX.measure.delay = mDelay...
  • Page 590 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference smuX.measure.delayfactor This attribute stores a multiplier to the delays that are used when smuX.measure.delay is set to smuX.DELAY_AUTO. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved SMU reset...
  • Page 591 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details This attribute sets the size of the stack used for filtered measurements. Example smua.measure.filter.count = 10 smua.measure.filter.type = smua.FILTER_MOVING_AVG smua.measure.filter.enable = smua.FILTER_ON Sets the filter count for SMU channel A to 10. Sets the filter type to moving average.
  • Page 592 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Also see Filters (on page 5-49) reset() (on page 15-176) setup.recall() (on page 15-191) smuX.measure.filter.count (on page 15-217) smuX.measure.filter.type (on page 15-219) smuX.reset() (on page 15-231) smuX.measure.filter.type This command sets the type of filter used for measurements when the measurement filter is enabled. Type TSP-Link accessible Affected by...
  • Page 593 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Also see Filters (on page 5-49) reset() (on page 15-176) setup.recall() (on page 15-191) smuX.measure.filter.count (on page 15-217) smuX.measure.filter.enable (on page 15-218) smuX.reset() (on page 15-231) smuX.measure.highcrangedelayfactor This attribute contains a delay multiplier that is only used during range changes when the high-capacitance mode is active.
  • Page 594 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference smuX.measure.interval This attribute sets the interval between multiple measurements. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup 0 (0 s) SMU reset Recall setup Usage interval = smuX.measure.interval...
  • Page 595 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual smuX.measure.lowrangeY This attribute sets the lowest measurement range that is used when the instrument is autoranging. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup Current: 100e-9 (100 nA) SMU reset...
  • Page 596 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference smuX.measure.nplc This command sets the integration aperture for measurements. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Saved setup SMU reset Recall setup Usage nplc = smuX.measure.nplc smuX.measure.nplc = nplc...
  • Page 597 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details This function starts a measurement and returns immediately. The measurements, as they are performed, are stored in a reading buffer (along with any other information that is being acquired). If the instrument is configured to return multiple readings where one is requested, the readings are available as they are made.
  • Page 598 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details Reading this attribute returns the positive full-scale value of the measurement range that the SMU is currently using. Assigning a value to this attribute sets the SMU on a fixed range large enough to measure the assigned value.
  • Page 599 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual smuX.measure.rel.enableY This attribute turns relative measurements on or off. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved 0 (smuX.REL_OFF) SMU reset Recall setup Usage relEnable = smuX.measure.rel.enableY...
  • Page 600 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference smuX.measure.rel.levelY This attribute sets the offset value for relative measurements. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved SMU reset Recall setup Usage relValue = smuX.measure.rel.levelY smuX.measure.rel.levelY = relValue...
  • Page 601 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual smuX.measure.Y() This function makes one or more measurements. Type TSP-Link accessible Affected by Where saved Default value Function Usage reading = smuX.measure.Y() reading = smuX.measure.Y(readingBuffer) iReading, vReading = smuX.measure.iv() iReading, vReading = smuX.measure.iv(iReadingBuffer) iReading, vReading = smuX.measure.iv(iReadingBuffer, vReadingBuffer) reading...
  • Page 602 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Example smua.measure.count = 10 Makes 10 voltage measurements using SMU channel A and smua.measure.v(smua.nvbuffer1) stores them in a buffer. Also see Reading buffers (on page 6-1) smuX.measure.count (on page 15-215) smuX.measure.overlappedY() (on page 15-223) smuX.nvbufferY...
  • Page 603 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Example local ivalues = {} This use of the SMU channel A smua.source.rangev = 1 measure and step function measures smua.source.levelv = 0 current starting at a source value of 0 V.
  • Page 604 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Also see Configuring and running sweeps (on page 5-43) Reading buffers (on page 6-1) savebuffer() (on page 15-176) smuX.makebuffer() (on page 15-210) smuX.measure.overlappedY() (on page 15-223) smuX.savebuffer() (on page 15-231) smuX.trigger.measure.action (on page 15-257) smuX.trigger.measure.set()
  • Page 605 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details When the instrument is turned off and back on, the dedicated reading buffers are restored from nonvolatile memory to their last saved values. Example smua.savebuffer(smua.nvbuffer1) Saves buffer 1 (SMU channel A) to internal memory.
  • Page 606 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference smuX.source.autorangeY This attribute contains the state of the source autorange control (on/off). Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Saved setup 1 (smuX.AUTORANGE_ON) Instrument reset Recall setup Usage...
  • Page 607 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual smuX.source.calibrateY() This function generates and activates new source calibration constants. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.source.calibrateY(range, cp1Expected, cp1Reference, cp2Expected, cp2Reference) Source-measure unit (SMU) channel (for example, smua.source.calibratev() applies to SMU channel A) SMU source function (v = voltage, i = current) range...
  • Page 608 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference smuX.source.compliance This attribute contains the state of source compliance. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not saved Not applicable Usage compliance = smuX.source.compliance compliance The state of source compliance: ▪...
  • Page 609 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual smuX.source.delay This attribute contains the source delay. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved 0 (smuX.DELAY_OFF) Instrument reset Recall setup Usage sDelay = smuX.source.delay smuX.source.delay = sDelay...
  • Page 610 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference smuX.source.func This attribute contains the source function, which can be voltage or current. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Saved setup 1 (smuX.OUTPUT_DCVOLTS) Instrument reset Recall setup...
  • Page 611 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details When enabled, the high-capacitance mode has the following effects on the SMU settings: • smuX.measure.autorangei is set to smuX.AUTORANGE_FOLLOW_LIMIT and cannot be changed • Current ranges below 1 µA are not accessible •...
  • Page 612 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference If the source is configured as a current source and the output is on, the new smuX.source.leveli setting is sourced immediately. If the output is off or the source is configured as a voltage source, the current level is sourced when the source is configured as a current source and the output is turned on.
  • Page 613 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Using a limit value of 0 results in error code 1102, "Parameter too small," for v and i. Setting this attribute to zero disables power compliance for p. When setting the power compliance limit to a nonzero value, the SMU adjusts the source limit where appropriate to limit the output to the specified power.
  • Page 614 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference smuX.source.offfunc This attribute sets the source function that is used (source 0 A or 0 V) when the output is turned off and the source-measure unit (SMU) is in normal output-off mode. Type TSP-Link accessible Affected by...
  • Page 615 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Usage sourceLimit = smuX.source.offlimitY smuX.source.offlimitY = sourceLimit sourceLimit Set to the limit to be used when the SMU is in normal output-off mode Source-measure unit (SMU) channel (for example, smua.source.offlimiti applies to SMU channel A) SMU source function (v = voltage, i = current) Details...
  • Page 616 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details Reading this attribute returns the output-off mode of the source. Setting this attribute configures the SMU output-off mode. The default sourceOffMode is smuX.OUTPUT_NORMAL. In this mode, the source function is configured according to the smuX.source.offfunc attribute.
  • Page 617 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details Reading this attribute returns the output state of the source. Setting this attribute switches the output of the source on or off. When the output is switched on, the SMU sources either voltage or current, as set by smuX.source.func.
  • Page 618 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Example smua.source.outputenableaction = smua.OE_OUTPUT_OFF Sets SMU channel A to turn off the output if the output enable line goes low (deasserted). Also see smuX.source.offmode (on page 15-242) smuX.source.output (on page 15-243) smuX.source.rangeY This attribute contains the source range.
  • Page 619 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual smuX.source.settling This attribute contains the source settling mode. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved 0 (smuX.SETTLE_SMOOTH) Instrument reset Recall setup Usage settleOption = smuX.source.settling smuX.source.settling = settleOption...
  • Page 620 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference smuX.trigger.arm.count This attribute sets the arm count in the trigger model. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved Instrument reset Recall setup Usage triggerArmCount = smuX.trigger.arm.count...
  • Page 621 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Example smua.trigger.arm.set() Sets the arm event detector to the detected state for SMU channel A. Also see smuX.trigger.initiate() (on page 15-256) smuX.trigger.measure.set() (on page 15-258) smuX.trigger.source.set() (on page 15-268) smuX.trigger.arm.stimulus This attribute selects the event that will cause the arm event detector to enter the detected state.
  • Page 622 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Trigger event IDs* Event ID Event description trigger.EVENT_ID Occurs when a *TRG command is received on the remote interface USB only: Occurs when a USBTMC TRIGGER message is received VXI-11 only: Occurs with the VXI-11 command device_trigger;...
  • Page 623 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual smuX.trigger.autoclear This attribute turns automatic clearing of the event detectors on or off. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved 0 (smuX.DISABLE) Instrument reset Recall setup...
  • Page 624 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details During a sweep, the SMU iterates through the trigger layer of the trigger model the number of times set by this attribute. After performing the iterations, the SMU returns to the arm layer. If this count is set to zero (0), the SMU stays in the trigger model indefinitely until aborted.
  • Page 625 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual smuX.trigger.endpulse.action This attribute enables or disables pulse mode sweeps. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved 1 (smuX.SOURCE_HOLD) Instrument reset Recall setup Usage pulseAction = smuX.trigger.endpulse.action...
  • Page 626 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details This function sets the end pulse event detector to the detected state. The SMU automatically clears all the event detectors when the smuX.trigger.initiate() function is executed. Therefore, call smuX.trigger.endpulse.set() after the sweep is initiated. If the event detectors are configured to clear automatically because the smuX.trigger.autoclear attribute is set to smuX.ENABLE, make sure that smuX.trigger.endpulse.set() is issued after the SMU has entered the trigger layer.
  • Page 627 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual smuX.trigger.endpulse.stimulus This attribute defines which event will cause the end pulse event detector to enter the detected state. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved Instrument reset...
  • Page 628 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Trigger event IDs* Event ID Event description trigger.timer[N].EVENT_ID Occurs when a delay expires trigger.generator[N].EVENT_ID Occurs when the trigger.generator[N].assert() function is executed * Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).
  • Page 629 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual smuX.trigger.IDLE_EVENT_ID This constant contains the idle event number. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = smuX.trigger.IDLE_EVENT_ID eventID The idle event number Source-measure unit (SMU) channel (for example, smua.trigger.IDLE_EVENT_ID applies to SMU channel A) Details Set the stimulus of any trigger object to the value of this constant to have the trigger object respond to...
  • Page 630 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference To make measurements during the sweep, you must also configure and enable the measure action using smuX.trigger.measure.Y(). If you run this function more than once without reconfiguring the sweep measurements, the caches on the configured measurement reading buffers hold stale data.
  • Page 631 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details With this attribute enabled (setting action to smuX.ENABLE or smuX.ASYNC), configure the measurement with one of the smuX.trigger.measure.Y() functions. If this attribute is set to smuX.ASYNC: • Asynchronous sweep measurements can only be used with measure autoranging turned off.
  • Page 632 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference If the event detectors are configured to clear automatically because the smuX.trigger.autoclear attribute is set to smuX.ENABLE, make sure that smuX.trigger.measure.set() is issued after the SMU has entered the trigger layer. This function can also be used to start actions on the SMU in case of a missed trigger event.
  • Page 633 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Trigger event IDs* Event ID Event description smuX.trigger.SWEEPING_EVENT_ID Occurs when the source-measure unit (SMU) transitions from the idle state to the arm layer of the trigger model smuX.trigger.ARMED_EVENT_ID Occurs when the SMU moves from the arm layer to the trigger layer of the trigger model smuX.trigger.SOURCE_COMPLETE_EVENT_ID...
  • Page 634 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference smuX.trigger.measure.Y() This function configures the measurements that are to be made in a subsequent sweep. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.trigger.measure.Y(rbuffer) smuX.trigger.measure.iv(ibuffer, vbuffer) Source-measure unit (SMU) channel (for example, smua.trigger.measure.v() applies to SMU channel A) SMU measurement type (v = voltage, i = current, r = resistance, p = power)
  • Page 635 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual smuX.trigger.MEASURE_COMPLETE_EVENT_ID This constant contains the measurement complete event number. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = smuX.trigger.MEASURE_COMPLETE_EVENT_ID eventID The measurement complete event number Source-measure unit (SMU) channel (for example, smua.trigger.MEASURE_COMPLETE_EVENT_ID applies to SMU channel A) Details...
  • Page 636 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference smuX.trigger.source.action This attribute enables or disables sweeping the source (on or off). Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved 0 (smuX.DISABLE) Instrument reset Recall setup Usage...
  • Page 637 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual smuX.trigger.source.limitY This attribute sets the sweep source limit. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) SMU reset Not saved 0 (smuX.LIMIT_AUTO) Instrument reset Recall setup Usage sweepSourceLimit = smuX.trigger.source.limitY smuX.trigger.source.limitY = sweepSourceLimit...
  • Page 638 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference smuX.trigger.source.linearY() This function configures a linear source sweep. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.trigger.source.linearY(startValue, endValue, points) Source-measure unit (SMU) channel (for example, smua.trigger.source.linearv(0, 10, 11) applies to SMU channel A) SMU source function (v = voltage, i = current) startValue...
  • Page 639 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual smuX.trigger.source.listY() This function configures an array-based source sweep. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.trigger.source.listY(sweepList) Source-measure unit (SMU) channel (for example, smua.trigger.source.listv({5}) applies to SMU channel A) SMU source function (v = voltage, i = current) sweepList An array of source values...
  • Page 640 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference smuX.trigger.source.logY() This function configures an exponential (geometric) source sweep. Type TSP-Link accessible Affected by Where saved Default value Function Usage smuX.trigger.source.logY(startValue, endValue, points, asymptote) Source-measure unit (SMU) channel (for example, smua.trigger.source.logv(1, 10, 11, 0) applies to SMU channel A) SMU source function (v = voltage, i = current) startValue...
  • Page 641 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Source functions cannot be changed within a sweep. After configuring the sweep source values, enable the source action by setting smuX.trigger.source.action. Example smua.trigger.source.logv(1, 10, 11, 0) Sweeps SMU channel A from 1 V to 10 V in 10 steps with an asymptote of 0 V.
  • Page 642 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Also see smuX.trigger.arm.set() (on page 15-247) smuX.trigger.autoclear (on page 15-250) smuX.trigger.endpulse.set() (on page 15-252) smuX.trigger.initiate() (on page 15-256) smuX.trigger.measure.set() (on page 15-258) Triggering (on page 7-1) smuX.trigger.source.stimulus This attribute defines which event causes the source event detector to enter the detected state. Type TSP-Link accessible Affected by...
  • Page 643 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Trigger event IDs* Event ID Event description trigger.EVENT_ID Occurs when a *TRG command is received on the remote interface USB only: Occurs when a USBTMC TRIGGER message is received VXI-11 only: Occurs with the VXI-11 command device_trigger;...
  • Page 644 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference smuX.trigger.SWEEP_COMPLETE_EVENT_ID This constant contains the sweep complete event number. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = smuX.trigger.SWEEP_COMPLETE_EVENT_ID eventID The sweep complete event number Source-measure unit (SMU) channel (for example, smua.trigger.SWEEP_COMPLETE_EVENT_ID applies to SMU channel A) Details...
  • Page 645 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Example reset() period_timer = trigger.timer[1] pulse_timer = trigger.timer[2] smua.trigger.source.listv( {5} ) smua.trigger.source.action = smua.ENABLE smua.source.rangev = 5 smua.trigger.measure.action = smua.DISABLE pulse_timer.delay = 0.0006 pulse_timer.stimulus = period_timer.EVENT_ID pulse_timer.count = 1 period_timer.delay = 0.005 period_timer.count = 9 period_timer.stimulus = smua.trigger.SWEEPING_EVENT_ID...
  • Page 646 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference status.condition This attribute stores the status byte condition register. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not saved Not applicable Usage statusByte = status.condition statusByte The status byte;...
  • Page 647 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Value Description status.MASTER_SUMMARY_STATUS Request Service (RQS)/Master Summary Status status.MSS (MSS). Depending on how it is used, bit B6 of the status byte register is either the Request for Service (RQS) bit or the Master Summary Status (MSS) bit: ▪...
  • Page 648 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference status.measurement.* This attribute contains the measurement event register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW) Status reset Not saved .event (R)
  • Page 649 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Value Description status.measurement.VOLTAGE_LIMIT Set bit is a summary of the status.measurement.voltage_limit status.measurement.VLMT register. Bit B0 decimal value: 1 status.measurement.CURRENT_LIMIT Set bit is a summary of the status.measurement.current_limit status.measurement.ILMT register.
  • Page 650 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Example status.measurement.enable = status.measurement.BAV Sets the BAV bit of the measurement event enable register. Also see Measurement event registers (on page 10-22) status.measurement.buffer_available.* This attribute contains the measurement event buffer available summary register set. Type TSP-Link accessible Affected by...
  • Page 651 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Value Description Not used Not applicable. status.measurement.buffer_available.SMUA Set bit indicates that there is at least one reading stored in either or both of the dedicated reading buffers. Bit B1 decimal value: 2 Binary value: 0000 0010 status.measurement.buffer_available.SMUB Set bit indicates that there is at least one reading stored in either or both of the...
  • Page 652 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Usage measurementRegister = status.measurement.current_limit.condition measurementRegister = status.measurement.current_limit.enable measurementRegister = status.measurement.current_limit.event measurementRegister = status.measurement.current_limit.ntr measurementRegister = status.measurement.current_limit.ptr status.measurement.current_limit.enable = measurementRegister status.measurement.current_limit.ntr = measurementRegister status.measurement.current_limit.ptr = measurementRegister measurementRegister The status of the measurement event current limit summary register; a zero (0) indicates no bits set (also send 0 to clear all bits);...
  • Page 653 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Also see Measurement event registers (on page 10-22) status.measurement.instrument.smuX.* (on page 15-281) status.measurement.instrument.* This attribute contains the registers of the measurement event instrument summary register set. Type TSP-Link accessible Affected by Where saved Default value...
  • Page 654 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Value Description Not used Not applicable. status.measurement.instrument.SMUA Set bit indicates one or more enabled bits of the measurement event SMU A summary register is set. Bit B1 decimal value: 2 Binary value: 0000 0010 status.measurement.instrument.SMUB Set bit indicates one or more enabled bits...
  • Page 655 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Usage measurementRegister = status.measurement.instrument.smuX.condition measurementRegister = status.measurement.instrument.smuX.enable measurementRegister = status.measurement.instrument.smuX.event measurementRegister = status.measurement.instrument.smuX.ntr measurementRegister = status.measurement.instrument.smuX.ptr status.measurement.instrument.smuX.enable = measurementRegister status.measurement.instrument.smuX.ntr = measurementRegister status.measurement.instrument.smuX.ptr = measurementRegister measurementRegister The status of the instrument measurement status SMU X summary register; a zero (0) indicates no bits set (also send 0 to clear all bits);...
  • Page 656 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Value Description status.measurement.instrument.smuX.VOLTAGE_LIMIT Set bit indicates that the status.measurement.instrument.smuX.VLMT voltage limit was exceeded. Bit B0 decimal value: 1 status.measurement.instrument.smuX.CURRENT_LIMIT Set bit indicates that the status.measurement.instrument.smuX.ILMT current limit was exceeded.
  • Page 657 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual status.measurement.reading_overflow.* This attribute contains the measurement event reading overflow summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW) Status reset...
  • Page 658 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference As an example, to set bit B1 of the measurement event reading overflow summary enable register, set status.measurement.reading_overflow.enable = status.measurement.reading_overflow.SMUA. In addition to the above constants, measurementRegister can be set to the numeric equivalent of the bit to set.
  • Page 659 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Value Description Not used Not applicable. status.measurement.voltage_limit.SMUA Set bit indicates the enabled VLMT bit for the SMU A measurement register is set. Bit B1 decimal value: 2 Binary value: 0000 0010 status.measurement.voltage_limit.SMUB Set bit indicates the enabled VLMT bit for the SMU B measurement register is set.
  • Page 660 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference > > > > > > * Least significant bit ** Most significant bit Assigning a value to this attribute enables one or more status events. When an enabled status event occurs, a summary bit is set in the appropriate system summary register.
  • Page 661 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Binary value Decimal Weights Example 1 nodeEnableRegister = status.MSB + status.OSB status.node_enable = nodeEnableRegister Use constants to set the MSB and OSB bits of the system node enable register. Example 2 -- decimal 129 = binary 10000001 nodeEnableRegister = 129...
  • Page 662 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference The returned value can indicate one or more status events occurred. Value and description status.MEASUREMENT_SUMMARY_BIT status.MSB Set summary bit indicates that an enabled measurement event has occurred. Bit B0 decimal value: 1 Not used status.ERROR_AVAILABLE status.EAV...
  • Page 663 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Also see Status byte and service request (SRQ) (on page 10-14) status.condition (on page 15-273) status.system.* (on page 15-342) status.operation.* These attributes manage the operation status register set of the status model. Type TSP-Link accessible Affected by...
  • Page 664 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Value and description status.operation.CALIBRATING status.operation.CAL Set bit indicates that the summary bit of the status.operation.calibrating register has been set. Bit B0 decimal value: 1 Not used B1 to B2 status.operation.SWEEPING status.operation.SWE Set bit indicates that the summary bit from the status.operation.sweeping register is set.
  • Page 665 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Binary value Decimal Weights Binary value 32,768 16,384 8,192 4,096 2,048 1,024 Decimal Weights Example 1 operationRegister = status.operation.USER + status.operation.PROG status.operation.enable = operationRegister Uses constants to set the USER and PROG bits of the operation status enable register. Example 2 -- decimal 20480 = binary 0101 0000 0000 0000 operationRegister = 20480...
  • Page 666 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details These attributes are used to read or write to the operation status calibration summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set.
  • Page 667 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Usage operationRegister = status.operation.instrument.condition operationRegister = status.operation.instrument.enable operationRegister = status.operation.instrument.event operationRegister = status.operation.instrument.ntr operationRegister = status.operation.instrument.ptr status.operation.instrument.enable = operationRegister status.operation.instrument.ntr = operationRegister status.operation.instrument.ptr = operationRegister operationRegister The status of the operation event register; a zero (0) indicates no bits set (also send 0 to clear all bits);...
  • Page 668 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Value Description status.operation.instrument.DIGITAL_IO Set bit indicates one or more status.operation.instrument.DIGIO enabled bits for the operation status digital I/O summary register is set. Bit B12 decimal value: 4,096 status.operation.instrument.TSPLINK Set bit indicates one or more enabled bits for the operation status TSP-Link summary register is set.
  • Page 669 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Also see Operation Status Registers (on page 10-7) status.operation.* (on page 15-290) Condition register sets of: • status.operation.instrument.digio.* (on page 15-296) • status.operation.instrument.lan.* (on page 15-299) • status.operation.instrument.trigger_blender.* (on page 15-308) •...
  • Page 670 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Value and description Not used B0 to B9 status.operation.instrument.digio.TRIGGER_OVERRUN status.operation.instrument.digio.TRGOVR Set bit indicates an enabled bit in the Operation Status Digital I/O Overrun Register is set. Bit B10 decimal value: 1,024 Binary value: 0100 0000 0010 B11 to B15 Not used In addition to the above constant, operationRegister can be set to the decimal value of the bit...
  • Page 671 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details These attributes are used to read or write to the operation status digital I/O overrun registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set.
  • Page 672 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal values.
  • Page 673 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Usage operationRegister = status.operation.instrument.lan.condition operationRegister = status.operation.instrument.lan.enable operationRegister = status.operation.instrument.lan.event operationRegister = status.operation.instrument.lan.ntr operationRegister = status.operation.instrument.lan.ptr status.operation.instrument.lan.enable = operationRegister status.operation.instrument.lan.ntr = operationRegister status.operation.instrument.lan.ptr = operationRegister operationRegister The status of the operation status LAN summary register; a zero (0) indicates no bits set (also send 0 to clear all bits);...
  • Page 674 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal weights.
  • Page 675 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Usage operationRegister = status.operation.instrument.lan.trigger_overrun.condition operationRegister = status.operation.instrument.lan.trigger_overrun.enable operationRegister = status.operation.instrument.lan.trigger_overrun.event operationRegister = status.operation.instrument.lan.trigger_overrun.ntr operationRegister = status.operation.instrument.lan.trigger_overrun.ptr status.operation.instrument.lan.trigger_overrun.enable = operationRegister status.operation.instrument.lan.trigger_overrun.ntr = operationRegister status.operation.instrument.lan.trigger_overrun.ptr = operationRegister operationRegister The status of the operation status LAN trigger overrun register; a zero (0) indicates no bits set (also send 0 to clear all bits);...
  • Page 676 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference As an example, to set bit B1 of the operation status LAN trigger overrun enable register, set status.operation.instrument.lan.trigger_overrun.enable = status.operation.instrument.lan.trigger_overrun.LAN1. In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set.
  • Page 677 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Usage operationRegister = status.operation.instrument.smuX.condition operationRegister = status.operation.instrument.smuX.enable operationRegister = status.operation.instrument.smuX.event operationRegister = status.operation.instrument.smuX.ntr operationRegister = status.operation.instrument.smuX.ptr status.operation.instrument.smuX.enable = operationRegister status.operation.instrument.smuX.ntr = operationRegister status.operation.instrument.smuX.ptr = operationRegister operationRegister The status of the operation status SMU X summary register; a zero (0) indicates no bits set (also send 0 to clear all bits);...
  • Page 678 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Value and description status.operation.instrument.smuX.TRIGGER_OVERRUN status.operation.instrument.smuX.TRGOVR Set bit indicates an enabled bit has been set in the operation status smuX trigger overrun event register. Bit B10 decimal value: 1,024 B11 to B15 Not used As an example, to set bit B0 of the operation status SMU A summary enable register, set status.operation.instrument.smua.enable =...
  • Page 679 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual status.operation.instrument.smuX.trigger_overrrun.* This attribute contains the operation status SMU X trigger overrun register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW) Status reset...
  • Page 680 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Value and description Not used status.operation.instrument.smuX.trigger_overrun.ARM Set bit indicates that the arm event detector of the SMU was already in the detected state when a trigger was received. Bit B1 decimal value: 2 status.operation.instrument.smuX.trigger_overrun.SRC Set bit indicates that the source event detector of the SMU was already in the detected state...
  • Page 681 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Also see Operation Status Registers (on page 10-7) status.operation.instrument.smuX.* (on page 15-303) status.operation.instrument.trigger_blender.* This attribute contains the operation status trigger blender summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute...
  • Page 682 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set. For example, to set bit B10, set operationRegister to 1024. Example status.operation.instrument.trigger_blender.enable = 1024 Uses a decimal value to set the TRGOVR bit of the operation status trigger blender summary enable.
  • Page 683 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual > > > > > > > > > > > > > > * Least significant bit ** Most significant bit A set bit value indicates that the specified trigger blender generated an action overrun. For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents...
  • Page 684 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Example status.operation.instrument.trigger_blender.trigger_overrun.enable = status.operation.instrument.trigger_blender.trigger_overrun.BLND1 Uses the constant to set the bit for blender 1 of the operation status trigger blender overrun enable register. Example status.operation.instrument.trigger_blender.trigger_overrun.enable = 18 Uses the decimal value to set the bits for blenders 1 and 4 of the operation status trigger blender overrun enable register.
  • Page 685 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Value and description Not used B0 to B9 status.operation.instrument.trigger_timer.TRIGGER_OVERRUN status.operation.instrument.trigger_timer.TRGOVR Set bit indicates one or more enabled bits for the operation status trigger timer overrun register is set. Bit B10 decimal value: 1,024 Binary value: 0100 0000 0000...
  • Page 686 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Usage operationRegister = status.operation.instrument.trigger_timer.trigger_overrun.condition operationRegister = status.operation.instrument.trigger_timer.trigger_overrun.enable operationRegister = status.operation.instrument.trigger_timer.trigger_overrun.event operationRegister = status.operation.instrument.trigger_timer.trigger_overrun.ntr operationRegister = status.operation.instrument.trigger_timer.trigger_overrun.ptr status.operation.instrument.trigger_timer.trigger_overrun.enable = operationRegister status.operation.instrument.trigger_timer.trigger_overrun.ntr = operationRegister status.operation.instrument.trigger_timer.trigger_overrun.ptr = operationRegister operationRegister The status of the operation status trigger timer trigger overrun register;...
  • Page 687 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Value Decimal value Not used applicable status.operation.instrument.trigger_timer.trigger_overrun.TMR1 status.operation.instrument.trigger_timer.trigger_overrun.TMR2 status.operation.instrument.trigger_timer.trigger_overrun.TMR3 status.operation.instrument.trigger_timer.trigger_overrun.TMR4 status.operation.instrument.trigger_timer.trigger_overrun.TMR5 status.operation.instrument.trigger_timer.trigger_overrun.TMR6 status.operation.instrument.trigger_timer.trigger_overrun.TMR7 status.operation.instrument.trigger_timer.trigger_overrun.TMR8 B9 to B15 Not used applicable As an example, to set bit B1 of the operation status trigger timer trigger overrun enable register, set status.operation.instrument.trigger_timer.trigger_overrun.enable = status.operation.instrument.trigger_timer.trigger_overrun.TMR1.
  • Page 688 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference status.operation.instrument.tsplink.* This attribute contains the operation status TSP-Link summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW) Status reset Not saved...
  • Page 689 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Also see Operation Status Registers (on page 10-7) status.operation.instrument.tsplink.trigger_overrun.* (on page 15-316) status.operation.instrument.tsplink.trigger_overrun.* This attribute contains the operation status TSP-Link overrun register set. Type TSP-Link accessible Affected by Where saved Default value Attribute...
  • Page 690 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Value Decimal value Not used Not applicable status.operation.instrument.tsplink.trigger_overrun.LINE1 status.operation.instrument.tsplink.trigger_overrun.LINE2 status.operation.instrument.tsplink.trigger_overrun.LINE3 Not used Not applicable B4 to B15 As an example, to set bit B1 of the operation status TSP-Link overrun enable register, set status.operation.instrument.tsplink.trigger_overrun.enable = status.operation.instrument.tsplink.trigger_overrun.LINE1.
  • Page 691 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual status.operation.measuring.* This attribute contains the operation status measuring summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW) Status reset Not saved...
  • Page 692 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference As an example, to set bit B1 of the operation status measuring summary enable register, set status.operation.measuring.enable = status.operation.measuring.SMUA. In addition to the above constants, operationRegister can be set to the numeric equivalent of the bit to set.
  • Page 693 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Value and description Not used status.operation.remote.COMMAND_AVAILABLE status.operation.remote.CAV Set bit indicates there is a command available in the execution queue. Bit B1 decimal value: 2 Binary value: 0000 0000 0000 0010 Not used B2 to B10 status.operation.remote.PROMPTS_ENABLED...
  • Page 694 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Usage operationRegister = status.operation.sweeping.condition operationRegister = status.operation.sweeping.enable operationRegister = status.operation.sweeping.event operationRegister = status.operation.sweeping.ntr operationRegister = status.operation.sweeping.ptr status.operation.sweeping.enable = operationRegister status.operation.sweeping.ntr = operationRegister status.operation.sweeping.ptr = operationRegister operationRegister The status of the operation status sweeping summary register; a zero (0) indicates no bits set (also send 0 to clear all bits);...
  • Page 695 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual status.operation.trigger_overrun.* This attribute contains the operation status trigger overrun summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW) Status reset...
  • Page 696 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Value Description Not used Not applicable. status.operation.trigger_overrun.SMUA Set bit indicates one of the enabled bits in the operation status SMU A trigger overrun event register is set. Bit B1 decimal value: 2 status.operation.trigger_overrun.SMUB Set bit indicates one of the enabled bits in the operation...
  • Page 697 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Binary value Decimal Weights Binary value 32,768 16,384 8,192 4,096 2,048 1,024 Decimal Weights Example operationRegister = status.operation.trigger_overrun.SMUA + status.operation.trigger_overrun.TRGBLND status.operation.trigger_overrun.enable = operationRegister Uses constants to set bit B1 and bit B10 of the operation status trigger overrun summary enable register. Also see Operation Status Registers (on page 10-7)
  • Page 698 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details These attributes are used to read or write to the operation status user registers. Reading a status register returns a value. The binary equivalent of the value indicates which register bits are set. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15.
  • Page 699 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Binary value Decimal Weights Binary value 32,768 16,384 8,192 4,096 2,048 1,024 Decimal Weights Example 1 operationRegister = status.operation.user.BIT11 + status.operation.user.BIT14 status.operation.user.enable = operationRegister Uses constants to set bits B11 and B14 of the operation status user enable register. Example 2 -- 18432 = binary 0100 1000 0000 0000 operationRegister = 18432...
  • Page 700 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details These attributes are used to read or write to the questionable status registers. Reading a status register returns a value. In the binary equivalent, the least significant bit is bit B0, and the most significant bit is bit B15.
  • Page 701 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Binary value Decimal Weights Binary value 32,768 16,384 8,192 4,096 2,048 1,024 Decimal Weights Example status.questionable.enable = status.questionable.OTEMP Uses a constant to set the OTEMP bit of the questionable status enable register. Also see Questionable Status Registers (on page 10-12)
  • Page 702 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details These attributes are used to read or write to the questionable status calibration summary registers. Reading a status register returns a value. The binary equivalent of the returned value indicates which register bits are set.
  • Page 703 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual status.questionable.instrument.* This attribute contains the questionable status instrument summary register set. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable Not saved Not applicable .enable (RW) Status reset Not saved...
  • Page 704 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference In addition to the above constants, questionableRegister can be set to the numeric equivalent of the bit to set. To set more than one bit of the register, set operationRegister to the sum of their decimal weights.
  • Page 705 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual > > > > > > > > > > > > > > * Least significant bit ** Most significant bit For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 10-1) and...
  • Page 706 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Example questionableRegister = status.questionable.instrument.smua.CAL + status.questionable.instrument.smua.UO status.questionable.instrument.smua.enable = questionableRegister Uses constants to set bit B8 and bit B9 of the questionable status SMU A summary enable register. Also see Questionable Status Registers (on page 10-12) status.operation.*...
  • Page 707 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Value Description Not used Not applicable. status.questionable.over_temperature.SMUA Set bit indicates that an over temperature condition was detected on SMU A. Bit B1 decimal value: 2 Binary value: 0000 0010 status.questionable.over_temperature.SMUB Set bit indicates that an over temperature condition was detected on SMU B.
  • Page 708 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Usage questionableRegister = status.questionable.unstable_output.condition questionableRegister = status.questionable.unstable_output.enable questionableRegister = status.questionable.unstable_output.event questionableRegister = status.questionable.unstable_output.ntr questionableRegister = status.questionable.unstable_output.ptr status.questionable.unstable_output.enable = questionableRegister status.questionable.unstable_output.ntr = questionableRegister status.questionable.unstable_output.ptr = questionableRegister operationRegister The status of the questionable status unstable output summary register; a zero (0) indicates no bits set (also send 0 to clear all bits);...
  • Page 709 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Also see Questionable Status Registers (on page 10-12) status.questionable.* (on page 15-326) status.request_enable This attribute stores the service request (SRQ) enable register. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Status reset...
  • Page 710 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Value Description status.MESSAGE_AVAILABLE Set summary bit indicates that a response message status.MAV is present in the Output Queue. Bit B4 decimal value: 16 status.EVENT_SUMMARY_BIT Set summary bit indicates that an enabled event in status.ESB the Standard Event Status Register has occurred.
  • Page 711 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual status.request_event This attribute stores the service request (SRQ) event register. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not saved Usage requestSRQEventRegister = status.request_event requestSRQEventRegister The status of the request event register;...
  • Page 712 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Value Description Not used Not applicable status.OPERATION_SUMMARY_BIT Set summary bit indicates that an enabled event in status.OSB the Operation Status Register has occurred. Bit B7 decimal value: 128 In addition to the above constants, requestEventRegister can be set to the decimal equivalent of the bits set.
  • Page 713 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Also see Status model (on page 10-1) status.standard.* These attributes manage the standard event status register set of the status model. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R)
  • Page 714 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Value status.standard.OPERATION_COMPLETE status.standard.OPC Set bit indicates that all pending selected instrument operations are completed and the instrument is ready to accept new commands. The bit is set in response to an *OPC command. The opc() function can be used in place of the *OPC command.
  • Page 715 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Example 1 standardRegister = status.standard.OPC + status.standard.EXE status.standard.enable = standardRegister Uses constants to set the OPC and EXE bits of the standard event status enable register. Example 2 -- decimal 17 = binary 0001 0001 standardRegister = 17 status.standard.enable = standardRegister...
  • Page 716 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference > > > > > > > > > > > > > > * Least significant bit ** Most significant bit For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 10-1) and...
  • Page 717 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Binary value Decimal Weights Binary value 32,768 16,384 8,192 4,096 2,048 1,024 Decimal Weights Example 1 enableRegister = status.system.NODE11 + status.system.NODE14 status.system.enable = enableRegister Uses constants to set bits B11 and B14 of the system summary enable register. Example 2 -- decimal 18432 = binary 0100 1000 0000 0000 enableRegister = 18432...
  • Page 718 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Usage enableRegister = status.system2.condition enableRegister = status.system2.enable enableRegister = status.system2.event enableRegister = status.system2.ntr enableRegister = status.system2.ptr status.system2.enable = enableRegister status.system2.ntr = enableRegister status.system2.ptr = enableRegister enableRegister The status of the system summary 2 register; a zero (0) indicates no bits set; other values indicate various bit settings Details In an expanded system (TSP-Link), these attributes are used to read or write to the system summary...
  • Page 719 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Value Decimal value status.system2.NODE28 16,384 Not used Not applicable As an example, to set bit B0 of the system summary 2 enable register, set status.system2.enable = status.system2.EXT. In addition to the above constants, enableRegister can be set to the decimal value of the bit to set.
  • Page 720 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference status.system3.* ® These attributes manage the TSP-Link system summary register of the status model for nodes 29 through 42. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable...
  • Page 721 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Value Decimal value status.system3.NODE33 status.system3.NODE34 status.system3.NODE35 status.system3.NODE36 status.system3.NODE37 status.system3.NODE38 1,024 status.system3.NODE39 2,048 status.system3.NODE40 4,096 status.system3.NODE41 8,192 status.system3.NODE42 16,384 Not used Not applicable As an example, to set bit B0 of the system summary 3 enable register, set status.system3.enable = status.system3.EXT.
  • Page 722 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference status.system4.* ® These attributes manage the TSP-Link system summary register of the status model for nodes 43 through 56. Type TSP-Link accessible Affected by Where saved Default value Attribute .condition (R) Not applicable...
  • Page 723 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Value Decimal value status.system4.EXTENSION_BIT status.system4.EXT status.system4.NODE43 status.system4.NODE44 status.system4.NODE45 status.system4.NODE46 status.system4.NODE47 status.system4.NODE48 status.system4.NODE49 status.system4.NODE50 status.system4.NODE51 status.system4.NODE52 1,024 status.system4.NODE53 2,048 status.system4.NODE54 4,096 status.system4.NODE55 8,192 status.system4.NODE56 16,384 Not used Not applicable As an example, to set bit B0 of the system summary 4 enable register, set status.system4.enable = status.system4.enable.EXT.
  • Page 724 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Example 2 -- decimal 18432 = binary 0100 1000 0000 0000 enableRegister = 18432 status.system4.enable = enableRegister Uses a decimal value to set bit B11 and bit B14 of the system summary 4 enable register. Also see status.system3.* (on page 15-347)
  • Page 725 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual For information about .condition, .enable, .event, .ntr, and .ptr registers, refer to Status register set contents (on page 10-1) and Enable and transition registers (on page 10-18). The individual bits of this register are defined in the following table.
  • Page 726 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Also see status.system4.* (on page 15-349) System summary and standard event registers (on page 10-5) SweepILinMeasureV() This KISweep factory script function performs a linear current sweep with voltage measured at every step (point). Type TSP-Link accessible Affected by...
  • Page 727 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Example SweepILinMeasureV(smua, -1e-3, 1e-3, 0, 100) This function performs a 100-point linear current sweep starting at −1 mA and stopping at +1 mA. Voltage is measured at every step (point) in the sweep. Because stime is set for 0 s, voltage is measured as quickly as possible after each current step.
  • Page 728 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference SweepILogMeasureV() This KISweep factory script function performs a logarithmic current sweep with voltage measured at every step (point). Type TSP-Link accessible Affected by Where saved Default value Function Usage SweepILogMeasureV(smuX, starti, stopi, stime, points) Source-measure unit (SMU) channel (for example, smua.reset() applies to SMU...
  • Page 729 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Figure 146: SweepILogMeasureV() Example SweepILogMeasureV(smua, 0.01, 0.1, 0.001, 5) This function performs a five-point linear current sweep starting at 10 mA and stopping at 100 mA. Voltage is measured at every step (point) in the sweep.
  • Page 730 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details Data for current measurements, voltage source values, and timestamps are stored in smuX.nvbuffer1. If all parameters are omitted when this function is called, this function is executed with the parameters set to the default values.
  • Page 731 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual SweepVListMeasureI() This KISweep factory script function performs a voltage list sweep with current measured at every step (point). Type TSP-Link accessible Affected by Where saved Default value Function Usage SweepVListMeasureI(smuX, vlist, stime, points) Source-measure unit (SMU) channel (for example, smua.reset() applies to SMU...
  • Page 732 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference SweepVLogMeasureI() This KISweep factory script function performs a logarithmic voltage sweep with current measured at every step (point). Type TSP-Link accessible Affected by Where saved Default value Function Usage SweepVLogMeasureI(smuX, startv, stopv, stime, points) Source-measure unit (SMU) channel (for example, smua applies to SMU channel A)
  • Page 733 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Figure 148: SweepVLogMeasureI() Example SweepVLogMeasureI(smua, 1, 10, 0.001, 5) This function performs a five-point logarithmic voltage sweep starting at 1 V and stopping at 10 V. Current is measured at every step (point) in the sweep after a 1 ms source settling period.
  • Page 734 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Example 2 beeper.enable = beeper.ON beeper.beep(0.5, 2400) print("reset timer") timer.reset() delay(0.5) dt = timer.measure.t() print("timer after delay:", dt) beeper.beep(0.5, 2400) Enable the beeper. Emit a beep and set the beeper. Reset the timer.
  • Page 735 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual trigger.blender[N].clear() This function clears the blender event detector and resets the overrun indicator of blender N. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.blender[N].clear() The blender number (up to six) Details This command sets the blender event detector to the undetected state and resets the overrun...
  • Page 736 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference trigger.blender[N].orenable This attribute selects whether the blender performs OR operations or AND operations. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved false (AND mode) Trigger blender N reset Recall setup...
  • Page 737 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details Indicates if an event was ignored because the event detector was already in the detected state when the event occurred. This is an indication of the state of the event detector that is built into the event blender itself.
  • Page 738 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference trigger.blender[N].stimulus[M] This attribute specifies the events that trigger the blender. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script trigger.EVENT_NONE Instrument reset Power cycle Trigger blender N reset Usage...
  • Page 739 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Trigger event IDs* Event ID Event description trigger.generator[N].EVENT_ID Occurs when the trigger.generator[N].assert() function is executed * Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).
  • Page 740 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Also see trigger.blender[N].clear() (on page 15-362) trigger.clear() This function clears the command interface trigger event detector. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.clear() Details The trigger event detector indicates if a trigger event has been detected since the last trigger.wait() call.
  • Page 741 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual trigger.generator[N].assert() This function generates a trigger event. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.generator[N].assert() The generator number (1 or 2) Details Use this function to directly trigger events from the command interface or a script. For example, you can trigger a sweep while the instrument is under script control.
  • Page 742 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference trigger.timer[N].clear() This function clears the timer event detector and overrun indicator for the specified trigger timer number. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.timer[N].clear() Trigger timer number (1 to 8) Details...
  • Page 743 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Also see trigger.timer[N].clear() (on page 15-369) trigger.timer[N].delay (on page 15-370) trigger.timer[N].reset() (on page 15-373) trigger.timer[N].delay This attribute sets and reads the timer delay. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)
  • Page 744 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference trigger.timer[N].delaylist This attribute sets an array of timer intervals. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved 10e-6 (10 µs) Recall setup Trigger timer N reset Usage intervals = trigger.timer[N].delaylist...
  • Page 745 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual trigger.timer[N].EVENT_ID This constant specifies the trigger timer event number. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = trigger.timer[N].EVENT_ID eventID The trigger event number Trigger timer number (1 to 8) Details This constant is an identification number that identifies events generated by this timer.
  • Page 746 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Example print(trigger.timer[1].overrun) If an event was ignored, the output is true. If the event was not ignored, the output is false. Also see trigger.timer[N].reset() (on page 15-373) trigger.timer[N].passthrough This attribute enables or disables the timer trigger pass-through mode.
  • Page 747 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details The trigger.timer[N].reset() function resets the following attributes to their factory defaults: ▪ trigger.timer[N].count ▪ trigger.timer[N].delay ▪ trigger.timer[N].delaylist ▪ trigger.timer[N].passthrough ▪ trigger.timer[N].stimulus It also clears trigger.timer[N].overrun. Example trigger.timer[1].reset() Resets the attributes associated with timer 1 back to factory default values.
  • Page 748 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details The eventID parameter may be one of the trigger event IDs shown in the following table. Trigger event IDs* Event ID Event description smuX.trigger.SWEEPING_EVENT_ID Occurs when the source-measure unit (SMU) transitions from the idle state to the arm layer of the trigger model smuX.trigger.ARMED_EVENT_ID...
  • Page 749 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual trigger.timer[N].wait() This function waits for a trigger. Type TSP-Link accessible Affected by Where saved Default value Function Usage triggered = trigger.timer[N].wait(timeout) triggered Trigger detection indication Trigger timer number (1 to 8) timeout Maximum amount of time in seconds to wait for the trigger Details...
  • Page 750 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details This function waits up to timeout seconds for a trigger on the active command interface. A command interface trigger occurs when: • A USBTMC TRIGGER message is received (USB only) •...
  • Page 751 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual tsplink.master This attribute reads the node number assigned to the master node. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage masterNodeNumber = tsplink.master masterNodeNumber...
  • Page 752 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference tsplink.readbit() This function reads the state of a TSP-Link synchronization line. Type TSP-Link accessible Affected by Where saved Default value Function Usage data = tsplink.readbit(N) data The state of the synchronization line The trigger line (1 to 3) Details Returns a value of zero (0) if the line is low and 1 if the line is high.
  • Page 753 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Example data = tsplink.readport() print(data) Reads state of all three TSP-Link lines. Assuming line 2 is set high, the output is: 2.000000e+00 (binary 010) The format of the output may vary depending on the ASCII precision setting. Also see TSP-Link trigger lines (on page 7-41)
  • Page 754 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Also see localnode.showerrors (on page 15-161) tsplink.node (on page 15-378) tsplink.state (on page 15-381) tsplink.state This attribute describes the TSP-Link online state. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable...
  • Page 755 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Also see tsplink.trigger[N].clear() (on page 15-382) tsplink.trigger[N].mode (on page 15-383) tsplink.trigger[N].overrun (on page 15-385) tsplink.trigger[N].pulsewidth (on page 15-386) tsplink.trigger[N].release() (on page 15-386) tsplink.trigger[N].stimulus (on page 15-388) tsplink.trigger[N].wait() (on page 15-389) tsplink.trigger[N].clear() This function clears the event detector for a LAN trigger.
  • Page 756 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference tsplink.trigger[N].EVENT_ID This constant identifies the number that is used for the trigger events. Type TSP-Link accessible Affected by Where saved Default value Constant Usage eventID = tsplink.trigger[N].EVENT_ID eventID The trigger event number The trigger line (1 to 3) Details...
  • Page 757 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Mode Number Description value tsplink.TRIG_BYPASS Allows direct control of the line as a digital I/O line. tsplink.TRIG_FALLING Detects falling-edge triggers as input. Asserts a TTL-low pulse for output. tsplink.TRIG_RISING If the programmed state of the line is high, the tsplink.TRIG_RISING mode behaves similarly to...
  • Page 758 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Also see digio.writebit() (on page 15-63) digio.writeport() (on page 15-63) tsplink.trigger[N].assert() (on page 15-381) tsplink.trigger[N].clear() (on page 15-382) tsplink.trigger[N].overrun (on page 15-385) tsplink.trigger[N].release() (on page 15-386) tsplink.trigger[N].reset() (on page 15-387) tsplink.trigger[N].stimulus (on page 15-388) tsplink.trigger[N].wait()
  • Page 759 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual tsplink.trigger[N].pulsewidth This attribute sets the length of time that the trigger line is asserted for output triggers. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved 10e-6 (10 µs)
  • Page 760 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Also see tsplink.trigger[N].assert() (on page 15-381) tsplink.trigger[N].clear() (on page 15-382) tsplink.trigger[N].mode (on page 15-383) tsplink.trigger[N].overrun (on page 15-385) tsplink.trigger[N].pulsewidth (on page 15-386) tsplink.trigger[N].stimulus (on page 15-388) tsplink.trigger[N].wait() (on page 15-389) tsplink.trigger[N].reset() This function resets some of the TSP-Link trigger attributes to their factory defaults.
  • Page 761 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual tsplink.trigger[N].stimulus This attribute specifies the event that causes the synchronization line to assert a trigger. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Instrument reset Not saved Recall setup TSP-Link trigger N reset...
  • Page 762 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Trigger event IDs* Event ID Event description trigger.timer[N].EVENT_ID Occurs when a delay expires trigger.generator[N].EVENT_ID Occurs when the trigger.generator[N].assert() function is executed * Use the name of the trigger event ID to set the stimulus value rather than the numeric value. Using the name makes the code compatible for future upgrades (for example, if the numeric values must change when enhancements are added to the instrument).
  • Page 763 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual tsplink.writebit() This function sets a TSP-Link trigger line high or low. Type TSP-Link accessible Affected by Where saved Default value Function Usage tsplink.writebit(N, data) The trigger line (1 to 3) data The value to write to the bit: ▪...
  • Page 764 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Write-protected lines are not changed. Use the tsplink.writebit() and tsplink.writeport() commands to control the output state of the synchronization line when trigger operation is set to tsplink.TRIG_BYPASS. The reset() function does not affect the present states of the trigger lines. Example tsplink.writeport(3) Sets the synchronization lines 1 and 2 high (binary 011).
  • Page 765 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual tspnet.clear() This function clears any pending output data from the instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage tspnet.clear(connectionID) connectionID The connection ID returned from tspnet.connect() Details This function clears any pending output data from the device.
  • Page 766 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference tspnet.connect() This function establishes a network connection with another LAN instrument or device through the LAN interface. Type TSP-Link accessible Affected by Where saved Default value Function Usage connectionID = tspnet.connect("ipAddress") connectionID = tspnet.connect("ipAddress", portNumber, "initString") connectionID...
  • Page 767 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Example 2 instrumentID = tspnet.connect("192.0.2.1", 1394, "*rst\r\n") if instrumentID then -- Use instrumentID as needed here tspnet.disconnect(instrumentID) Connect to a device that is not TSP-enabled. Also see localnode.prompts (on page 15-158) localnode.showerrors (on page 15-161)
  • Page 768 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference tspnet.execute() This function sends a command string to the remote device. Type TSP-Link accessible Affected by Where saved Default value Function Usage tspnet.execute("connectionID", "commandString") value1 = tspnet.execute("connectionID", "commandString", formatString) value1, value2 = tspnet.execute("connectionID", "commandString", formatString) value1, ..., valueN = tspnet.execute("connectionID", "commandString", formatString) connectionID...
  • Page 769 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Also see tspnet.connect() (on page 15-393) tspnet.read() (on page 15-397) tspnet.termination() (on page 15-399) tspnet.write() (on page 15-404) tspnet.idn() This function retrieves the response of the remote device to *IDN?. Type TSP-Link accessible Affected by...
  • Page 770 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference tspnet.read() This function reads data from a remote device. Type TSP-Link accessible Affected by Where saved Default value Function Usage value1 = tspnet.read(connectionID) value1 = tspnet.read(connectionID, formatString) value1, value2 = tspnet.read(connectionID, formatString) value1, ..., valueN = tspnet.read(connectionID, formatString) value1 The first value decoded from the response message...
  • Page 771 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Also see tspnet.connect() (on page 15-393) tspnet.readavailable() (on page 15-398) tspnet.timeout (on page 15-400) tspnet.write() (on page 15-404) tspnet.readavailable() This function checks to see if data is available from the remote device. Type TSP-Link accessible Affected by...
  • Page 772 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference tspnet.reset() This function disconnects all TSP-Net sessions. Type TSP-Link accessible Affected by Where saved Default value Function Usage tspnet.reset() Details This command disconnects all remote instruments connected through TSP-Net. For TSP-enabled devices, this causes any commands or scripts running remotely to be terminated.
  • Page 773 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Example deviceID = tspnet.connect("192.0.2.1") if deviceID then tspnet.termination(deviceID, tspnet.TERM_LF) Sets termination type for IP address 192.0.2.1 to TERM_LF. Also see tspnet.connect() (on page 15-393) tspnet.disconnect() (on page 15-394) tspnet.timeout This attribute sets the timeout value for the tspnet.connect(), tspnet.execute(), and tspnet.read() commands.
  • Page 774 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference tspnet.tsp.abort() This function causes the TSP-enabled instrument to stop executing any of the commands that were sent to it. Type TSP-Link accessible Affected by Where saved Default value Function Usage tspnet.tsp.abort(connectionID)
  • Page 775 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Example tspnet.tsp.abortonconnect = 0 Configure the instrument so that it does not send an abort command when connecting to a TSP-enabled instrument. Also see tspnet.connect() (on page 15-393) tspnet.tsp.rbtablecopy() This function copies a reading buffer synchronous table from a remote instrument to a TSP-enabled instrument.
  • Page 776 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference tspnet.tsp.runscript() This function loads and runs a script on a remote TSP-enabled instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage tspnet.tsp.runscript(connectionID, "script") tspnet.tsp.runscript(connectionID, "name", "script") connectionID Integer value used as an identifier for other tspnet commands name...
  • Page 777 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual tspnet.write() This function writes a string to the remote instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage tspnet.write(connectionID, "inputString") connectionID The connection ID returned from tspnet.connect() inputString The string to be written Details...
  • Page 778 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference Details This function associates the string value with the string name and stores this key-value pair in nonvolatile memory. Use the userstring.get() function to retrieve the value associated with the specified name. You can use the userstring functions to store custom, instrument-specific information in the instrument, such as department number, asset number, or manufacturing plant location.
  • Page 779 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Example 2 userstring.add("assetnumber", "236") userstring.add("product", "Widgets") userstring.add("contact", "John Doe") for name in userstring.catalog() do print(name .. " = " .. userstring.get(name)) Prints all userstring key-value pairs. Output: product = Widgets assetnumber = 236 contact = John Doe Notice the key-value pairs are not listed in the order they were added.
  • Page 780 Model 2606B System SourceMeter® Instrument Reference Manual Section 15: TSP command reference userstring.get() This function retrieves a user-defined string from nonvolatile memory. Type TSP-Link accessible Affected by Where saved Default value Function Usage value = userstring.get("name") value The value of the user-defined string key-value pair name The name (key) of the user-defined string Details...
  • Page 781 Section 15: TSP command reference Model 2606B System SourceMeter® Instrument Reference Manual Details There are two types of instrument commands: • Overlapped commands: Commands that allow the execution of subsequent commands while instrument operations of the overlapped command are still in progress. •...
  • Page 782 Section 16 Common commands In this section: Common command summary ..........16-1 Script command equivalents ..........16-2 Command reference .............. 16-3 Common command summary The IEEE Std 488.2 common commands that are supported by the 2606B are summarized in the following table.
  • Page 783 Section 16: Common commands Model 2606B System SourceMeter® Instrument Reference Manual Command Name Description *OPC Operation complete Set the Operation Complete bit in the Standard Event Register after all pending commands, including overlapped command commands, have completed. For detailed information, see Operation complete and query: *OPC and *OPC? page 16-3).
  • Page 784 Model 2606B System SourceMeter® Instrument Reference Manual Section 16: Common commands Command reference Details of all common commands (except those associated with the status model) are described below. Status command usage is in the Status model (on page 10-1). Identification query: *IDN? Retrieves the identification string.
  • Page 785 Section 16: Common commands Model 2606B System SourceMeter® Instrument Reference Manual Self-test query: *TST? Requests self-test results. *TST? Places a zero (0) in the output queue This command always places a zero (0) in the output queue. This command is included for common command compatibility only;...
  • Page 786 Section 17 Calibration In this section: Verification ................17-1 Adjustment ................17-12 Verification The information in this section is intended for qualified service personnel only, as described by the types of product users in the Safety precautions pages, provided at the beginning of this document.
  • Page 787 Section 17: Calibration Model 2606B System SourceMeter® Instrument Reference Manual Calibration test requirements Be sure that you perform the calibration tests: • Under the proper environmental conditions. • After the specified warmup period. • Using the correct line voltage. • Using the proper test equipment.
  • Page 788 Model 2606B System SourceMeter® Instrument Reference Manual Section 17: Calibration Recommended verification equipment The following table summarizes recommended maximum allowable test equipment uncertainty for verification points. Total test equipment measurement uncertainty should meet or be less than the listed values at each test point. Generally, test equipment uncertainty should be at least four times better than corresponding 2606B specifications.
  • Page 789 Section 17: Calibration Model 2606B System SourceMeter® Instrument Reference Manual Measurement limit calculations Measurement limits are calculated in the same way as the source limits, except that the limits are calculated with respect to the measurement of the external reference instrument. Restoring factory defaults Before performing the calibration procedures, restore the instrument to its factory defaults.
  • Page 790 Model 2606B System SourceMeter® Instrument Reference Manual Section 17: Calibration Test considerations When performing the calibration procedures: • Be sure to restore factory front panel defaults as described in Restoring factory defaults page 17-4). • Make sure that the test equipment is properly warmed up and connected to the 2606B output terminals.
  • Page 791 Section 17: Calibration Model 2606B System SourceMeter® Instrument Reference Manual Setting the source range and output value Before testing each calibration point, you must properly set the source range and output value. To set the source range and output value: 1.
  • Page 792 Model 2606B System SourceMeter® Instrument Reference Manual Section 17: Calibration Figure 150: Calibration connections for 3 A current range 2. Select the multimeter dc current measuring function. 3. Select the single-channel display mode. 4. Press the SRC key to source current and make sure the source output is turned on. 5.
  • Page 793 Section 17: Calibration Model 2606B System SourceMeter® Instrument Reference Manual 6. Repeat the procedure for negative output currents with the same magnitudes as those listed. 7. Turn the output off, and change connections as shown in the figure titled “Connections for 3 A current range,”...
  • Page 794 Model 2606B System SourceMeter® Instrument Reference Manual Section 17: Calibration 6. Repeat the procedure for negative calibrator currents with the same magnitudes as those listed. Current measurement accuracy limits Source and measure range Source current Current reading limits (1 year, 18 °C to 28 °C) 100 nA 90.000 nA 89.855 nA to 90.145 nA...
  • Page 795 Section 17: Calibration Model 2606B System SourceMeter® Instrument Reference Manual Figure 151: Connections for voltage verification and adjustment 2. Set the multimeter measuring function to dc volts. 3. Select the single-channel display mode. 4. Press the SRC key to source voltage and make sure the source output is turned on. 5.
  • Page 796 Model 2606B System SourceMeter® Instrument Reference Manual Section 17: Calibration Voltage measurement accuracy To perform this test, you set the source voltage, as measured by a precision digital multimeter, and then verify that the 2606B voltage readings are within required limits. To verify that the 2606B voltage measurement accuracy is within specified limits: 1.
  • Page 797 Section 17: Calibration Model 2606B System SourceMeter® Instrument Reference Manual Adjustment The information in this topic is intended only for qualified service personnel. Some of the procedures may expose you to hazardous voltages that could result in personal injury or death.
  • Page 798 Model 2606B System SourceMeter® Instrument Reference Manual Section 17: Calibration Warmup period Allow the 2606B to warm up for at least two hours before adjusting the instrument. If the instrument has been subjected to temperature extremes (those outside the ranges stated above), allow additional time for the internal temperature of the instrument to stabilize.
  • Page 799 Section 17: Calibration Model 2606B System SourceMeter® Instrument Reference Manual Adjustment cycle Perform an adjustment at least once a year to make sure the instrument meets or exceeds its specifications. Recommended adjustment equipment The table below contains the recommended equipment for the calibration adjustment procedures. You can use alternate equipment as long as that equipment has specifications equal to or greater than those listed in the table.
  • Page 800 Model 2606B System SourceMeter® Instrument Reference Manual Section 17: Calibration Calibration adjustment overview The following topics contain an overview of the entire calibration adjustment procedure. Parameter values The full-scale parameters are 90 percent of full-scale as indicated (see the table in Step sequence page 17-15)).
  • Page 801 Section 17: Calibration Model 2606B System SourceMeter® Instrument Reference Manual Adjustment steps Function Adjustment steps Calibration points Sense mode smuX.SENSE_LOCAL Voltage Source 100 mV ±1e-30, ±90 mV smuX.SENSE_REMOTE and Measure 100 mV ±1e-30, ±90 mV smuX.SENSE_LOCAL ±1e-30, ±0.9 V smuX.SENSE_CALA ±1e-30, ±0.9 V smuX.SENSE_LOCAL ±1e-30, ±5.4 V...
  • Page 802 Model 2606B System SourceMeter® Instrument Reference Manual Section 17: Calibration Calibration commands Description Command calstate = smuX.cal.state Request calibration state: smuX.CALSTATE_CALIBRATING smuX.CALSTATE_LOCKED smuX.CALSTATE_UNLOCKED smuX.cal.unlock("password") Unlock calibration (default password: KI0026XX) smuX.measure.calibratei(range, Adjust current measurement range calibration*: cp1Measured, cp1Reference, ±range (measurement range to adjust). cp2Measured, cp2Reference) cp1Measured (2606B measured value for calibration point 1).
  • Page 803 Section 17: Calibration Model 2606B System SourceMeter® Instrument Reference Manual Calibration commands Description Command smuX.contact.calibratelo( Adjust the low/sense low contact check measurement cp1Measured, cp1Reference, calibration. cp2Measured, cp2Reference) cp1Measured (value measured by SMU for calibration point 1). cp1Reference (reference measurement for calibration point 1).
  • Page 804 Model 2606B System SourceMeter® Instrument Reference Manual Section 17: Calibration Voltage calibration adjustment 1. Connect the 2606B SMU to the digital multimeter using the 4-wire connections shown in the figure below. Figure 152: Connections for voltage verification and adjustment 2. Select the multimeter dc volts function. 3.
  • Page 805 Section 17: Calibration Model 2606B System SourceMeter® Instrument Reference Manual 1. Select the range being calibrated with this command: smua.source.rangev = range 2. Select the correct sense mode based on the calibration step for the voltage source and measure function from the Step sequence (on page 17-15), for example: smua.sense = smua.SENSE_LOCAL...
  • Page 806 Model 2606B System SourceMeter® Instrument Reference Manual Section 17: Calibration 12. If this step is not on the CALA sense mode, send the measure calibration command using the multimeter and 2606B readings, and the range setting for the parameters. For example: smua.measure.calibratev(range, Z_rdg, DMM_Z_rdg, FS_rdg, DMM_FS_rdg) Where: range...
  • Page 807 Section 17: Calibration Model 2606B System SourceMeter® Instrument Reference Manual 21. Send the source calibration command using the range, -zero and -FS multimeter readings, and -zero and -FS source values for the parameters: smua.source.calibratev(-range, src_Z, DMM_Z_rdg, src_FS, DMM_FS_rdg) Where: -range = The negative of the present calibration range src_Z = The -zero 2606B programmed source output value...
  • Page 808 Model 2606B System SourceMeter® Instrument Reference Manual Section 17: Calibration Current calibration adjustment 1. Connect the 2606B SMU to the digital multimeter (see the following figure), and then select the multimeter dc current function. Figure 153: Calibration connections for 100 nA to 1 A current ranges 2.
  • Page 809 Section 17: Calibration Model 2606B System SourceMeter® Instrument Reference Manual 4. Turn on the output: smua.source.output = smua.OUTPUT_ON 5. Allow the readings to settle, then get both the multimeter and 2606B current readings at the positive zero value (the 2606B measurement is not necessary if this calibration step is being done on the CALA sense mode).
  • Page 810 Model 2606B System SourceMeter® Instrument Reference Manual Section 17: Calibration 12. If this step is not on the CALA sense mode, send the measure calibration command using the multimeter and 2606B readings, and range setting for the parameters: smua.measure.calibratei(range, Z_rdg, DMM_Z_rdg, FS_rdg, DMM_FS_rdg) Where: range = The present calibration range...
  • Page 811 Section 17: Calibration Model 2606B System SourceMeter® Instrument Reference Manual 21. Send the source calibration command using the -range, -zero and -FS multimeter readings, and -zero and -FS source values for the parameters: smua.source.calibratei(-range, src_Z, DMM_Z_rdg, src_FS, DMM_FS_rdg) Where: -range = The negative of the present calibration range src_Z = The zero 2606B source output value...
  • Page 812 Model 2606B System SourceMeter® Instrument Reference Manual Section 17: Calibration 24. Select the DMM dc volts function. 25. Repeat the above steps for the 3 A range. Compute the current reading from the DMM voltage reading and characterized 0.5 Ω resistance value: I = V/R. 26.
  • Page 813 Section 17: Calibration Model 2606B System SourceMeter® Instrument Reference Manual Figure 156: Connections for contact check 50 ohm calibration 5. Allow the readings to settle, then get the 2606B readings: r50_hi, r50_lo = smua.contact.r() 6. Send the contact check low calibration adjustment command: smua.contact.calibratelo(r0_lo, Z_actual, r50_lo, 50_ohm_actual) Where: r0_lo...
  • Page 814 Model 2606B System SourceMeter® Instrument Reference Manual Section 17: Calibration Program calibration dates Use the following command to set the calibration adjustment date: smua.cal.adjustdate = os.time{year=2017, month=12, day=1} Optionally, it is possible to set the calibration date and calibration due date with the following commands: smua.cal.date = os.time{year=2017, month=12, day=1} smua.cal.due = os.time{year=2018, month=12, day=1}...
  • Page 815 Section 18 Frequently asked questions In this section: How do I find the serial number? ..........18-1 How do I optimize performance? ..........18-2 How do I upgrade the firmware? ..........18-2 How do I use the digital I/O port? ........... 18-3 How do I trigger other instruments? ........
  • Page 816 Section 18: Frequently asked questions Model 2606B System SourceMeter® Instrument Reference Manual How do I optimize performance? The primary factors that affect measurement accuracy and speed are: • Warm-up: For rated measurement accuracy, allow the 2606B to warm up for at least two hours before use.
  • Page 817 Model 2606B System SourceMeter® Instrument Reference Manual Section 18: Frequently asked questions How do I use the digital I/O port? You can use the 2606B digital input/output with the trigger model or to control an external digital circuit, such as a device handler used to perform binning operations. To control or configure any of the six digital I/O lines, send commands to the 2606B over a remote interface.
  • Page 818 Section 18: Frequently asked questions Model 2606B System SourceMeter® Instrument Reference Manual Interactive trigger programming The programming example below illustrates how to set up interactive triggering. The example sets the output trigger pulse width on line 1, then programs both lines 1 and 2 for falling edge triggers. Digital I/O line 1 trigger asserts, and then line 2 waits for the input trigger up to the timeout period specified.
  • Page 819 Model 2606B System SourceMeter® Instrument Reference Manual Section 18: Frequently asked questions When should I change the output-off state? Carefully consider and configure the appropriate output-off state, source function, and compliance limits before connecting the 2606B to a device that can deliver energy (for example, other voltage sources, batteries, capacitors, solar cells, or other 2606B instruments).
  • Page 820 Section 18: Frequently asked questions Model 2606B System SourceMeter® Instrument Reference Manual Where can I get the LabVIEW driver? The latest NI LabVIEW driver is available on tek.com/keithley. Why is the reading value 9.91e37? This value indicates that there is a measurement overflow error. This error occurs when: •...
  • Page 821 Section 19 Next steps In this section: Additional 2606B information ..........19-1 Additional 2606B information For additional information about the 2606B, refer to the Keithley Instruments website (tek.com/keithley), which contains the most up-to-date information. From the website, you can access: •...
  • Page 822 Specifications are subject to change without notice. All Keithley trademarks and trade names are the property of Keithley Instruments. All other trademarks and trade names are the property of their respective companies. Keithley Instruments Corporate Headquarters • 28775 Aurora Road • Cleveland, Ohio 44139 • 440-248-0400 • 1-800-833-9200 • tek.com/keithley 07/2020...

Table of Contents