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.
Table of contents Introduction ....................... 1-1 Welcome ..........................1-1 Extended warranty ....................... 1-2 Contact information ......................1-2 Organization of manual sections ..................1-2 Applications .......................... 1-3 Features ..........................1-4 General ratings ........................1-4 Installation ......................... 2-1 Dimensions .......................... 2-1 Handle and bumpers ......................2-5 Removing the handle and bumpers ..................
Page 7
Table of contents Model 2470 High Voltage SourceMeter Instrument Reference Manual Comparison of the communications interfaces ..............3-2 Simplicity ........................... 3-2 Triggering ..........................3-2 Transfer rate ..........................3-2 Instrument naming ........................3-2 Distance and instrument limitations ................... 3-3 Expense ............................ 3-3 GPIB communications ......................
Page 8
Model 2470 High Voltage SourceMeter Instrument Reference Manual Table of contents Touchscreen display ......................4-5 Select items on the touchscreen ....................4-5 Scroll bars ..........................4-6 Enter information ........................4-6 Adjust the backlight brightness and dimmer ................4-7 Event messages ........................4-8 Screen descriptions ......................
Page 9
Table of contents Model 2470 High Voltage SourceMeter Instrument Reference Manual Ranges ..........................5-20 Source range ........................... 5-21 Measurement range ........................ 5-22 Automatic reference measurements .................. 5-26 Setting autozero ........................5-26 Source readback ........................ 5-27 Setting source readback ......................5-27 Source delay ........................
Page 10
Model 2470 High Voltage SourceMeter Instrument Reference Manual Table of contents Load regulation ........................6-8 Using NPLCs to adjust speed and accuracy ............... 6-9 Noise shield ........................6-11 Safety shield ........................6-11 Safety shielding ........................6-12 Noise and chassis ground ....................6-12 Floating the 2470 .......................
Page 11
Table of contents Model 2470 High Voltage SourceMeter Instrument Reference Manual Deleting buffers ........................7-26 Remote buffer operation ....................7-26 Storing data in buffers ......................7-27 Accessing the data in buffers ....................7-29 Buffer read-only attributes ....................... 7-30 Reading buffer time and date values ..................7-30 Reading buffer for .
Page 12
Model 2470 High Voltage SourceMeter Instrument Reference Manual Table of contents Digital I/O lines ........................9-17 Remote digital I/O commands ....................9-23 Digital I/O bit weighting ......................9-25 Digital I/O programming examples ..................9-25 Trigger model ........................9-27 TriggerFlow Trigger Model ...................... 9-28 Trigger-model blocks .......................
Page 13
Table of contents Model 2470 High Voltage SourceMeter Instrument Reference Manual :CALCulate2:<function>:LIMit<Y>:CLEar:AUTO ..............12-19 :CALCulate2:<function>:LIMit<Y>:CLEar[:IMMediate] ............12-20 :CALCulate2:<function>:LIMit<Y>:FAIL? ................12-21 :CALCulate2:<function>:LIMit<Y>:LOWer[:DATA] ..............12-23 :CALCulate2:<function>:LIMit<Y>:STATe ................12-24 :CALCulate2:<function>:LIMit<Y>:UPPer[:DATA] ..............12-25 DIGital subsystem ......................12-26 :DIGital:LINE<n>:MODE ....................... 12-26 :DIGital:LINE<n>:STATe ....................... 12-28 :DIGital:READ? ........................12-29 :DIGital:WRITe <n>...
Page 14
Model 2470 High Voltage SourceMeter Instrument Reference Manual Table of contents [:SENSe[1]]:CONFiguration:LIST:STORe ................12-72 [:SENSe[1]]:COUNt ....................... 12-73 [:SENSe[1]]:FUNCtion[:ON] ....................12-74 SOURce subsystem ......................12-75 :SOURce[1]:CONFiguration:LIST:CATalog? ................. 12-75 :SOURce[1]:CONFiguration:LIST:CREate ................12-75 :SOURce[1]:CONFiguration:LIST:DELete ................12-76 :SOURce[1]:CONFiguration:LIST:QUERy? ................12-77 :SOURce[1]:CONFiguration:LIST:RECall ................12-78 :SOURce[1]:CONFiguration:LIST:SIZE? ................12-79 :SOURce[1]:CONFiguration:LIST:STORe ................
Page 15
Table of contents Model 2470 High Voltage SourceMeter Instrument Reference Manual :SYSTem:PASSword:NEW ....................12-125 :SYSTem:POSetup ......................12-126 :SYSTem:RANGe:COMPensation ..................12-127 :SYSTem:TIME ........................12-128 :SYSTem:VERSion? ......................12-129 TRACe subsystem ......................12-129 :TRACe:ACTual? ........................ 12-129 :TRACe:ACTual:END? ......................12-130 :TRACe:ACTual:STARt? ..................... 12-131 :TRACe:CLEar ........................12-132 :TRACe:DATA? ........................
Page 16
Model 2470 High Voltage SourceMeter Instrument Reference Manual Table of contents :TRIGger:CONTinuous ......................12-189 :TRIGger:DIGital<n>:IN:CLEar .................... 12-190 :TRIGger:DIGital<n>:IN:EDGE .................... 12-190 :TRIGger:DIGital<n>:IN:OVERrun? ..................12-191 :TRIGger:DIGital<n>:OUT:LOGic ..................12-192 :TRIGger:DIGital<n>:OUT:PULSewidth ................12-193 :TRIGger:DIGital<n>:OUT:STIMulus ................... 12-193 :TRIGger:LAN<n>:IN:CLEar....................12-195 :TRIGger:LAN<n>:IN:EDGE....................12-195 :TRIGger:LAN<n>:IN:OVERrun? ..................12-196 :TRIGger:LAN<n>:OUT:CONNect:STATe ................12-197 :TRIGger:LAN<n>:OUT:IP:ADDRess ..................
Page 17
Table of contents Model 2470 High Voltage SourceMeter Instrument Reference Manual Connecting an instrument in TSB ..................13-37 Creating a new TSP project ....................13-39 Adding a new TSP file to a project ..................13-40 Running a script ........................13-40 Creating a run configuration ....................
Page 18
Model 2470 High Voltage SourceMeter Instrument Reference Manual Table of contents bufferVar.extravalues ......................14-30 bufferVar.extravalueunits ...................... 14-31 bufferVar.fillmode ........................14-32 bufferVar.formattedreadings....................14-33 bufferVar.fractionalseconds....................14-34 bufferVar.logstate ........................14-35 bufferVar.n ..........................14-36 bufferVar.readings ......................... 14-37 bufferVar.relativetimestamps....................14-38 bufferVar.seconds ......................... 14-39 bufferVar.sourceformattedvalues ..................14-40 bufferVar.sourcestatuses ......................
Page 19
Table of contents Model 2470 High Voltage SourceMeter Instrument Reference Manual format.data ..........................14-97 fs.chdir() ..........................14-98 fs.cwd() ..........................14-99 fs.is_dir() ..........................14-99 fs.is_file() ..........................14-100 fs.mkdir() ..........................14-101 fs.readdir() ........................... 14-101 fs.rmdir() ..........................14-102 gpib.address ........................14-103 lan.dstprotection ........................14-104 lan.ipconfig() ........................
Page 20
Model 2470 High Voltage SourceMeter Instrument Reference Manual Table of contents smu.measure.filter.type ....................... 14-154 smu.measure.func ....................... 14-155 smu.measure.getattribute() ....................14-156 smu.measure.limit[Y].audible ....................14-157 smu.measure.limit[Y].autoclear ................... 14-158 smu.measure.limit[Y].clear()....................14-159 smu.measure.limit[Y].enable ....................14-159 smu.measure.limit[Y].fail ..................... 14-160 smu.measure.limit[Y].high.value ..................14-163 smu.measure.limit[Y].low.value ................... 14-164 smu.measure.math.enable ....................
Page 21
Table of contents Model 2470 High Voltage SourceMeter Instrument Reference Manual status.operation.condition ....................14-218 status.operation.enable ....................... 14-219 status.operation.event ......................14-219 status.operation.getmap() ....................14-220 status.operation.setmap()....................14-221 status.preset() ........................14-222 status.questionable.condition ....................14-222 status.questionable.enable....................14-223 status.questionable.event ....................14-223 status.questionable.getmap() ....................14-224 status.questionable.setmap() ....................14-225 status.request_enable ......................
Page 22
Model 2470 High Voltage SourceMeter Instrument Reference Manual Table of contents trigger.model.setblock() — trigger.BLOCK_BRANCH_DELTA ........... 14-269 trigger.model.setblock() — trigger.BLOCK_BRANCH_LIMIT_CONSTANT ......14-270 trigger.model.setblock() — trigger.BLOCK_BRANCH_LIMIT_DYNAMIC ......14-272 trigger.model.setblock() — trigger.BLOCK_BRANCH_ON_EVENT ........14-273 trigger.model.setblock() — trigger.BLOCK_BRANCH_ONCE..........14-275 trigger.model.setblock() — trigger.BLOCK_BRANCH_ONCE_EXCLUDED ....... 14-276 trigger.model.setblock() —...
Page 23
Table of contents Model 2470 High Voltage SourceMeter Instrument Reference Manual tspnet.termination() ......................14-327 tspnet.timeout ........................14-328 tspnet.tsp.abort() ......................... 14-329 tspnet.tsp.abortonconnect ....................14-329 tspnet.tsp.rbtablecopy() ....................... 14-330 tspnet.tsp.runscript() ......................14-331 tspnet.write() ........................14-332 upgrade.previous() ......................14-332 upgrade.unit() ........................14-333 userstring.add() ........................14-334 userstring.catalog() ......................
Page 24
Model 2470 High Voltage SourceMeter Instrument Reference Manual Table of contents Device connections ......................17-5 Drain leakage current measurement device connections ............17-5 Subthreshold current or drain family of curves measurement device connections ....17-7 Remote control of FET testing using SCPI commands ............. 17-8 Set up the application using SCPI commands with the trigger model ........
Page 25
Table of contents Model 2470 High Voltage SourceMeter Instrument Reference Manual How do I download measurements onto the USB flash drive? ......... 20-8 How do I save the present state of the instrument? ............20-9 Why did my settings change? ..................20-10 What is NPLC? .........................
Section 1 Introduction In this section: Welcome .................. 1-1 Extended warranty ..............1-2 Contact information ..............1-2 Organization of manual sections ..........1-2 Applications ................1-3 Features ................... 1-4 General ratings ................. 1-4 Welcome Thank you for choosing a Keithley product. The 2470 High Voltage SourceMeter Instrument is a precise, low-noise instrument that combines a stable DC power supply with a repeatable, high-impedance multimeter.
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 contact numbers, visit tek.com/contact-tek.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 1: Introduction • TSP-Link and TSP-NET: Connecting multiple instruments for high-speed trigger synchronization between instruments. Includes how to control the instrument using TSP commands and Test Script Builder (TSB) software, TSP-Link system expansion, and TSP-Net.
Section 1: Introduction Model 2470 High Voltage SourceMeter Instrument Reference Manual Features The 2470 offers the following features: • One tightly-coupled instrument that combines capabilities from analyzers, curve tracers, and I-V systems at a fraction of their cost. • Wide coverage — up to 1100 V / 1 A DC, 20 W maximum. •...
Section 2 Installation In this section: Dimensions ................2-1 Handle and bumpers ..............2-5 Instrument power ..............2-8 Basic connections ..............2-10 Test connections ..............2-11 Using the interlock ..............2-12 Front-panel or rear-panel test connections......2-15 Two-wire compared to four-wire measurements ....2-17 Test fixtures ................
Page 31
Section 2: Installation Model 2470 High Voltage SourceMeter Instrument Reference Manual The following figures show the dimensions when the handle and bumpers are installed. Figure 2: 2470 dimensions front and rear with handle and bumpers 2470-901-01 Rev. D October 2024...
Page 32
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 2: Installation Figure 3: 2470 dimensions side and top with handle and bumpers 2470-901-01 Rev. D October 2024...
Page 33
Section 2: Installation Model 2470 High Voltage SourceMeter Instrument Reference Manual The following figures show the dimensions when the handle and bumpers have been removed. Figure 4: 2470 front and rear panel dimensions with handle and bumpers removed 2470-901-01 Rev. D October 2024...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 2: Installation Figure 5: 2470 top and side dimensions with handle and bumpers removed Handle and bumpers The 2470 has a handle and front and rear bumpers for using the instrument on a benchtop. The handle rotates so that you can swing it below the bottom surface of the instrument to tilt the instrument up for easier front-panel viewing or carry the instrument.
Section 2: Installation Model 2470 High Voltage SourceMeter Instrument Reference Manual Removing the handle and bumpers You can remove the handle and bumpers on the 2470 if you want to mount the instrument in a rack. If you remove the handle and bumpers, be sure to store them for future benchtop use. To remove the bumpers: 1.
Page 36
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 2: Installation Figure 7: Removing the handle 2. Use a Phillips screwdriver to loosen and remove the two screws holding the handle-mount assembly to one side of the 2470. The handle-mount assembly will fall away from the instrument chassis when the screws are removed.
Section 2: Installation Model 2470 High Voltage SourceMeter Instrument Reference Manual Instrument power Follow the steps below to connect the 2470 to line power and turn on the instrument. The 2470 operates from a line voltage of 100 V to 240 V at a frequency of 50 Hz or 60 Hz. It automatically senses line voltage and frequency.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 2: Installation Connect the power cord To connect the power cord: 1. Make sure that the front-panel POWER switch is in the off (O) position. 2. Connect the socket of the supplied power cord to the AC receptacle on the rear panel. 3.
Section 2: Installation Model 2470 High Voltage SourceMeter Instrument Reference Manual Basic connections The front and rear terminals of the instrument are rated for connection to circuits rated Measurement Category O only, with transients rated less than 1500 V above the maximum PEAK rated input.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 2: Installation When making or breaking connections, follow these guidelines: • Power off the 2470 and all other instruments. • Disconnect any devices that may deliver energy. • Make connections to the device under test through a test fixture or other safe enclosure. •...
Section 2: Installation Model 2470 High Voltage SourceMeter Instrument Reference Manual On some sensitive or easily damaged devices under test (DUTs), the instrument power-up and power-down sequence can apply transient signals to the DUT that may affect or damage it. When testing this type of DUT, do not make final connections to it until the instrument has completed its power-up sequence and is in a known operating state.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 2: Installation If you try to assign a high-voltage output and turn the source on when the interlock is not asserted, event code 5074, “Output voltage limited by interlock,” is generated. The SOURCE swipe screen displays the value that is selected for the voltage source.
Page 43
Section 2: Installation Model 2470 High Voltage SourceMeter Instrument Reference Manual Potentially hazardous voltages of up to approximately 1350 V may be present at the High Force, High Sense, and Guard terminals when the interlock circuit is closed. To prevent electrical shock, do not expose these lines. You can use the Keithley connector CS-1616-3 Safety Interlock Mating Connector, supplied with the 2470, to make the interlock connection to the rear panel.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 2: Installation Front-panel or rear-panel test connections You can use either the front-panel or the rear-panel terminals to make connections to the device under test (DUT). The instrument must be set to use either the front or the rear terminals.
Section 2: Installation Model 2470 High Voltage SourceMeter Instrument Reference Manual Setting the instrument to use the front or rear terminals If the output is on when you change the settings for the terminals that are used, the output turns off. Using the front panel: 1.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 2: Installation Two-wire compared to four-wire measurements You can use 2-wire or 4-wire measurement techniques with the 2470. You should use 4-wire, or remote sense, measurement techniques for the following conditions: •...
Section 2: Installation Model 2470 High Voltage SourceMeter Instrument Reference Manual You can use 2-wire, or local sensing, measurement techniques for the following source-measure conditions: • Sourcing and measuring low current. • Sourcing and measuring voltage in high impedance (more than 1 kΩ) test circuits. •...
Page 48
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 2: Installation Figure 13: 2470 2-wire rear-panel connections Using the front panel: 1. Press the FUNCTION key. 2. Select the source and measure combination. 3. Press the MENU key. 4. Under Measure, select Settings. 5.
Section 2: Installation Model 2470 High Voltage SourceMeter Instrument Reference Manual To assign a different measure function, replace smu.FUNC_DC_VOLTAGE with one of the following: • For current measurements: smu.FUNC_DC_CURRENT • For resistance measurements: smu.FUNC_RESISTANCE Four-wire remote sense connections Using 4-wire remote sense connections provides the most accurate low-resistance, voltage source, and measurement accuracy.
Page 50
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 2: Installation To prevent unexpected voltages caused by a sense lead that becomes disconnected from its corresponding force lead during remote sense operation, you can enable overvoltage protection (OVP) to restrict the maximum output voltage level of the instrument when either voltage or current is sourced.
Page 51
Section 2: Installation Model 2470 High Voltage SourceMeter Instrument Reference Manual Figure 15: 2470 4-wire sense front-panel connection Set the instrument to 4-wire sense To use 4-wire connections, you must set the instrument to 4-wire sense. When 4-wire sense is selected and the output is turned off, the sense lines are internally disconnected.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 2: Installation Using TSP commands: To change to 4-wire sensing for voltage measurements, send these commands: smu.measure.func = smu.FUNC_DC_VOLTAGE smu.measure.sense = smu.SENSE_4WIRE To assign a different measure function, replace smu.FUNC_DC_VOLTAGE with one of the following: •...
Section 2: Installation Model 2470 High Voltage SourceMeter Instrument Reference Manual Minimizing the effect of lead resistance with 4-wire testing The 4-wire sensing method, shown in the following figure, minimizes or eliminates the effects of lead resistance. The effects of lead resistance are minimized by measuring the voltage across the resistor under test with a second set of test leads.
Page 54
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 2: Installation To provide protection from shock hazards, an enclosure should be provided that surrounds all live parts. Nonconductive enclosures must be constructed of materials that are suitably rated for flammability and the voltage and temperature requirements of the test circuit. Connect the enclosure of all metal test fixtures to protective earth (safety ground).
Section 2: Installation Model 2470 High Voltage SourceMeter Instrument Reference Manual Output-off state Carefully consider and configure the appropriate output-off state, source, and limits before connecting the 2470 to a device that can deliver energy, such as other voltage sources, batteries, capacitors, or solar cells.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 2: Installation Even though the voltage source is set to zero, the source value may not be exactly at zero and the instrument may source or sink a small amount of power. In most cases, this source or sink power level is insignificant.
Section 2: Installation Model 2470 High Voltage SourceMeter Instrument Reference Manual When the zero output-off state is selected, you can use the instrument as an ammeter because it is outputting 0 V. The zero mode is ideal for passive devices such as resistors. In most cases, it can also be used with energy storage devices such as capacitors and inductors.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 2: Installation Using SCPI commands: To set the output-off state to normal, send the command: :OUTPut:SMODe NORMal To set the output-off state to zero, send the command: :OUTPut:SMODe ZERO To set the output-off state to high impedance, send the command: :OUTPut:SMODe HIMPedance To set the output-off state to guard, send the command: :OUTPut:SMODe GUARd...
Section 2: Installation Model 2470 High Voltage SourceMeter Instrument Reference Manual Upgrade files are available on tek.com/keithley. Disconnect the input and output terminals before you upgrade or downgrade. Do not remove power from the instrument or remove the USB flash drive while an upgrade or downgrade is in progress.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 2: Installation 9. Choose an upgrade option: ▪ To upgrade to a newer version of firmware, select Upgrade to New. ▪ To return to a previous version of firmware, select Downgrade to Older. 10.
Section 2: Installation Model 2470 High Voltage SourceMeter Instrument Reference Manual Verify system information using TSP commands To view system information using TSP commands: To read the model number, send the command: print(localnode.model) To read the serial number, send the command: print(localnode.serialno) To read the firmware version, send the command: print(localnode.version)
Section 3 Using a remote interface In this section: Remote communications interfaces ......... 3-1 Comparison of the communications interfaces ......3-2 GPIB communications .............. 3-3 LAN communications ............... 3-8 USB communications ............. 3-17 Using the web interface ............3-22 Determine the command set to use ........3-30 How to install the Keithley I/O Layer ........
Section 3: Using a remote interface Model 2470 High Voltage SourceMeter Instrument Reference Manual Comparison of the communications interfaces The following topics discuss some of the advantages and disadvantages of the communications interfaces that are available for the 2470. Simplicity The GPIB interface is the simplest configuration.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 3: Using a remote interface Distance and instrument limitations For GPIB and USB interfaces, the cabling distances between the controller and instrument or hub are limited to 30 feet. In a system connected with GPIB or USB, you can have up to 15 instruments attached to each controller.
Section 3: Using a remote interface Model 2470 High Voltage SourceMeter Instrument Reference Manual Install the GPIB cards in your computer Refer to the documentation from the GPIB controller manufacturer for information about installing the GPIB controllers. Connect GPIB cables to your instrument To connect a 2470 to the GPIB interface, use a cable equipped with standard GPIB connectors, as shown in the following figure.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 3: Using a remote interface Figure 19: IEEE-488 connection example To connect the GPIB cable to the instrument: 1. Align the cable connector with the connector on the 2470 rear panel. 2.
Section 3: Using a remote interface Model 2470 High Voltage SourceMeter Instrument Reference Manual The instrument saves the address in nonvolatile memory. It does not change when you send a reset command or when you turn the power off and on again. To set the GPIB address from the front panel: 1.
Page 68
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 3: Using a remote interface When the instrument detects an interface clear (IFC) event, the instrument enters the talker and the listener idle state. When the instrument is in this state, the GPIB indicators on the front panel are not displayed.
Section 3: Using a remote interface Model 2470 High Voltage SourceMeter Instrument Reference Manual SPE, SPD When the instrument detects the serial polling enable (SPE) and serial polling disable (SPD) events, it sends the status byte of the instrument. This contains the serial poll byte of the instrument.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 3: Using a remote interface The following figure shows the location of the LAN port on the rear panel of the instrument. Connect the LAN cable between this connection and the LAN port on the computer. Figure 20: 2470 LAN port You can connect the instrument to the LAN in a one-to-one, one-to-many, two network card, or enterprise configuration, as described in the following topics.
Page 71
Section 3: Using a remote interface Model 2470 High Voltage SourceMeter Instrument Reference Manual One-to-many connection With a LAN hub, a single network interface card can be connected to as many instruments as the hub can support. This requires straight-through network (not crossover) cables for hub connections.
Page 72
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 3: Using a remote interface Figure 23: Two network card connection Instrumentation connection to enterprise routers or servers This connection uses an existing network infrastructure to connect instruments to the computer controller. In this case, you must get the network resources from the network administrator.
Section 3: Using a remote interface Model 2470 High Voltage SourceMeter Instrument Reference Manual Set up LAN communications on the instrument This section describes how to set up manual or automatic LAN communications on the instrument. Check communications settings Before setting up the LAN configuration, you can check the communications settings on the instrument without making any changes.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 3: Using a remote interface Set up manual LAN configuration If necessary, you can set the IP address on the instrument manually. You can also enable or disable the DNS settings and assign a host name to the DNS server. Contact your corporate information technology (IT) department to secure a valid IP address for the instrument when placing the instrument on a corporate network.
Section 3: Using a remote interface Model 2470 High Voltage SourceMeter Instrument Reference Manual Verify the LAN connection on the 2470 Make sure that your 2470 is connected to the network by confirming that your instrument was assigned an IP address. To verify the LAN connection: 1.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 3: Using a remote interface LAN interface protocols You can use one of following LAN protocols to communicate with the 2470: • Telnet • VXI-11 • Raw socket You can also use a dead socket termination port to troubleshoot communications problems. You can only use one remote interface at a time.
Section 3: Using a remote interface Model 2470 High Voltage SourceMeter Instrument Reference Manual Telnet connection The Telnet protocol is similar to raw socket and can be used when you need to interact directly with the instrument. Telnet is often used for debugging and troubleshooting. You need a separate Telnet program to use this protocol.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 3: Using a remote interface To restart the instrument: 1. Turn the power to the instrument off, and then on. 2. Wait at least 60 seconds for the network configuration to be completed. To set up LAN communications: 1.
Section 3: Using a remote interface Model 2470 High Voltage SourceMeter Instrument Reference Manual To connect an instrument to a computer using USB: 1. Connect the Type A end of the cable to the computer. 2. Connect the Type B end of the cable to the instrument. 3.
Page 80
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 3: Using a remote interface To use the Keithley Configuration Panel to determine the VISA resource string: 1. Select Start > Keithley Instruments > Keithley Configuration Panel. The Select Operation dialog box is displayed. Figure 26: Select Operation dialog box 2.
Page 81
Section 3: Using a remote interface Model 2470 High Voltage SourceMeter Instrument Reference Manual 4. Select USB. 5. Select Next. The Select Instrument Driver dialog box is displayed. Figure 28: Select Instrument Driver dialog box 6. Select Auto-detect Instrument Driver - Model. 7.
Page 82
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 3: Using a remote interface 9. In the Virtual Instrument Name box, enter a name that you want to use to refer to the instrument. 10. Select Finish. 11. Select Cancel to close the Wizard. 12.
Section 3: Using a remote interface Model 2470 High Voltage SourceMeter Instrument Reference Manual Using the web interface The 2470 web interface allows you to make settings and control your instrument through a web page. The web page includes: • Instrument status.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 3: Using a remote interface LAN troubleshooting suggestions If you are unable to connect to the web interface of the instrument, check the following items: • The network cable is in the LAN port on the rear panel of the instrument, not one of the TSP-Link ports.
Section 3: Using a remote interface Model 2470 High Voltage SourceMeter Instrument Reference Manual Web interface Home page Figure 31: 2470 web interface Home page The Home page of the instrument provides information about the instrument. It includes: • The instrument model number, manufacturer, serial number, and firmware revision number.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 3: Using a remote interface LXI Home page The LXI Home page displays instrument information, including the host name, MAC address, and VISA resource string. You cannot change the information from this page. You can use the host name instead of the IP address to connect to the instrument.
Section 3: Using a remote interface Model 2470 High Voltage SourceMeter Instrument Reference Manual Figure 32: LXI - Modify IP Configuration page 4. Change the values. 5. Select Submit. The instrument reconfigures its settings, which may take a few moments. You may lose your connection with the web interface after selecting Submit.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 3: Using a remote interface Using the 2470 virtual front panel The Virtual Front Panel page allows you to control the instrument from a computer as if you were using the front panel. You can operate the instrument using a mouse to select options. The virtual front panel operates the same way as the actual front panel, with the following exceptions: •...
Section 3: Using a remote interface Model 2470 High Voltage SourceMeter Instrument Reference Manual For information on the options, see Screen descriptions (on page 4-9). See the following figure for an example of the virtual front panel. Figure 33: Virtual front panel Change the date and time through the web interface You can change the instrument date and time through the web interface.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 3: Using a remote interface Change the password through the web interface You can change the instrument password from the web interface. The default user name and password is admin. Note that you cannot change the user name;...
Section 3: Using a remote interface Model 2470 High Voltage SourceMeter Instrument Reference Manual Review events in the event log Under LXI Home, the Log option opens the event log. The event log records all LXI events that the instrument generates and receives. The log includes the following information: •...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 3: Using a remote interface To change to the SCPI command set from a remote interface, send the command: *LANG SCPI Reboot the instrument. To change to the TSP command set from a remote interface, send the command: *LANG TSP Reboot the instrument.
Section 3: Using a remote interface Model 2470 High Voltage SourceMeter Instrument Reference Manual Interface access You can specify that the control interfaces request access before taking control of the instrument. There are several modes of access. You can set one of the following levels of access to the instrument: •...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 3: Using a remote interface Using SCPI commands Send the command that is appropriate for the level of access you want to enable: SYSTem:ACCess FULL SYSTem:ACCess EXCLusive SYSTem:ACCess PROTected SYSTem:ACCess LOCKout Using TSP commands Send the command that is appropriate for the level of access you want to enable: localnode.access = localnode.ACCESS_FULL...
Section 3: Using a remote interface Model 2470 High Voltage SourceMeter Instrument Reference Manual Switching control interfaces When the interface access is set to anything other than Full, you need to log in to the instrument from the new interface before you can change any settings. If you are changing to the front panel, when you attempt to make a selection, the Display Lockout - Enter Password keypad is displayed.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 3: Using a remote interface To change to the SCPI command set from a remote interface, send the command: *LANG SCPI Reboot the instrument. To change to the TSP command set from a remote interface, send the command: *LANG TSP Reboot the instrument.
Page 97
Section 3: Using a remote interface Model 2470 High Voltage SourceMeter Instrument Reference Manual To view system information using TSP commands: To read the model number, send the command: print(localnode.model) To read the serial number, send the command: print(localnode.serialno) To read the firmware version, send the command: print(localnode.version) To read the line frequency, send the command: print(localnode.linefreq)
Section 4 Instrument description In this section: Front-panel overview ..............4-1 Rear-panel overview ..............4-3 Turn the 2470 output on or off ..........4-4 Touchscreen display ..............4-5 Screen descriptions ..............4-9 Menu overview ............... 4-19 APPS Manager ..............4-42 Display features ..............
Page 99
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual QUICKSET key Opens a menu of preconfigured setups, including voltmeter, ammeter, ohmmeter, and power supply. Also allows you to choose source and measure functions and adjust performance for better resolution or speed.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description Force terminals Use FORCE HI and FORCE LO terminal connections to source or sink voltage or current to or from a device under test (DUT). FRONT/REAR Activates the terminals on the front or rear panel. When the front-panel terminals are active, a green “F”...
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual LAN port Supports full connectivity on a 10 Mbps or 100 Mbps network. The 2470 is a version 1.5 LXI Device Specification 2016 instrument that supports TCP/IP and complies with IEEE Std 802.3 (ethernet LAN).
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description Using the front panel: Press the OUTPUT ON/OFF switch. The instrument is in the output-on state when the switch is illuminated. The instrument is in the output-off state when the switch is not illuminated.
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual Scroll bars Some of the interactive screens have additional options that are only visible when you scroll down the screen. A scroll indicator on the right side of the touchscreen identifies these screens.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description You can enter information by touching the screen to select characters and options from the keypad or keyboard. You can move the cursor in the entry box by touching the screen. The cursor is moved to the spot in the entry box where you touched the screen.
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual To set the backlight dimmer from the front panel: 1. Press the MENU key. 2. Under System, select Settings. 3. Select Backlight Dimmer. The Backlight Dimmer dialog box opens. 4.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description Figure 38: Example front-panel error message Screen descriptions The following topics describe the screens and options that you can view on the 2470 front-panel display. Home screen This is the default screen that you see whenever you turn the 2470 on or when you press the HOME key.
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual Status and event indicators The indicators at the top of the home screen contain information about instrument settings and states. Some of the indicators also provide access to instrument settings. Select an indicator to get more information about the present state of the instrument.
Page 108
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description Communications activity indicator The activity indicator is located to the right of the communications indicator. When the instrument is communicating with a remote interface, the up and down arrows flash. Figure 42: Communications indicator If a service request has been generated, SRQ is displayed to the right of the up and down arrows.
Page 109
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual Active script indicator This indicator shows script activity and allows you to control script action from the home screen. If there is no script activity, the indicator displays "No Script." You can select the indicator to display a menu of available scripts.
Page 110
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description Measurement method indicator Located to the right of the active script indicator, this indicator shows the active measurement method. Select the indicator to open a menu. Select one of the buttons on the menu to change the measurement method or initiate or abort the trigger model.
Page 111
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual System event indicator On the right side of the instrument status indicator bar, this indicator changes based on the type of event that has been logged. Select the indicator to open a message screen with a brief description of the error, warning, or event.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description Measure view area The Measure view area of the home screen displays the value of the present measurement and other measurement information. Figure 47: MEASURE area of the home screen The Range button in the Measure area displays the presently selected measure range.
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual Swipe screens The 2470 touchscreen display has multiple screens that you can access by swiping left or right on the lower half of the display. The options available in the swipe screens are described in the following topics.
Page 114
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description SOURCE swipe screen The SOURCE swipe screen shows the present value of the source and the set values for source, source range, and source limit. You can change the set values from the front panel by selecting the buttons on this screen.
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual The icons on the right side of the swipe screen heading bar are shortcuts to the CALCULATIONS SETTINGS and MEASURE SETTINGS menus. For descriptions of the settings, use the navigation control to select the button, then press the HELP key.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description USER swipe screen You can program custom text and display it on the USER swipe screen. For example, you can program the 2470 to show that a test is in process. This swipe screen is only displayed if custom text has been defined.
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual QuickSet menu The QuickSet menu, which is centered under Source and Measure on the main menu, allows you to: ▪ Select predefined setups for the source and measure functions ▪...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description Source menu The Source menus allow you to select, configure, and perform source and sweep operations from the front panel. The following topics describe the settings that are available on these screens.
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual Source Sweep menu This menu allows you to set up a sweep and generate a source configuration list. It also builds a trigger model for the sweep. Setting Description Generate Create a source configuration list and trigger model using the settings on this menu.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description Measure menu The Measure menus allow you to select, configure, and perform measure operations from the front panel. The following topics describe the settings that are available on these screens.
Page 121
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual Filter Setting Description Count This sets the number of measurements that are averaged when filtering is enabled. Filter Enables or disables the averaging filter for measurements of the selected function. Type Selects the type of averaging filter that is used for the selected measure function when the measurement filter is enabled.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description Limit Setting Description Limit 1 and Limit 2 These settings enable or disable limit testing. The Limit options allow you to do pass- or-fail limit testing using the front panel of the instrument. When you do a limit test, the home screen displays the pass or fail result of the test.
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual Measure Reading Buffers menu The Reading Buffers menu allows you to view the list of existing reading buffers and select one to be the active buffer. You can also create, save, delete, resize, and clear buffers from this screen.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description Views menu The menus under Views in the main menu allow you to select, configure, and view data from measure operations on the 2470. The following topics describe the settings that are available on these screens.
Page 125
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual The values on the x and y axes show the values set in the Scale tab. The information at the bottom of the Graph tab contains a legend of the active axis and scale settings for the graph. You can swipe the legend to view buffer statistics and readings at the cursors.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description Scale tab The Scale tab contains settings that allow you to fine-tune the output on the Graph tab. Setting Description Trace When multiple traces are selected, toggles between the available traces. Information specific to the trace is shown in the same color as the trace.
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual Trigger tab The Views Graph Trigger tab contains settings that define the trigger mode. Setting Description Source Event Determines the event that is used to trigger measurements. You can select: ▪...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description Views Histogram menu The Histogram menu allows you to graph the distribution of measurement data in the selected reading buffer. It also contains tabs that you can use to customize the histogram. Histogram tab The Histogram tab graphs readings as a bar graph of the data distribution into bins.
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual Scale tab The Scale tab allows you to set up boundaries, number of bins, and type of scaling used for the histogram. Setting Description Maximum Boundary The highest value of the data that is binned in the histogram. Data that is above this level is binned in the high outlier bin.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description Trigger Templates menu The Templates menu allows you to choose from one of several preprogrammed trigger models. When you select a template, settings you can specify for that template are shown in the lower part of the screen.
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual Setting Description LoopUntilEvent Creates a trigger model that makes continuous measurements until a specified event occurs. Settings that you can change before generating the trigger model: ▪ Source Event (default Trigger Key) ▪...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description From this screen, you can: • Insert a new trigger block before or after the selected block • Choose among several block types to add • Edit an existing block •...
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual Scripts Manage menu The Manage menu allows you to copy scripts to and from the instrument and the USB flash drive. You can also delete scripts from the instrument or USB flash drive. Setting Description >...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description Scripts Save Setup menu The Save Setup menu allows you to save the present settings and configuration lists of the instrument into a configuration script. You can use this script to recall the settings. Graph settings are not saved.
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual Scripts Apps menu The Apps menu opens the Apps Manager. Apps Manager is used to manage prebuilt TSP applications. TSP applications are Keithley-developed programs that enable the instrument to use specialized functions, test automation, and visualize information on the user interface.
Page 136
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description The Log Settings tab view contains settings that affect what data displays on the System Events tab. The following table describes these settings. Setting Description Clear Log Clears all entries from the event log. Turns the logging of commands on or off.
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual System Communication menu The Communication menu opens a set of tabs that contain information about the communications settings. Most of the tabs contain settings that you can change. GPIB tab setting Description Address...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description System Settings menu The Settings menu contains general instrument settings. Setting Description Audible Errors Turns the beeper on or off. When the beeper is on, the beeper sounds when an event or error occurs.
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual System Info/Manage menu The Info/Manage menu gives you access to version and serial number information and settings for instrument firmware and reset functions. Setting Description Downgrade to Older Returns the 2470 to a previous version of the firmware from a file on a USB flash drive.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description Download and run TSP applications If an application is removed from your instrument or a new application is made available, you can download the application and install it on your instrument. To download and run TSP applications from your computer: 1.
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual From the front panel: 1. Set TERMINALS to FRONT. 2. Press MENU. 3. Under Measure, select Settings. 4. Set Display Digits. This setting takes effect the next time you make a measurement. From a remote interface: •...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description Figure 61: Exponent display format From the front panel: 1. Press the MENU key. 2. Under System, select Settings. 3. Select the button next to Reading Format. 4. Select the reading format (Prefix or Exponent). This setting takes effect immediately.
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual Using SCPI commands: Send the commands: DISPlay:SCReen SWIPE_USER DISPlay:USER1:TEXT "Test in process" DISPlay:USER2:TEXT "Do not disturb" Using TSP commands: Send the commands: display.changescreen(display.SCREEN_USER_SWIPE) display.settext(display.TEXT1, "Test in process") display.settext(display.TEXT2, "Do not disturb") Clearing the USER swipe screen You can clear the message that is displayed on the USER swipe screen.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description Figure 62: Input number example For more information on creating the interactive prompts, see the following command descriptions: • display.input.number() (on page 14-71) • display.input.option() (on page 14-73) •...
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual Instrument sounds The instrument can emit a beep when a front-panel key is pressed or when a system event occurs. You can turn these beeps on or off. Through the remote interface, you can generate a beep with a defined length and tone.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description Saving setups You can save the present settings and any configuration lists that you have defined for the 2470 to internal memory or an external USB flash drive. After the settings are saved, you can recall the settings.
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual Using TSP commands: 1. Configure the instrument to the settings that you want to save. 2. Send the command: createconfigscript("setupName") Where setupName is the name of the setup script that is created. Save a user setup to a USB flash drive You cannot save to the flash drive using SCPI commands.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description Copy a user setup To copy a user setup from an external USB flash drive to the instrument from the front panel: 1. Insert the USB flash drive into the USB port on the front panel. 2.
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual To recall a saved setup from the front panel: 1. Press the MENU key. 2. Under Scripts, select Run. 3. In the Available Scripts list, select the script you want to recall. USB scripts have the prefix usb1/.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description Using a SCPI command, send the command: :SYSTem:POSetup <name> Where <name> is: • RST: Use the *RST defaults. • SAV0: Use the setup stored at memory location 0 •...
Page 151
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual • Password reset: This resets the instrument password to its default value. You can reset the password by pressing the MENU key, selecting Info/Manage (under System), and selecting Password Reset. When you do this, the password returns to the default setting.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description Reset the instrument You can reset many of the instrument settings to their default values. For detail on what gets reset, see Reset default values (on page 6-29). Default values are also listed in the command descriptions.
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual Information provided for each event log entry Each event log entry includes the following information: • The date and time when the event occurred in 24-hour time format (MM/DD HH:MM) •...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description The options available on this tab are described in the table below. Settings tab settings Description Show Warning Turns the display of warnings on or off. If you turn this off, the instrument continues to record warnings and display warning popup messages, but does not display them on the System Events tab.
Section 4: Instrument description Model 2470 High Voltage SourceMeter Instrument Reference Manual Saving front-panel settings into a macro script You can save some settings made through the front panel into a macro script that you can run later. The settings that are saved include any settings made through: •...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 4: Instrument description After you create a macro script, you can use the other Scripts menu options to run and manage scripts. Refer to Scripts menu (on page 4-35) for information on the options. Running a macro script You can run a macro script from the front panel or from a remote interface.
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Hazardous voltages may be present on all output and guard terminals. To prevent electrical shock that could cause injury or death, never make or break connections to the 2470 while the instrument is powered on.
Page 159
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring Making a measurement with the QuickSet functions The measurement-only functions available through the QuickSet option include Voltmeter, Ammeter, Ohmmeter, and Power Supply. Using the front panel: 1. Make connections to the device under test before running the Quick Setup. The Voltmeter and Ammeter options use 2-wire connections.
Page 160
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Using the Performance slider Use the Performance slider to adjust for performance (resolution versus speed). When you adjust the Performance slider, the instrument changes settings based on where you position the slider.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring 10. You can adjust the settings while the instrument makes measurements. 11. When you are finished, turn the output off by pressing the OUTPUT ON/OFF switch. The OUTPUT indicator light turns off.
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Adjusting source and limit values using live update When you enable live update on the instrument, you can update source range and source limit values instantly using the navigation control. To enter live update: 1.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring As you change each character, the updates happen in real time if the output is on (press the OUTPUT ON/OFF switch to turn the source on). For example, if you want to change from 15 V to 7 V, after changing the 5 to a 7, the instrument outputs 17 V until you change the 1 to a 0.
Page 164
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Resistance measurement methods From the front panel, you can use one of the following methods to measure resistance with the 2470: • Press FUNCTION and select source current and measure resistance. •...
Page 165
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring Using SCPI: Send the following code: *RST SENSe:FUNCtion "CURR" SENSe:CURRent:RANGe:AUTO ON SENSe:CURRent:UNIT OHM SENSe:CURRent:OCOM ON SOURce:FUNCtion VOLT SOURce:VOLT 5 SOURce:VOLT:ILIM 0.01 SENSe:COUNT 5 OUTPut ON TRACe:TRIGger "defbuffer1" TRACe:DATA? 1, 5, "defbuffer1", SOUR, READ OUTPut OFF The front-panel display will look similar to the following example.
Page 166
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual The front-panel display will look similar to the following example. Figure 65: Resistance measurement SVMI and reading ohms Source current, measure voltage, and set measure units to ohms If you want to make resistance readings by sourcing current and measuring voltage, you can use this method.
Page 167
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring The front-panel display will look similar to the following example. Figure 66: Resistance measurement SIMV SCPI example Using TSP commands: Send the following code: reset() smu.measure.func = smu.FUNC_DC_VOLTAGE smu.measure.autorange = smu.ON smu.measure.unit = smu.UNIT_OHM smu.measure.count = 5...
Page 168
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Measure resistance using the resistance function When the measurement function is set to resistance, the 2470 measures resistances by sourcing current. The instrument automatically sets the magnitude of the current source, voltage limit, and the measure range.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring The front-panel display looks similar to the following example. Figure 69: Resistance measurement with automatic settings Offset-compensated ohms The voltage offsets caused by the presence of thermoelectric EMFs (V ) can adversely affect resistance measurement accuracy.
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Source and measure using SCPI commands The SCPI commands that set up the source functions are in the SOURce subsystem. The source commands are specific to each source function (voltage or current). For example, to set the range to 100 mA for the current function, you would send: :SOURce:FUNCtion CURRent :SOURce:CURRent:RANGe 1e-01...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring Source and measure using TSP commands The TSP commands that set up the source functions begin with smu.source. The source commands are specific to each source function (voltage or current). For example, to set the range to 100 mA for the current source function, you would send: smu.source.func = smu.FUNC_DC_CURRENT smu.source.range = 0.1...
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Protection The 2470 provides several methods for ensuring that the source remains within certain values. This helps to protect the device under test (DUT) from damage. The protections that affect the source are the: •...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring Setting overvoltage protection levels Using the front panel: 1. Press the MENU key. 2. Under Source, select Settings. 3. Select Overvoltage Protection Limit. 4. Select the limit. 5.
Page 174
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual This limit can also be restricted by the measurement range. If a specific measurement range is set, the limit must be more than 0.1 percent of the measurement range. If not, an event is generated and the limit is automatically changed to an appropriate value for the selected range.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring In steady-state conditions, the set limit restricts the instrument output unless there are fast transient load conditions. If the source output exceeds the source limit: • On the home screen, LIMIT is displayed to the right of the source voltage. •...
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Setting autorange rebound Using the front panel: 1. Press FUNCTION and select the source and measurement combination. 2. Select MENU. 3. Under Measure, select Settings. 4. Set Auto Range Rebound to On. Using SCPI commands: To enable autorange rebound when measuring current, send the command: SENSe:CURRent:RANGe:AUTO:REBound ON...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring Source range For most applications, you will select the automatic source range. This causes the instrument to set the source range to the best range for the present settings. In most cases, you select a specific source range to verify that a sweep uses the same range to source all the sweep points or to reduce test time.
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Selecting the automatic source range When the automatic range is selected, the source-measure cycle is repeated to determine the correct range. This means that any source delay is applied each time the instrument has to set the automatic range.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring You need to set the measure function before you can set the measure range. Maximum limits for 2470 Measure range Maximum source limit 200 mV ±210 mV ±2.1 V 20 V ±21 V...
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Selecting the automatic measurement range When automatic measure range is selected, the instrument automatically selects the best range to measure the signal. When the automatic range is selected, the source-measure cycle is repeated to determine the correct range.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring Using the front panel: 1. Press the FUNCTION key and select the function. 2. On the measure area of the home screen, select Range. The Measure Range dialog box is displayed.
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Automatic reference measurements To ensure the accuracy of readings, the instrument must periodically get new measurements of its internal ground and voltage reference. The time interval between updates to these reference measurements is determined by the integration aperture that is being used for measurements.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring To set autozero using TSP commands, refer to the following commands: • smu.measure.autozero.enable (on page 14-138) • smu.measure.autozero.once() (on page 14-139) Source readback You can set the instrument to record and display the voltage or current of the configured source value or the actual source value.
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Source delay When you use the instrument to source and measure, there is a delay between when the source is turned on and when the measurement is made. The delay provides a settling time for the source.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring The measure time depends on the selected measurement speed. For example, if the speed is set at 0.01 PLC, the measure time is 167 µs for 60 Hz operation (0.01/60). Setting the source delay Using the front panel: 1.
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual You can perform the equivalent of relative offset manually by using the mx+b (on page 5- 33) math function. Set m to 1 and b to the value of the offset. Establishing a relative offset value You can use the 2470 to automatically determine the relative offset, or you can assign a specific relative offset value.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring Setting a relative offset value You can set a specific relative offset value using the front panel or remote commands. Using the front panel: 1. Press the FUNCTION key and select the measure function. 2.
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual You can also disable the relative offset feature by selecting MENU > Measure > Calculations > Rel and selecting Off. Using SCPI commands: Send the command: :SENSe:VOLTage:RELative OFF To set the relative offset for another function, replace VOLTage with CURRent or RESistance.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring mx+b The mx+b math operation lets you manipulate normal display readings (x) mathematically based on the following calculation: mx + b = y Where: • m is a user-defined constant for the scale factor •...
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Reciprocal (1/X) You can set math operation to reciprocal to display the reciprocal of a reading. The reciprocal is 1/X, where X is the reading. If relative offset is on, the 1/X calculation uses the input signal with the relative offset applied.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring Setting mx+b math operations From the front panel: 1. Press the FUNCTION key and select the measure function. 2. Press the MENU key. 3. Under Measure, select Calculations. 4.
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Using a remote interface: • SCPI commands: Refer to :CALCulate[1]:<function>:MATH:FORMat (on page 12-11). • TSP commands: Refer to smu.measure.math.format (on page 14-166) and smu.measure.math.enable (on page 14-165). Switching math on the SETTINGS swipe screen Once you set the math operations settings for a measure function, you can turn the math function on or off on the SETTINGS swipe screen.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring Sweep operation Sweeps allow you to set up the instrument to source specific voltage or current values to a device under test (DUT). A measurement is made for each value. The 2470 can generate linear staircase, logarithmic staircase, linear dual staircase, and logarithmic dual staircase sweeps from the front panel or from a remote interface.
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Figure 71: 2470 sweep linear staircase Logarithmic staircase sweep A logarithmic staircase sweep is similar to a linear staircase sweep. The only difference is that the steps are scaled logarithmically. The steps in a logarithmic staircase sweep increase or decrease geometrically, beginning with a start voltage or current and ending with a stop voltage or current.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring Setting up a sweep Defining and generating a sweep creates a new trigger model that will replace an existing trigger model. If you want to preserve the existing trigger model, save a user-saved setup. Saving setups (on page 4-49) for information on saving an existing trigger model as part of a user-saved setup.
Page 196
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Set up the sweep from the front panel 1. Select FUNCTION and select the source and measure functions. 2. On the home screen, set the Source value. 3.
Page 197
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring Front-panel sweep options Option Description Type You can select one of the following options: ▪ Linear: Sets up a linear staircase sweep. ▪ Logarithmic: Sets up a logarithmic staircase sweep. ▪...
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Front-panel sweep options Option Description Count How many times the sweep should repeat. You can select one of the following options: ▪ Finite: Set a specific number of times to repeat. ▪...
Page 199
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring To create a sweep: 1. Set the source function using :SOURce[1]:FUNCtion[:MODE]. 2. Set the source range using :SOURce[1]:<function>:RANGe. 3. Set any other source settings that apply to your sweep. You must set source settings before the sweep function is called.
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Setting up a sweep using TSP commands To set up a sweep using TSP commands, you send one of the following commands: • smu.source.sweeplinear(): Sets up a linear sweep for a fixed number of measurement points.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring For example sweeps, see Sweep programming examples (on page 5-46). For detail on the commands and options listed above, see the following command descriptions: • createconfigscript() (on page 14-56) •...
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Sweep programming examples The following examples show programming examples of typical sweeps. Linear sweep with a voltage source The following examples perform a linear sweep that uses a voltage source. They perform the following actions: •...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring Logarithmic sweep with a current source The following examples perform a logarithmic sweep using a current source. They perform the following actions: • Reset the instrument to its defaults. •...
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Voltage sweep based on a configuration list The following TSP example shows a voltage sweep that is based on a configuration list. It: • Resets the instrument to its defaults. •...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring Limit testing and binning The 2470 can be set up for limit testing and binning. It can perform simple benchtop limit testing using the front panel or sophisticated limit and binning operations using the trigger model and digital I/O to control external component-handling devices.
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Limit testing using the front-panel interface You can do pass or fail limit testing through the front panel. When limit testing and a test fails, the limit (1 or 2) that failed is shown on the home screen. The low value must be less than the high value.
Page 207
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring 5. Set Limit 1 and Limit 2 to On. 6. Select Settings for Limit 1. 7. Set the High Value to 110 Ω. 8. Set the Low Value to 90 Ω. 9.
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Set up a limit test using the remote interface You can set up limit testing through a remote interface. There are several methods you can use to set up the limit test: •...
Page 209
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring If a resistor passes the 10% limit test, the resistance value is checked against the 5% limit value, and so on. If a resistor passes all the limit tests, the trigger model outputs the overall pass bit pattern, which causes the component handler to place the resistor in the 1% tolerance part bin.
Page 210
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Figure 77: Resistor grading example blocks 7 to 18 5-54 2470-901-01 Rev. D October 2024...
Page 211
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring Figure 78: Resistor grading example blocks 19 to 23 Resistor grading SCPI code Send the following commands for this example application: Command Description *RST Reset the 2470. SOURce:FUNCtion CURRent Set the instrument to source current with a SOURce:CURRent:RANGe 0.01...
Page 212
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual DIGital:LINE1:MODE DIG, OUT Set the digital I/O lines 1 to 4 to be digital DIG:LINE2:MODE DIG, OUT lines that detect rising-edge or falling-edge triggers as input. DIG:LINE3:MODE DIG, OUT DIG:LINE4:MODE DIG, OUT Set digital I/O line 5 for trigger model control, detecting falling-edge triggers as input.
Page 213
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring Resistor grading TSP code local number_of_resistors = 100 -- Reset instrument to default settings. reset() -- Measure function must be first measure setting; -- most other settings are tied to the function. smu.measure.func = smu.FUNC_DC_VOLTAGE smu.measure.unit = smu.UNIT_OHM -- Report Vmeasured/Isource.
Page 214
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual -- Configure digital I/0 line 6 as a trigger output. -- Used to send end-of-test trigger to component handler. digio.line[6].mode = digio.MODE_TRIGGER_OUT -- Output a falling edge trigger. trigger.digout[6].logic = trigger.LOGIC_NEGATIVE -- Set width of output trigger pulse to 10 us.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring -- Block 16: Check if 99<=R<=101; if yes, go to Block 19. trigger.model.setblock(16, trigger.BLOCK_BRANCH_LIMIT_CONSTANT, trigger.LIMIT_INSIDE, 99, 101, 19, 5) -- Block 17: Set digital I/O lines 1-4; output decimal 3 (binary 0011) -- to component handler.
Page 216
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Figure 79: Resistor sorting example trigger model 5-60 2470-901-01 Rev. D October 2024...
Page 217
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring Resistor sorting SCPI code Send the following commands for this example application: Command Description *RST Reset the 2470. SOUR:FUNC CURR Set the instrument to source current with a SOUR:CURR:RANG 0.01 range of 10 mA and a voltage limit of 2 V.
Page 218
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual ▪ Block 10: Check if 106 ≤ R ≤ 108; if TRIG:BLOC:DIG:IO 11, 15, 15 yes, go to Block 23. ▪ Block 11: Set digital I/O lines 1 TRIG:BLOC:DEL:CONS 12, 0.001 through 4;...
Page 219
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring -- Set the source level to 10 mA. smu.source.level = 0.01 -- The measure function must be first measure setting; -- most other settings are tied to the function. smu.measure.func = smu.FUNC_DC_VOLTAGE -- Set the measure range after setting source function to current.
Page 220
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual -- Block 4: Delay for 1 ms to allow source to settle; adjust as appropriate. trigger.model.setblock(4, trigger.BLOCK_DELAY_CONSTANT, 0.001) -- Block 5: Measure resistance and store result in defbuffer1. trigger.model.setblock(5, trigger.BLOCK_MEASURE_DIGITIZE, defbuffer1) -- Block 6: Turn source output off.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring Configuration lists A configuration list is a list of stored settings for the source or measure function. You can restore these settings to change the function and its settings that are used by the instrument.
Page 222
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Settings stored in a source configuration index The following source settings are stored in a source configuration index: • Function • Auto Delay • Delay • High Capacitance •...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring Filter settings: • Enable • Count • Type Limit 1 and Limit 2 settings: • Enable • Audible • Auto Clear • High Value • Low Value Math settings: •...
Page 224
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual You can work with configuration lists from the front panel or by using remote commands. Recall source configuration lists before measure configuration lists. This order ensures that dependencies between source and measure settings are properly handled.
Page 225
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring To use SCPI commands to create a source configuration list: :SOURce:CONFiguration:LIST:CREate "MySourceList" To use SCPI commands to create a measure configuration list: :SENSe:CONFiguration:LIST:CREate "MyMeasList" To use TSP commands to create a source configuration list: smu.source.configlist.create("MySourceList") To use TSP commands to create a measure configuration list: smu.measure.configlist.create("MyMeasList")
Page 226
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual To configure the instrument and store the measurement settings into indexes: 1. Press the FUNCTION key. 2. Select Source Voltage and Measure Current. 3. Press the MENU key. 4.
Page 227
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring Send the following SCPI commands: :SOURce:FUNCtion VOLTage :SOURce:VOLtage:RANGe 20 :SOURce:VOLTage:LEVel 2 :SOURce:CONF:LIST:STORe "MySourceList" :SOURce:VOLTage:LEVel 3 :SOURce:CONF:LIST:STORe "MySourceList" :SOURce:VOLTage:LEVel 4 :SOURce:CONF:LIST:STORe "MySourceList" :SOURce:VOLTage:LEVel 5 :SOURce:CONF:LIST:STORe "MySourceList" This example: •...
Page 228
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual • Stores the setting to MySourceList • Sets the source level to 5.0 V • Stores the setting to MySourceList Send the following TSP commands: smu.source.configlist.create("MySourceList") smu.source.func = smu.FUNC_DC_VOLTAGE smu.source.range = 20 smu.source.level = 2 smu.source.configlist.store("MySourceList")
Page 229
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring The store function command stores the settings for a specific function into a configuration list. The configuration list must be created before you use the store function command. Refer to smu.source.configlist.storefunc() (on page 14-192) or...
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Send the following TSP commands: smu.measure.configlist.create("MyMeasList") smu.measure.setattribute(smu.FUNC_DC_VOLTAGE, smu.ATTR_MEAS_RANGE, 100) smu.measure.configlist.storefunc("MyMeasList", smu.FUNC_DC_VOLTAGE) smu.measure.setattribute(smu.FUNC_DC_CURRENT, smu.ATTR_MEAS_RANGE, 0.1) smu.measure.configlist.storefunc("MyMeasList", smu.FUNC_DC_CURRENT) Recall a configuration index You can recall the settings stored in a specific configuration index in a configuration list. If you are using remote commands, you can recall an index from a source configuration list and a measure configuration list in a single command.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring Using SCPI commands: To recall index 2 from a source configuration list: :SOURce:CONFiguration:LIST:RECall "MySourceList", 2 To recall index 2 from a measure configuration list: :SENSe:CONFiguration:LIST:RECall "MyMeasList", 2 To recall index 2 from a source configuration list and a measure configuration list using a single command: :SOURce:CONFiguration:LIST:RECall "MySourceList", 2, "MyMeasList", 2...
Page 232
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Use the front panel to view the contents of a source configuration list: 1. Press the MENU key. 2. Under Source, select Config Lists. The SOURCE CONFIGURATION LISTS screen is displayed.
Page 233
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring Figure 81: Measure configuration list index details 6. When you are finished, select OK. Using SCPI commands: The SCPI configuration list query command returns a list of TSP commands that could be used to set the parameters stored in the specified configuration index.
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Delete a configuration index or list You can delete individual configuration indexes from a configuration list using the front panel or remote commands. When a configuration list index is deleted, the following indexes are renumbered so that the indexes are numbered sequentially.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring To use TSP commands to delete index 2 from a source configuration list named MySourceList: smu.source.configlist.delete("MySourceList", 2) To use TSP commands to delete a source configuration list named MySourceList: smu.source.configlist.delete("MySourceList") To use TSP commands to delete index 2 from a measure configuration list named MyMeasList:...
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Using TSP commands: To return the name of one source configuration list stored on the instrument, use the following command. print(smu.source.configlist.catalog()) To receive the name of one measure configuration list stored on the instrument, use the following command.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 5: Sourcing and measuring Using SCPI commands: To view the number of configuration indexes in a source configuration list named MySourceList, send the following command: :SOURce:CONFiguration:LIST:SIZE? "MySourceList" To view the number of configuration indexes in a measure configuration list named MyMeasList, send the following command: :SENSe:CONFiguration:LIST:SIZE? "MyMeasList"...
Section 5: Sourcing and measuring Model 2470 High Voltage SourceMeter Instrument Reference Manual Remote commands for configuration list operations You can use the following remote commands to create and maintain configuration lists. Action SCPI command TSP command Create a configuration list [:SENSe[1]]:CONFiguration:LIST:CREate (on page 12-67) smu.measure.configlist.create()
Section 6 Source-measure considerations In this section: Circuit configurations ..............6-1 Operating boundaries ............... 6-4 Output transient recovery ............6-8 Load regulation ................ 6-8 Using NPLCs to adjust speed and accuracy ......6-9 Noise shield................6-11 Safety shield ................6-11 Noise and chassis ground ............
Page 240
Section 6: Source-measure considerations Model 2470 High Voltage SourceMeter Instrument Reference Manual Figure 82: Current source configuration The current source does not use the sense leads to enhance current source accuracy. However, if the instrument is in 4-wire sense, the instrument may reach limit levels if you disconnect the sense leads.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 6: Source-measure considerations Source voltage When you configure the instrument to source voltage, it functions like a low-impedance voltage source that can limit current. The instrument can measure current or voltage. This configuration is shown in the figure below.
Section 6: Source-measure considerations Model 2470 High Voltage SourceMeter Instrument Reference Manual Operating boundaries Operating boundaries define the current and voltage limits of the instrument. The general operating boundaries of the 2470 are shown in the following figure. Figure 84: Model 2470 operating boundaries If the voltage or current exceeds the limits, the instrument limits the source voltage to keep operating currents and voltages in these boundaries.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 6: Source-measure considerations When the instrument is operating in quadrant II or IV, the instrument is operating as a sink, which means that voltage and current have opposite polarity. As a sink, the instrument dissipates the power internally.
Page 244
Section 6: Source-measure considerations Model 2470 High Voltage SourceMeter Instrument Reference Manual The following graphs show operation with the instrument set to source 100 mA with a limit of 40 V. In this graph, the resistive load is 200 Ω. The instrument is sourcing 100 mA to the 200 Ω...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 6: Source-measure considerations Notice that as resistance increases, the slope of the DUT load increases. As resistance approaches infinity (open output), the instrument sources virtually 0 mA at 40 V. Conversely, as resistance decreases, the slope of the DUT load decreases.
Section 6: Source-measure considerations Model 2470 High Voltage SourceMeter Instrument Reference Manual Figure 89: 2470 current limit boundary example limited Voltage source = Current * DUT resistance = (50 mA)(800 Ω) = 40 V Notice that as resistance decreases, the slope of the DUT load increases. Conversely, as resistance increases, the slope of the DUT load decreases.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 6: Source-measure considerations Using NPLCs to adjust speed and accuracy You can adjust the amount of time that the input signal is measured. Adjustments to the amount of time affect the usable measurement resolution, the amount of reading noise, and the reading rate of the instrument.
Page 248
Section 6: Source-measure considerations Model 2470 High Voltage SourceMeter Instrument Reference Manual Using SCPI commands: To set the number of PLCs for current measurements, send the command: :SENSe:CURRent:NPLCycles <n> To set the number of PLCs for resistance measurements, send the command: :SENSe:RESistance:NPLCycles <n>...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 6: Source-measure considerations Noise shield Use a noise shield to prevent the introduction of unwanted signals into the test circuit. Low-level signals may benefit from effective shielding. The metal noise shield surrounds the test circuit and should be connected to LO, as shown.
Section 6: Source-measure considerations Model 2470 High Voltage SourceMeter Instrument Reference Manual Safety shielding Use #16 AWG wire or larger for connections to safety earth ground and chassis. For more detail on shielding, refer to the Low Level Measurements Handbook: Precision DC Current, Voltage, and Resistance Measurements.
Page 251
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 6: Source-measure considerations For more information on preventing noise problems, refer to the Keithley Low Level Measurements Handbook, available on tek.com/keithley. Floating the 2470 SENSE LO and FORCE LO are not internally connected to the chassis. Do not allow them to float above chassis ground more than 250 V.
Page 252
Section 6: Source-measure considerations Model 2470 High Voltage SourceMeter Instrument Reference Manual Figure 93: Connections for floating the instrument The external voltage source can be a source-measure unit (SMU) of a second 2470 instrument or other instrument. Keep in mind that if the combined outputs of the sources exceed ±42 V, a safety shield is required for the device under test (DUT).
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 6: Source-measure considerations Guarding Use guarding to isolate impedance that you do not want to measure. Guarding is an effective way to reduce the leakage current and capacitance that can exist between HI and LO.
Section 6: Source-measure considerations Model 2470 High Voltage SourceMeter Instrument Reference Manual In the following schematic, note that guarding eliminates resistance leakage current (R The current flowing in resistance leakage 2 (R ) is supplied by the guard and does not affect the DUT current (I Figure 94: Guarded configuration Sink operation...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 6: Source-measure considerations Carefully consider and configure the output-off state, source, and limits before connecting the 2470 to a device that can deliver energy. Devices that can deliver energy include voltage sources, batteries, capacitors, and solar cells.
Page 256
Section 6: Source-measure considerations Model 2470 High Voltage SourceMeter Instrument Reference Manual Charging A battery is usually charged using a constant current. To do this, use a 2470 as a voltage source set to the voltage rating of the battery, with the target charging current set as the current limit.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 6: Source-measure considerations 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 258
Section 6: Source-measure considerations Model 2470 High Voltage SourceMeter Instrument Reference Manual If your 2470 analog board revision is 878-1493-05 or later, when breakdown protection is set to ON, the SMU always puts the clamp in series with the output, even on the 1 A current range.
Page 259
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 6: Source-measure considerations A more comprehensive method of testing components to determine the DUT breakdown voltage is to measure the actual component breakdown voltage. To do this on a 1000 V rated MOSFET, you need to switch the sourcing method to current and the limit voltage to 1100 V (higher than the highest expected breakdown voltage).
Section 6: Source-measure considerations Model 2470 High Voltage SourceMeter Instrument Reference Manual Calculating accuracy Instrument accuracy specifications can be expressed in a variety of ways. To illustrate how to calculate measurement errors from instrument specifications, the following topics provide examples of calculations. Calculating source or measure accuracy The source and measure accuracy specifications are expressed as a percent of reading or source value and an offset.
Page 261
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 6: Source-measure considerations Voltage measure accuracy: Input signal = (20 Ω x 100 mA) = 2 V Accuracy specification of 2 V range = ± (0.012% of output + 300 µV) = ±...
Section 6: Source-measure considerations Model 2470 High Voltage SourceMeter Instrument Reference Manual Offset-compensated ohm calculations Instrument operations, including offset-compensated ohms, are performed on the input signal in a sequential manner. For a normal resistance measurement, the 2470 sources a current (I) and measures the voltage (V).
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 6: Source-measure considerations High-capacitance operation The 2470 high-capacitance mode can prevent problems when you are measuring low current and driving a capacitive load. In this situation, you may see overshoot, ringing, and instability.
Section 6: Source-measure considerations Model 2470 High Voltage SourceMeter Instrument Reference Manual Using SCPI commands: Send the command: :SOURce:CURRent:HIGH:CAPacitance ON To turn on high capacitance for a voltage source, replace CURRent with VOLTage. Using TSP commands: Set the source function, then send the command: smu.source.highc = smu.ON Filtering measurement data Filters allow you to produce one averaged sample from a number of measurements.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 6: Source-measure considerations Moving average filter When the moving average filter is selected, the measurements are added to the stack continuously on a first-in, first-out basis. As each measurement is made, the oldest measurement is removed from the stack.
Section 6: Source-measure considerations Model 2470 High Voltage SourceMeter Instrument Reference Manual Using SCPI commands: To set the averaging filters using SCPI commands, refer to the following command descriptions: [:SENSe[1]]:<function>:AVERage:COUNt (on page 12-47) [:SENSe[1]]:<function>:AVERage[:STATe] (on page 12-48) [:SENSe[1]]:<function>:AVERage:TCONtrol (on page 12-51) Using TSP commands: To set the averaging filters using TSP commands, refer to the following command descriptions:...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 6: Source-measure considerations For more information on these operations, see the following topics: • Filtering measurement data (on page 6-26) • Relative offset (on page 5-29) • Calculations that you can apply to measurements (on page 5-32) •...
Page 268
Section 6: Source-measure considerations Model 2470 High Voltage SourceMeter Instrument Reference Manual Setting Default value on reset MENU > Measure > Calculations > Limit1 > Auto Clear :CALCulate2:<function>:LIMit<Y>:CLEar:AUTO (on page 12-19) smu.measure.limit[Y].autoclear (on page 14-158) –1 MENU > Measure > Calculations > Limit1 > Low Value :CALCulate2:<function>:LIMit<Y>:LOWer[:DATA] (on page 12-23) smu.measure.limit[Y].low.value...
Page 269
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 6: Source-measure considerations Format reset values Setting Default value on reset Not available from front panel :FORMat:BORDer (on page 12-38) Swapped format.byteorder (on page 14-96) Little endian Not available from front panel ASCII :FORMat[:DATA] (on page 12-39)
Page 270
Section 6: Source-measure considerations Model 2470 High Voltage SourceMeter Instrument Reference Manual Measurement reset values Setting Default value on reset Menu > Measure > Config List > New List None (existing configuration lists [:SENSe[1]]:CONFiguration:LIST:CREate (on page 12-67) deleted) smu.measure.configlist.create() (on page 14-140) Menu >...
Page 271
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 6: Source-measure considerations Source reset values Setting Default value on reset Menu > Source > Config List > New List None (existing configuration lists :SOURce[1]:CONFiguration:LIST:CREate (on page 12-75) deleted) smu.source.configlist.create() (on page 14-186) None (existing Menu >...
Page 272
Section 6: Source-measure considerations Model 2470 High Voltage SourceMeter Instrument Reference Manual Trigger reset values Setting Default value on reset Not available from front panel :TRIGger:BLENder<n>:MODE (on page 12-159) trigger.blender[N].orenable (on page 14-231) Not available from front panel Falling edge :TRIGger:DIGital<n>:IN:EDGE (on page 12-190) trigger.digin[N].edge...
Page 273
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 6: Source-measure considerations Setting Default value on reset Not available from front panel Falling Not applicable for SCPI trigger.tsplinkin[N].edge (on page 14-306) Not available from front panel Negative Not applicable for SCPI trigger.tsplinkout[N].logic (on page 14-309) Not available from front panel...
Section 7: Reading buffers Model 2470 High Voltage SourceMeter Instrument Reference Manual Getting started with buffers The following sections provide you with information to help you start using reading buffers. Remote buffer operation (on page 7-26) section provides additional information about accessing the reading buffers with remote commands.Types of reading buffers There are two default buffers, defbuffer1 and defbuffer2.
Page 276
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 7: Reading buffers Figure 97: Statistics swipe screen and active buffer indicator The MANAGE READING BUFFERS window displays buffer fill status as the Amount Filled, as shown in the following figure. Figure 98: MANAGE READING BUFFERS window 2470-901-01 Rev.
Section 7: Reading buffers Model 2470 High Voltage SourceMeter Instrument Reference Manual The System Events tab on the System Event Log menu (on page 4-38) displays the following buffer events: • Event code 4915, "Attempting to store past the capacity of reading buffer," which occurs when a buffer that is set to fill once is full.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 7: Reading buffers For a buffer that fills once, the first entry starts at index 1 with the timestamp in absolute time. For continuous buffers, the lowest timestamp is after the last entry. For example, if you take 150 readings into a buffer with a capacity of 100, the last reading is at entry 50 and the earliest reading is at 51.
Page 279
Section 7: Reading buffers Model 2470 High Voltage SourceMeter Instrument Reference Manual You can only select the style of the reading buffer when you first create the buffer. Not all remote commands are compatible with the compact, writable, and full writable buffer styles. Check the Details section of the command descriptions before using them with any of these buffer styles.
Page 280
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 7: Reading buffers 3. Select Buffer. 4. Select Create New. A keyboard is displayed. 5. Enter a name for the buffer you are creating. This figure uses the name testData. Figure 101: Buffer Name keyboard 6.
Page 281
Section 7: Reading buffers Model 2470 High Voltage SourceMeter Instrument Reference Manual 8. The Initial Capacity window is displayed. Enter the number of readings that the buffer will hold. To set the capacity to the maximum buffer size, based on the available memory of the instrument, enter 0.
Page 282
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 7: Reading buffers After you create a new reading buffer, the new reading buffer becomes the active buffer. Figure 105: Active buffer indicator You can select the reading buffer indicator to open a menu of available buffers. Select a buffer name in the list to make it the active reading buffer.
Section 7: Reading buffers Model 2470 High Voltage SourceMeter Instrument Reference Manual Setting reading buffer options You can specify the settings for the reading buffers. The settings you can select include: • Buffer capacity: The amount of data the buffer holds •...
Page 284
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 7: Reading buffers The 2470 notifies you when the system runs out of memory. If the instrument encounters memory allocation errors (errors that specifically state “Out of Memory”), the state of the instrument cannot be guaranteed.
Page 285
Section 7: Reading buffers Model 2470 High Voltage SourceMeter Instrument Reference Manual Using the front panel to set buffer capacity: When you resize a reading buffer, data in the buffer is cleared. 1. Press the MENU key. 2. Under Measure, select Reading Buffers. The MANAGE READING BUFFERS window is displayed.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 7: Reading buffers 5. Select OK. The MANAGE READING BUFFERS window is displayed. 6. Press the HOME key to return to the home screen. Using SCPI commands to set buffer capacity: To set the testData reading buffer to hold 300 readings, send the following command: TRACe:POINts 300, "testData"...
Page 287
Section 7: Reading buffers Model 2470 High Voltage SourceMeter Instrument Reference Manual Using the front panel to set fill mode: 1. Press the MENU key. 2. Under Measure, select Reading Buffers. The MANAGE READING BUFFERS window is displayed. Figure 108: MANAGE READING BUFFERS window 3.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 7: Reading buffers Using TSP commands to set a buffer fill mode: To set the testData reading buffer fill mode to continuous, send the following command: testData.fillmode = buffer.FILL_CONTINUOUS To set the defbuffer1 reading buffer fill mode to fill once, send the following command: defbuffer1.fillmode = buffer.FILL_ONCE To print the defbuffer1 fill mode setting, send the following command: print(defbuffer1.fillmode)
Page 289
Section 7: Reading buffers Model 2470 High Voltage SourceMeter Instrument Reference Manual 3. Select a reading buffer from the list. In the example below, testData is selected. Figure 110: MANAGE READING BUFFERS window 4. Select the Make Active button. The "Are you sure" dialog box is displayed. 5.
Page 290
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 7: Reading buffers To specify a user-defined reading buffer, you must create the buffer first. To select current as the measurement function, measure current, and return the readings in the testData reading buffer, send the following commands: :SENSe:FUNCtion "CURRent"...
Section 7: Reading buffers Model 2470 High Voltage SourceMeter Instrument Reference Manual Viewing and saving buffer content You can view the content of buffers from the front panel. You can also save the contents of the reading buffer to a USB flash drive. The stored file ®...
Page 292
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 7: Reading buffers The following table describes the information that is stored in each column of the spreadsheet. An F in a column indicates the corresponding heading item is false for that reading. For example, if an F is listed in the Math column, it indicates that the item was not used or did not occur on that reading.
Page 293
Section 7: Reading buffers Model 2470 High Voltage SourceMeter Instrument Reference Manual You can view data from the reading buffers through the front panel using the Reading Table. The Reading Table displays the following information: • Index: The sequential number of the reading. •...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 7: Reading buffers Using the front panel to store readings in the selected buffer Before you store readings, make sure the correct reading buffer is selected. See Selecting a buffer (on page 7-15) for more information. Each time a reading buffer is created, the instrument automatically selects the newly created buffer as the active buffer.
Page 295
Section 7: Reading buffers Model 2470 High Voltage SourceMeter Instrument Reference Manual Setting Description Time Format Sets the time format: ▪ Absolute: Each timestamp provides the time and date that the reading was made or the number of seconds from the first buffer reading that the reading was made.
Page 296
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 7: Reading buffers You only need to enter the name of the file you want to save. It is not necessary to enter the file extension. All files are saved as .csv files. 8.
Section 7: Reading buffers Model 2470 High Voltage SourceMeter Instrument Reference Manual Using TSP commands to save or append buffer content to files: Before using any of these commands, insert a USB flash drive into the USB port. To save readings from the default buffer to a file named myData.csv on a USB flash drive, send the following command: buffer.save(defbuffer1, "/usb1/myData.csv") To save readings from a reading buffer named testData to a file named myData.csv on...
Page 298
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 7: Reading buffers Using the front-panel Reading Buffers menu to clear a reading buffer: 1. Press the MENU key. 2. Under Measure, select Reading Buffers. The MANAGE READING BUFFERS window is displayed. 3.
Section 7: Reading buffers Model 2470 High Voltage SourceMeter Instrument Reference Manual Deleting buffers If you want to save the readings in a buffer before deleting the buffer, save the buffer to a USB flash drive. See Viewing and saving buffer content (on page 7-18) for details.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 7: Reading buffers Storing data in buffers Using SCPI commands: The table below lists the SCPI commands that you use for data storage. Command Description :TRACe:ACTual? This command contains the number of readings in the specified buffer.
Section 7: Reading buffers Model 2470 High Voltage SourceMeter Instrument Reference Manual Using TSP commands: Once you create a reading buffer using TSP commands, if you use that buffer name for another buffer or variable, you can no longer access the original buffer. The table below lists the TSP commands that you use for data storage.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 7: Reading buffers Accessing the data in buffers Using SCPI commands: To access a buffer, include the buffer name in the respective command. For example, the following commands: • Create a buffer named testData to store 100 readings •...
Section 7: Reading buffers Model 2470 High Voltage SourceMeter Instrument Reference Manual Buffer read-only attributes Use buffer read-only attributes to access the information contained in an existing buffer. Using SCPI commands: The following commands are available for each reading buffer. Attribute Description :TRACe:ACTual?
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 7: Reading buffers For example, to return the hours and minutes of the readings in defbuffer1, send the command: printbuffer(1, 5, defbuffer1.times) The return is similar to: 20:30:16, 20:30:16, 20:30:16, 20:30:16, 20:30:16 Reading buffer for .
Section 7: Reading buffers Model 2470 High Voltage SourceMeter Instrument Reference Manual Example columnar-delimited output of above code: -1.5794739960384e-09 Amp DC -1.5190692453926e-11 Amp DC 0.411046134 -2.9570144943758e-11 Amp DC 0.819675745 -2.9361919146043e-11 Amp DC 1.228263492 -3.0666566508408e-11 Amp DC 1.636753752 -4.0868204653766e-11 Amp DC 2.034403917 Writable reading buffers Writable reading buffers allow you to add external data manually to a user-defined buffer on...
Section 7: Reading buffers Model 2470 High Voltage SourceMeter Instrument Reference Manual The graph from the example looks similar to the following figure. Figure 115: Graph with data from a writable buffer with start group markers Apply mathematical expressions to reading buffer data You can apply a mathematical expression to a reading as it is stored in the reading buffer.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 7: Reading buffers Expression SCPI parameter Formula TSP parameter NONE No math applied Not applicable buffer.EXPR_NONE r + a buffer.EXPR_ADD AVERage Average buffer.EXPR_AVERAGE DIVide Divide buffer.EXPR_DIVIDE EXPonent Exponent buffer.EXPR_EXPONENT LOG10 Log10 buffer.EXPR_LOG10 MULTiply Multiply...
Section 7: Reading buffers Model 2470 High Voltage SourceMeter Instrument Reference Manual Using buffers across TSP-Link nodes After connecting two TSP-Link enabled instruments, you can access buffers over the TSP-Link network. For local node access to default and custom buffers, you do not need a TSP-Link node number.
Section 8 Graphing In this section: Introduction ................8-1 About the graph screens ............8-1 How to work with the graph ............8-3 Use the Graph swipe bar ............8-4 Change the data that is graphed ..........8-6 Add, remove, and clear traces ..........8-7 Active buffer ................
Page 311
Section 8: Graphing Model 2470 High Voltage SourceMeter Instrument Reference Manual Figure 116: Home screen with the GRAPH swipe screen displayed You can open the full graph by selecting the graph icon on the right side of the Graph swipe screen header.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 8: Graphing Use the measurement method indicator in the upper right corner of the screen to select the measurement method. Refer to Measurement method indicator (on page 4-13) and Setting up triggers (on page 8-9) for details.
Section 8: Graphing Model 2470 High Voltage SourceMeter Instrument Reference Manual You can pinch to zoom in the graph. You can also drag the graph to the left or right. When you adjust the view, the SmartScale feature is turned off. To turn SmartScale on again, select the icon in the upper right of the Graph tab.
Page 314
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 8: Graphing Figure 119: Scale swipe bar The Buffer Stats swipe bar displays statistics for the readings in the selected trace. If vertical cursors are displayed, the statistics reflect the value within the cursors. You can move the cursors to change the reported statistics.
Section 8: Graphing Model 2470 High Voltage SourceMeter Instrument Reference Manual When cursors are displayed, you can drag them to change their positions. You can also move the graph behind the cursors. To move the graph, select a portion of the graph that is not near a cursor and drag.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 8: Graphing Add, remove, and clear traces The graph plots data from reading buffers, which are set up on the Data tab as traces. The data from each buffer is shown as a separate trace on the Graph tab. You can select up to 20 traces.
Section 8: Graphing Model 2470 High Voltage SourceMeter Instrument Reference Manual Change the display of data You can set the drawing style and the graph type of the graph on the Data tab of the Graph screens. The drawing style determines how data is represented when there are many data points. You can select Line, Marker, or Both.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 8: Graphing If you are graphing more than one trace, you can set the Y-Axis Method to one of the following options: • Independent Autoscale: Scales the y-axis of the trace so it fits the height of the screen. •...
Section 8: Graphing Model 2470 High Voltage SourceMeter Instrument Reference Manual Types of triggers You can set triggers to be generated from the: • Digital Input Line: The trigger occurs when a pulse is detected from the digital input line. •...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 8: Graphing Delay The Delay is the length of time that occurs before the measurement occurs after detecting the selected source event trigger. You can select from 167 ns to 10 ks. Select 0 to set no delay.
Section 8: Graphing Model 2470 High Voltage SourceMeter Instrument Reference Manual About the Histogram screen The Histogram tab graphs readings as a bar graph of the data distribution into bins. To view the histogram, select the MENU key, then select Histogram. An example of the histogram screen is shown in the following figure.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 8: Graphing You can pinch to zoom into or out of data on the histogram. You can also swipe the histogram to the left or right. When you adjust the view, the SmartScale feature is turned off.
Page 323
Section 8: Graphing Model 2470 High Voltage SourceMeter Instrument Reference Manual Add, remove, and clear traces The histogram plots data from reading buffers, which are set up on the Data tab. The data from each buffer is shown as a separate trace on the Histogram tab. You can select up to 20 traces.
Page 324
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 8: Graphing Change the scale of the histogram The Scale tab contains settings that allow you to fine-tune the display of data on the Histogram tab. You can select automatic scaling or specific values for the bins and boundaries.
Section 9 Triggering In this section: Measurement methods ............9-1 Triggering ................. 9-3 Digital I/O ................9-13 Trigger model ................. 9-27 Measurement methods Triggers are signals that instruct the instrument to make a measurement. You can set the 2470 to use the following triggering measurement methods: •...
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual Trigger key triggering When you select the Manual Trigger Mode from the 2470 front-panel, the instrument only makes a measurement when you press the front-panel TRIGGER key. The instrument stores the readings in the active reading buffer. See Reading buffers page 7-1) for detail on the buffer options that are available.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering Triggering Triggering allows you to start and synchronize source and measure actions on one or more instruments with a trigger event or a combination of trigger events that you set. This section describes some of the options available for triggering, including command interface triggering, timers, and event blenders.
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual Triggering using hardware lines You can use the digital I/O lines and TSP-Link synchronization lines to synchronize the operations of the 2470 with those of external instruments. You can use these lines to synchronize the 2470 with other TSP-enabled instruments, including other 2470 instruments.
Page 329
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering LXI trigger edge detection Stateless event Hardware Pseudo-line Falling edge Rising edge flag value state Detected Detected Detected Detected Detected Detected Detected Detected You can set the LAN trigger edge detection method in incoming LXI trigger packets. The edge that is selected also determines the hardware value in outgoing LXI trigger packets.
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual Trigger timers You can assign trigger timers in trigger model wait, branch on event, and notify blocks. If you are using remote commands, you can set the trigger timers to be the stimulus for the LAN, blender, or TSP-Link output.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering Using SCPI commands: To set up a 50 µs trigger timer delay for timer 2, send the command: TRIGger:TIMer2:DELay 50E-6 Using TSP commands: To set up a 50 µs trigger timer delay for timer 2, send the command: trigger.timer[2].delay = 50e-6 To set up a delay list for timer 3 for delays of 2, 10, 15, and 7 s, send the command: trigger.timer[3].delaylist = {2, 10, 15, 7}...
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual TSP example trigger.timer[4].reset() trigger.timer[4].delay = 0.5 trigger.timer[4].start.stimulus = trigger.EVENT_NOTIFY5 trigger.timer[4].start.generate = trigger.OFF trigger.timer[4].count = 20 trigger.timer[4].enable = trigger.ON You can also set a time when the timer will start using the seconds and fractional seconds commands.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering Some attributes of trigger timers should not be used with the trigger model. Attributes you should not set are: ▪ Count value of 0 (resulting in generation of trigger events indefinitely) ▪...
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual Event blenders The ability to combine trigger events is called event blending. You can use an event blender to wait for up to four input trigger events to occur before responding with an output event. You set the event blender operation using remote commands.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering Trigger blender action overruns The event blenders can generate action overruns. When the event blender operation is set to AND, overruns occur when a second event on any of its inputs is detected before an output event is generated. When the operation is set to OR, overruns occur when two events are detected simultaneously.
Page 336
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual The programming example below generates output triggers using the assert function of the trigger object. -- Generate a 20 us pulse on digital I/O line 3. digio.line[3].mode = digio.MODE_TRIGGER_OUT trigger.digout[3].pulsewidth = 20e-6 trigger.digout[3].assert() -- Generate a rising edge trigger on TSP-Link sync line 1.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering 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. When the trigger is received, the instrument performs a voltage reading.
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual Digital I/O connector and pinouts The digital I/O port uses a standard female DB-9 connector, located on the rear panel of the 2470. You can connect to the 2470 digital I/O using a standard male DB-9 connector. The port provides a connection point to each of the six digital I/O lines and other connections, as shown in the following table.
Page 339
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering Figure 125: Digital I/O port configuration For additional details about the digital output, see the 2470 specifications (available at tek.com/support). Vext line The digital I/O port provides a line (V ) with a flyback diode clamp that you can use when controlling inductive circuitry such as relay coils or low-power solenoids.
Page 340
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual Refer to the following figure for a simplified schematic of a sample control circuit for a relay. You can externally power a different device by replacing the relay coil with the other device. The relay is actuated by configuring the corresponding digital output line.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering Digital I/O lines You can place each digital I/O line into one of the following modes: • Digital open-drain, output, or input • Trigger open-drain, output, or input • Trigger synchronous master or acceptor When you configure the digital I/O lines for triggering applications, configure the output lines before the input lines.
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual Input The input mode is similar to the open-drain mode, except that a line in this mode is intended to be used strictly as an input. When you place a line in input mode, the instrument automatically writes a 1 to the line to enable it to detect externally generated logic levels.
Page 343
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering To use the line only as a trigger input: 1. Reset the line. 2. Set the input trigger edge detection type to falling, rising, or either. The command that sets the detection type automatically sets the line high. This enables the line to respond to and detect externally generated triggers.
Page 344
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual Synchronous triggering The synchronous triggering modes allow you to: • Implement bidirectional triggering on a single trigger line • Start operations on one or more external instruments using a single trigger line •...
Page 345
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering 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. • A rising edge is not detected until all external drives release the line and the line floats high.
Page 346
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual Synchronous acceptor Use the synchronous acceptor trigger mode with the synchronous master mode or its non- Keithley equivalent. Only one instrument should be configured as a synchronous master. All other instruments connected to the synchronization line must be configured as synchronous acceptor or equivalent.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering Output characteristics: • In addition to trigger events from other trigger objects, the TSP commands trigger.digout[N].assert() and trigger.tsplinkout[N].assert() also trigger events. • The physical line state does not change until all drives (internal and external) release the line.
Page 348
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual SCPI command TSP command Description :DIGital:LINE<n>:MODE (on page 12-26) This command sets the mode of the digital I/O line to be a digital line, trigger line, or synchronous line and digio.line[N].mode (on page 14-63) sets the line to be input, output, or open-drain.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering Digital I/O bit weighting Bit weighting for the digital I/O lines is shown in the following table. Line 1 is the least significant bit. Line # Decimal Hexadecimal Binary 0x01 000001 0x02...
Page 350
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual Using TSP commands to set the state of each line individually: digio.line[1].state = digio.STATE_HIGH digio.line[2].state = digio.STATE_LOW digio.line[3].state = digio.STATE_HIGH -- You can use 0 instead of digio.STATE_LOW. digio.line[4].state = 0 -- You can use 1 instead of digio.STATE_HIGH.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering Using TSP commands: -- Configure all six digital I/O lines as digital inputs. -- You can also use a for loop. digio.line[1].mode = digio.MODE_DIGITAL_IN digio.line[2].mode = digio.MODE_DIGITAL_IN digio.line[3].mode = digio.MODE_DIGITAL_IN digio.line[4].mode = digio.MODE_DIGITAL_IN digio.line[5].mode = digio.MODE_DIGITAL_IN digio.line[6].mode = digio.MODE_DIGITAL_IN...
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual Additional options are detailed in the following sections. The 2470 includes trigger-model templates to allow you to quickly implement a trigger model. You can also set up your own trigger models. TriggerFlow Trigger Model The TriggerFlow Trigger Model diagram on the front panel provides an interactive visual...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering Trigger-model blocks Each trigger model consists of blocks that can be combined to create the trigger model. The blocks can be combined from the front panel or by sending remote commands. You can connect a maximum of 63 blocks as needed to control the instrument.
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual If you set the count to infinite, the trigger model executes subsequent blocks when the measurement is made; the triggering of measurements continues in the background until the trigger model execution reaches another measure/digitize block or until the trigger model ends.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering Timing blocks You can use the timing blocks to control the timing of actions in the trigger model. The timing blocks include the wait and delay blocks. Wait block The wait block causes the trigger model to stop and wait for an event or set of events to occur before continuing.
Page 356
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual Event Description Blender Wait for the events set by an event blender. Command A command interface trigger: ▪ Any remote interface: *TRG ▪ GPIB only: GET bus command ▪ USB only: A USBTMC TRIGGER message ▪...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering Dynamic delay block When trigger model execution reaches a dynamic delay block, it stops normal measurement and trigger model operation for the time set by the delay. Background measurements continue to be made.
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual Setting up the notify block using remote commands: When you set up the notify block using remote commands, you define the notify event number. You need to set up the lines that use the notify event as a stimulus as separate commands.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering When you select the Log Event block, the following options are available. Setting Description Event Type The event number or type: ▪ Abort Model: Stop the trigger model and log a warning message ▪...
Page 360
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual The configuration lists must be defined before you can use this block. If one of the indices for the configuration list changes, verify that the trigger model count is still accurate. If you need to swap the source and measure configuration lists, you need to delete this block and create a new Config List Recall block.
Page 361
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering When you select the Config List Next block, the following option is available. Setting Description Config List The name of the configuration list from which to recall the next index. Config List 2 The name of the second configuration list to recall the index from;...
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual When you select the config list prev block, the following option is available. Setting Description Config List The name of the configuration list from which to recall the previous index. Config List 2 The name of the second configuration list to recall the index from;...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering Branching blocks A branch block goes to a trigger block other than the sequential execution block. For example, if you need to set up the trigger model to wait for an event under some conditions but not others, you can use a branch block to define when the wait block is enabled.
Page 364
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual Trigger events are reset when the trigger model is at the start block, so only events that occur after you start trigger model execution are detected by the branch-on-event block. The event is also reset after trigger model execution completes the branching block.
Page 365
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering Constant Limit block The Branch Constant Limit block defines a trigger model block that goes to a specified block if a measurement meets preset criteria. The measurement block must be a measurement block that occurs in the trigger model before the branch-on-constant-limits block.
Page 366
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual When you select a Limit Type of Inside or Outside, two buttons display below the Limit Type button. The button on the left is the Low Limit and the button on the right is the High Limit. Dynamic Limit block The branch-on-dynamic-limits block defines a trigger model block that goes to a specified block in the trigger model if a measurement meets user-defined criteria.
Page 367
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering Delta block The branch on delta block defines a trigger model block that goes to a specified block if the difference of two measurements meets preset criteria. This block calculates the difference between the last two measurements from a measure/digitize block.
Page 368
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual Once block When the trigger model reaches a branch-once block, it goes to a specified block the first time it is encountered in the trigger model. If it is encountered again, the trigger model ignores the block and continues in the normal sequence.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering Trigger block summary Front-panel icon SCPI command Block description TSP command Not applicable :TRIGger:BLOCk:LIST? (on page 12-180) This returns the settings for all trigger model trigger.model.getblocklist() (on page 14-254) blocks :TRIGger:BLOCk:BRANch:ALWays (on page 12-162)
Page 370
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual Front-panel icon SCPI command Block description TSP command :TRIGger:BLOCk:BRANch:ONCE (on page 12-171) This causes the trigger model to branch to a trigger.model.setblock() — trigger.BLOCK_BRANCH_ONCE (on page specified building 14-275) block the first time it is encountered in the trigger model...
Page 371
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering Front-panel icon SCPI command Block description TSP command :TRIGger:BLOCk:DIGital:IO (on page 12-179) This trigger model block that sets the trigger.model.setblock() — trigger.BLOCK_DIGITAL_IO lines on the digital (on page 14- I/O port high or low 284) :TRIGger:BLOCk:LOG:EVENt...
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual Trigger-model templates The 2470 includes trigger-model templates for common applications. You can use these templates without changing them, or you can modify them to meet the needs of your application.
Page 373
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering Preparations for using a trigger-model template Before starting the trigger model, you need to set up your instrument for testing, including the source and measure settings and source and measure configuration lists. When you load a trigger-model template, the instrument overwrites any existing trigger models.
Page 374
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual 10. Press the TRIGGER key to initiate the trigger model. Using SCPI commands: See the descriptions of the TRIGger:LOAD commands for details on the options available for each trigger-model template. •...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering Assembling trigger-model blocks This section describes the basic concepts you need to understand to assemble trigger-model blocks. Sequencing trigger-model blocks You can set up trigger-model blocks from the front panel or by using remote commands. Trigger-model blocks must be sequenced in order;...
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual Determining the structure of the existing trigger model You can retrieve the existing trigger model structure from the front panel or by using remote commands. Using the front panel: 1.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering Action overruns An action overrun occurs when a trigger object receives a trigger event and is not ready to act on it. The action overruns of all trigger objects are reported in a command for the associated trigger object.
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual Starting the trigger model Using the front panel: 1. Press the front-panel TRIGGER key for 2 s. A dialog box displays the available trigger methods. The presently selected method is highlighted. 2.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering Pausing and resuming the trigger model You can pause the trigger model while it is in progress by using the pause command. To restart the trigger model after pausing, use the resume command. Using SCPI commands: To pause, send the command: :TRIGger:PAUSe...
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual Using the front panel The state of the trigger model is indicated on the status bar with the indicators shown in the previous table. Using SCPI commands: Send the command: :TRIGger:STATe? The return shows the state and the block that was last executed.
Page 381
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering Trigger events — SCPI command set Trigger events Event description Event constant BLENder<n> Trigger event blender <n> (up to two), which combines trigger events COMMand A command interface trigger: ▪...
Section 9: Triggering Model 2470 High Voltage SourceMeter Instrument Reference Manual Using the TRIGGER key to generate an event You can use the front-panel TRIGGER key to generate a trigger event. For example, if you set a wait block to advance when the TRIGGER key is pressed, the trigger model will reach the wait block.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 9: Triggering Respond to an event with a wait block The wait building block causes the trigger model to stop and wait for an event or set of events to occur before continuing. You can specify up to three events for each wait block. The wait block can use any of the system trigger events.
Section 10 TSP-Link and TSP-Net In this section: TSP-Link System Expansion Interface ........10-1 TSP-Net ................10-14 TSP-Link System Expansion Interface Keithley TSP-Link is a high-speed trigger synchronization and communications bus that test system builders can use to connect multiple instruments in a master and subordinate configuration.
Page 385
Section 10: TSP-Link and TSP-Net Model 2470 High Voltage SourceMeter Instrument Reference Manual Figure 132: TSP-Link connections Item Description Notes Controller Optional. A computer is not needed for stand-alone systems. Communications connection Optional. Connection from controller to the master node through GPIB, LAN, or USB. Details about these computer communications connections are described in Remote communications interfaces...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 10: TSP-Link and TSP-Net TSP-Link nodes Each instrument or enclosure attached to the TSP-Link expansion interface is called a node. Each node must be identified with a unique node number. This identification is called a TSP-Link node number.
Section 10: TSP-Link and TSP-Net Model 2470 High Voltage SourceMeter Instrument Reference Manual Master and subordinates In a TSP-Link system, one of the nodes (instruments) is the master node and the other nodes are the subordinate nodes. The master node in a TSP-Link system can control the other nodes (subordinates) in the system.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 10: TSP-Link and TSP-Net If initialization is not successful, you can check the event log for error messages that indicate the problem. Some typical problems include: • Two or more instruments in the system have the same node number •...
Section 10: TSP-Link and TSP-Net Model 2470 High Voltage SourceMeter Instrument Reference Manual Using the reset() command system operations target a single node in the system, but the reset() Most TSP-Link command affects the system as a whole by resetting all nodes to their default settings: -- Reset all nodes in a TSP-Link system to their default state.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 10: TSP-Link and TSP-Net Triggering using TSP-Link trigger lines The 2470 has three trigger lines that you can use for triggering, digital I/O, and to synchronize multiple instruments on a TSP-Link network.
Section 10: TSP-Link and TSP-Net Model 2470 High Voltage SourceMeter Instrument Reference Manual TSP-Link network group functions Group Group members Present function number Master node 1 Initiates and runs a test script on node 2 Initiates and runs a test script on node 6 In addition, the master node can execute scripts and process run commands Group leader node 2...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 10: TSP-Link and TSP-Net The group leader: • Performs operations initiated by the master node • Initiates remote operations on any node with the same group number • Cannot initiate remote operations on any node with a different group number •...
Section 10: TSP-Link and TSP-Net Model 2470 High Voltage SourceMeter Instrument Reference Manual The programming example below demonstrates how to run a test script that is defined on a remote node. For this example, scriptVar is defined on the remote node. To run a script defined on the remote node: node[N].execute("scriptVar()") It is recommended that you copy large scripts to a remote node to improve system...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 10: TSP-Link and TSP-Net Using the data queue for real-time communications Nodes that are running test scripts at the same time can store data in the data queue for real-time communications. Each instrument has an internal data queue that uses the first-in, first-out (FIFO) structure to store data.
Page 395
Section 10: TSP-Link and TSP-Net Model 2470 High Voltage SourceMeter Instrument Reference Manual TSP-Link commands Command Description trigger.tsplinkin[N].clear() (on page 14-305) Clears the event detector for a trigger trigger.tsplinkin[N].edge (on page 14-306) Indicates which trigger edge controls the trigger event detector for a trigger line trigger.tsplinkin[N].overrun (on page 14-307) Indicates if the event detector ignored an event...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 10: TSP-Link and TSP-Net The output would be similar to: To read bit B1 only: -- To read bit B1 only data = tsplink.line[1].state print(data) The output would be similar to: tsplink.STATE_HIGH Using 2470 TSP-Link commands with other TSP-Link products If you are connecting the 2470 in a system with other TSP-Link products, be aware that...
Section 10: TSP-Link and TSP-Net Model 2470 High Voltage SourceMeter Instrument Reference Manual TSP-Net TSP-Net provides a simple socket-like programming interface to Test Script Processor (TSP) enabled instruments. Using the TSP-Net library, the 2470 can control ethernet-enabled devices directly through its LAN port. This enables the 2470 to communicate directly with a device that is that is not TSP-enabled without the use of a controlling computer.
Page 398
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 10: TSP-Link and TSP-Net To set up communications to a remote ethernet-enabled instrument that is TSP enabled: 1. Send the following command to configure TSP-Net to send an abort command when a connection to a TSP instrument is established: tspnet.tsp.abortonconnect = 1 If the scripts are allowed to run, the connection is made, but the remote instrument may...
Section 10: TSP-Link and TSP-Net Model 2470 High Voltage SourceMeter Instrument Reference Manual To communicate to a remote ethernet device from the 2470: 1. Connect to the remote device using one of the above procedures. If the 2470 cannot make a connection to the remote device, it generates a timeout event. Use tspnet.timeout to set the timeout value.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 10: TSP-Link and TSP-Net Remote instrument events If the 2470 is connected to a TSP-enabled instrument through TSP-Net, all events that occur on the remote instrument are transferred to the event log of the 2470. The 2470 indicates events from the remote instrument by prefacing these events with “Remote Error.”...
Section 10: TSP-Link and TSP-Net Model 2470 High Voltage 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-->...
Section 11 Introduction to SCPI commands In this section: Introduction to SCPI ............... 11-1 SCPI command programming notes ........11-3 Acquiring readings using SCPI commands ......11-10 Introduction to SCPI The Standard Commands for Programmable Instruments (SCPI) standard is a syntax and set of commands that are used to control test and measurement devices.
Page 403
Section 11: Introduction to SCPI commands Model 2470 High Voltage SourceMeter Instrument Reference Manual Many commands have query options. If there is a query option, it is created by adding a question mark (?) to the command. For example, to query the present ethernet settings, send: :SYSTem:COMMunication:LAN:CONFigure? Commands often take parameters.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 11: Introduction to SCPI commands Each new command message resets the parser path as if it were sent with the leading colon. The output for both queries is: 0.5;1 A command string sent to the instrument must terminate with a <new line> character. The IEEE-488.2 EOI (end-or-identify) message is interpreted as a <new line>...
Section 11: Introduction to SCPI commands Model 2470 High Voltage SourceMeter Instrument Reference Manual Optional command words If a command word is enclosed in brackets ([ ]), the command word is optional. Do not include the brackets if you send the optional command word to the instrument. For example, you can send the command :SYSTem:BEEPer[:IMMediate] <n1>, <n2>...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 11: Introduction to SCPI commands SCPI parameters The parameters of the SCPI commands are shown in angle brackets (< >). For example: :SYSTem:BEEPer[:IMMediate] <frequency>, <duration> The type of information that you can use to replace <frequency> and <duration> is defined in the Usage section of the command description.
Section 11: Introduction to SCPI commands Model 2470 High Voltage SourceMeter Instrument Reference Manual Figure 133: SCPI command description example Each command listing is divided into five subsections that contain information about the command: • Command name and summary table •...
Page 408
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 11: Introduction to SCPI commands Figure 134: SCPI command name and summary table Instrument command name. Signals the beginning of the command description and is followed by a brief description of what the command does. Type of command.
Page 409
Section 11: Introduction to SCPI commands Model 2470 High Voltage SourceMeter Instrument Reference Manual Command usage The Usage section of the remote command listing shows how to properly structure the command. Each line in the Usage section is a separate variation of the command usage; all possible command usage options are shown here.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 11: Introduction to SCPI commands Command details This section lists additional information you need to know to successfully use the command. Figure 136: Details section of command listing Example section The Example section of the command description shows some simple examples of how the command can be used.
Section 11: Introduction to SCPI commands Model 2470 High Voltage SourceMeter Instrument Reference Manual Acquiring readings using SCPI commands The following table summarizes SCPI commands that acquire and return readings. Command Description FETCh? Returns the specified data elements from the most recent reading. This command does not trigger source-measure operations.
Page 413
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual To change the number of digits returned in a remote command reading, use the :FORMat:ASCii:PRECision command. You can send :FETCh? while a trigger model is running. When specifying buffer elements, you can: •...
Page 414
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference The output of :FETCh? is affected by the data format selected by :FORMat[:DATA]. If you set FORMat[:DATA] to REAL or SREAL, you will have fewer options for buffer elements. The only buffer elements available are READing, RELative, SOURce, and EXTRa.
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :MEASure? This command makes measurements, places them in a reading buffer, and returns the last reading. Type Affected by Where saved Default value Query only Not applicable Not applicable Not applicable Usage...
Page 416
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference To change the number of digits returned in a remote command reading, use the :FORMat:ASCii:PRECision command. When specifying buffer elements, you can: • Specify buffer elements in any order. •...
Page 417
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual The output of :MEASure? is affected by the data format selected by :FORMat[:DATA]. If you set FORMat[:DATA] to REAL or SREAL, you will have fewer options for buffer elements.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :READ? This command makes measurements, places them in a reading buffer, and returns the last reading. Type Affected by Where saved Default value Query only Not applicable Not applicable Not applicable Usage...
Page 419
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual The options for <bufferElements> are described in the following table. Option Description DATE The date when the data point was measured FORMatted The measured value as it appears on the front panel FRACtional The fractional seconds for the data point when the data point was measured READing...
Page 420
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Buffer status bits for sense measurements Bit (hex) Name Decimal Description 0x0001 STAT_QUESTIONABLE Measure status questionable 0x0006 STAT_ORIGIN A/D converter from which reading originated; for the 2470, this will always be 0 (main) 0x0008 STAT_TERMINAL Measure terminal, front is 1, rear is 0...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual *RCL This command returns the instrument to the setup that was stored in a specified memory location. Type Affected by Where saved Default value Command only Not applicable Not applicable Not applicable Usage...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Settings made on the Graph and Histogram tabs are not saved as part of a saved setup. To record graph settings, you can press HOME and ENTER to save an image of the settings with the screen capture feature.
Page 423
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details This specifies which math operation is performed on measurements for the selected measurement function. You can choose one of the following math operations: • y = mx+b: Manipulate normal display readings by adjusting the m and b factors. •...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :CALCulate[1]:<function>:MATH:MBFactor This command specifies the offset, b, for the y = mx + b operation. Type Affected by Where saved Default value Command and query Recall settings Save settings Instrument reset Measure configuration list...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example :CALC:VOLT:MATH:FORM MXB Set the math function for voltage measurements to mx+b. :CALC:VOLT:MATH:MMF 0.80 Set the scale factor for voltage measurements to 0.80. :CALC:VOLT:MATH:MBF 50 Set the offset factor to 50. :CALC:VOLT:MATH:STAT ON Enable the math function.
Page 426
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Details This command sets the scale factor (m) for an mx+b operation for the selected measurement function. The mx+b math operation lets you manipulate normal display readings (x) mathematically according to the following calculation: y = mx + b Where:...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :CALCulate[1]:<function>:MATH:PERCent This command specifies the reference constant that is used when math operations are set to percent. Type Affected by Where saved Default value Command and query Recall settings Save settings Instrument reset...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :CALCulate[1]:<function>:MATH:STATe This command enables or disables math operation. Type Affected by Where saved Default value Command and query Recall settings Save settings OFF (0) Instrument reset Measure configuration list Power cycle Measure configuration list Usage...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :CALCulate2:<function>:LIMit<Y>:AUDible This command determines if the instrument beeper sounds when a limit test passes or fails. Type Affected by Where saved Default value Command and query Recall settings Save settings NONE Instrument reset...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :CALCulate2:<function>:LIMit<Y>:CLEar:AUTO This command indicates if the test result for limit Y should be cleared automatically or not. Type Affected by Where saved Default value Command and query Recall settings Save settings ON (1)
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example :CALC2:VOLT:LIM1:CLE:AUTO ON Set limit autoclear on. :CALC2:VOLT:LIM1:AUD FAIL Enable the beeper for limit 1 when a voltage measurement :CALC2:VOLT:LIM1:LOW 0.25 exceeds the limit. :CALC2:VOLT:LIM1:UPP 2.5 Set lower limit 1 for voltage to 0.25 V. :CALC2:VOLT:LIMIT1:STAT ON Set upper limit 1 for voltage to 2.5 V.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Example :CALC2:VOLT:LIM1:CLE:AUTO OFF Set limit autoclear off. :CALC2:VOLT:LIM1:AUD FAIL Enable the beeper for limit 1 when a voltage measurement :CALC2:VOLT:LIM1:LOW 0.25 exceeds the limit. :CALC2:VOLT:LIM1:UPP 2.5 Set lower limit 1 for voltage to 0.25 V. :CALC2:VOLT:LIMIT1:STAT ON Set upper limit 1 for voltage to 2.5 V.
Page 433
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual The results of the limit test for limit Y: • NONE: Test passed; the measurement is between the upper and lower limits • HIGH: Test failed; the measurement exceeded the upper limit •...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :CALCulate2:<function>:LIMit<Y>:LOWer[:DATA] This command specifies the lower limit for a limit test. Type Affected by Where saved Default value −1 Command and query Recall settings Save settings Instrument reset Measure configuration list Power cycle Measure configuration list...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :CALCulate2:<function>:LIMit<Y>:STATe This command enables or disables a limit test on the measurement from the selected measure function. Type Affected by Where saved Default value Command and query Recall settings Save settings OFF (0)
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Also see :CALCulate2:<function>:LIMit<Y>:CLEar:AUTO (on page 12-19) :CALCulate2:<function>:LIMit<Y>:CLEar[:IMMediate] (on page 12-20) :CALCulate2:<function>:LIMit<Y>:FAIL? (on page 12-21) :CALCulate2:<function>:LIMit<Y>:LOWer[:DATA] (on page 12-23) :CALCulate2:<function>:LIMit<Y>:UPPer[:DATA] (on page 12-25) :CALCulate2:<function>:LIMit<Y>:UPPer[:DATA] This command specifies the upper limit for a limit test. Type Affected by Where saved...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example :CALC2:VOLT:LIM1:CLE:AUTO OFF Set limit autoclear off. :CALC2:VOLT:LIM1:AUD FAIL Enable the beeper for limit 1 when a voltage measurement :CALC2:VOLT:LIM1:LOW 0.25 exceeds the limit. :CALC2:VOLT:LIM1:UPP 2.5 Set lower limit 1 for voltage to 0.25 V. :CALC2:VOLT:LIMIT1:STAT ON Set upper limit 1 for voltage to 2.5 V.
Page 438
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Details You can specify the line type and line direction parameters to configure each digital I/O line into one of the following modes: • Digital open-drain, output, or input •...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :DIGital:LINE<n>:STATe This command sets a digital I/O line high or low when the line is set for digital control and returns the state on the digital I/O lines. Type Affected by Where saved...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :DIGital:READ? This command reads the digital I/O port. Type Affected by Where saved Default value Query only Not applicable Not applicable Not applicable Usage :DIGital:READ? Details The binary equivalent of the returned value indicates the value of the input lines on the digital I/O port.
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :DIGital:WRITe <n> This command writes to all digital I/O lines. Type Affected by Where saved Default value Command only Not applicable Not applicable Not applicable Usage :DIGital:WRITe <n> <n>...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference DISPlay subsystem This subsystem contains commands that control the front-panel display. :DISPlay:BUFFer:ACTive This command determines which buffer is used for measurements that are displayed on the front panel. Type Affected by Where saved...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :DISPlay:<function>:DIGits This command determines the number of digits that are displayed for measurements on the front panel. Type Affected by Where saved Default value Command and query Recall settings Save settings Measure: 5...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Example :DISP:CURR:DIG 5 Set the front panel to display current measurements with 5½ digits. Also see :FORMat:ASCii:PRECision (on page 12-37) :DISPlay:LIGHt:STATe This command sets the light output level of the front-panel display. Type Affected by Where saved...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :DISPlay:READing:FORMat This command determines the format that is used to display measurement readings on the front-panel display of the instrument. Type Affected by Where saved Default value Command and query Not applicable Nonvolatile memory...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :DISPlay:SCReen This command changes which front-panel screen is displayed. Type Affected by Where saved Default value Command only Not applicable Not applicable Not applicable Usage :DISPlay:SCReen <screenName> <screenName>...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :DISPlay:USER<n>:TEXT[:DATA] This command defines the text that is displayed on the front-panel USER swipe screen. Type Affected by Where saved Default value Command only Power cycle Not applicable Not applicable Instrument reset Usage...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference FORMat subsystem The commands for this subsystem select the data format that is used to transfer instrument readings over the remote interface. :FORMat:ASCii:PRECision This command sets the precision (number of digits) for all numbers returned in the ASCII format. Type Affected by Where saved...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :FORMat:BORDer This command sets the byte order for the IEEE Std 754 binary formats. Type Affected by Where saved Default value Command and query Recall settings Save settings SWAP Instrument reset Power cycle...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :FORMat[:DATA] This command selects the data format that is used when transferring readings over the remote interface. Type Affected by Where saved Default value Command and query Recall settings Save settings Instrument reset...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual OUTPut subsystem The output subsystem provides information and settings that control the output of the selected source. :OUTPut[1]:<function>:SMODe This command defines the state of the source when the output is turned off. Type Affected by Where saved...
Page 452
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference When the high-impedance output-off state is selected and the output is turned off: • The measurement sense is set to 2-wire • The output relay opens, disconnecting the instrument as a load Opening the relay disconnects external circuitry from the inputs and outputs of the instrument.
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example :OUTP:CURR:SMOD HIMP Sets the output-off state for the current function so that the instrument opens the output relay when the output is turned off. Also see Output-off state (on page 2-26) :OUTPut[1][:STATe]...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference If you try to assign a high-voltage output and turn the source on when the interlock is not asserted, event code 5074, “Output voltage limited by interlock,” is generated. Note that the SOURCE swipe screen displays the value that is selected for the voltage source.
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example OUTP:INT:TRIP? If the interlock is not asserted, returns 0. If the interlock is asserted, returns 1. Also see None :OUTPut[1][:STATe] This command enables or disables the source output. Type Affected by Where saved...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference ROUTe subsystem The ROUTe subsystem selects which set of input and output terminals to enable (front panel or rear panel). :ROUTe:TERMinals This command describes which set of input and output terminals the instrument is using. Type Affected by Where saved...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual SCRipt subsystem The SCRipt subsystem controls macro or instrument setup scripts. For additional information on macro scripts, refer to Saving front-panel settings into a macro script (on page 4-58). :SCRipt:RUN This command runs a script.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference SENSe1 subsystem The SENSe1 subsystem commands configure and control the measurement functions of the instrument. Many of these commands are set for a specific function (current, voltage, or resistance). For example, you can program a range setting for each function.
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example 1 CURR:AVER:COUNT 10 For current measurements, set the averaging filter type to CURR:AVER:TCON MOV moving average, with a filter count of 10. CURR:AVER ON Enable the averaging filter. Example 2 RES:AVER:COUNT 10 For resistance measurements, set the averaging filter type to...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference If you send this command without the <function> parameter, it sets the state of the averaging filter for all functions. Example 1 CURR:AVER:COUNT 10 Set the averaging filter type to moving average, with a filter CURR:AVER:TCON MOV count of 10.
Page 461
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details To ensure the accuracy of readings, the instrument must periodically get new measurements of its internal ground and voltage reference. The time interval between updates to these reference measurements is determined by the integration aperture that is being used for measurements.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference [:SENSe[1]]:<function>:AVERage:TCONtrol This command sets the type of averaging filter that is used for the selected measure function when the measurement filter is enabled. Type Affected by Where saved Default value Command and query Recall settings...
Page 463
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual The repeating average filter produces slower results but produces more stable results than the moving average filter. For either method, the greater the number of measurements that are averaged, the slower the averaged sample rate, but the lower the noise error.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference [:SENSe[1]]:<function>:DELay:USER<n> This command sets a user-defined delay that you can use in the trigger model. Type Affected by Where saved Default value Command and query Recall settings Save settings 0 (0 s) Instrument reset...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual [:SENSe[1]]:<function>:NPLCycles This command sets the time that the input signal is measured for the selected function. Type Affected by Where saved Default value Command and query Recall settings Save settings Instrument reset Measure configuration list...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Example 1 CURR:NPLC 0.5 Sets the measurement time for current measurements to 0.0083 s (0.5/60). Example 2 RES:NPLC 0.5 Sets the measurement time for resistance measurements to 0.0083 s (0.5/60).
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example *RST Reset the instrument. :SENS:FUNC "RES" Set the measurement function to resistance :SENS:RES:RANG:AUTO ON and set the range to automatic. :RES:OCOM ON Turn offset-compensated ohms on. :COUNT 5 Set the measurement count to 5.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference If a range is manually selected through the front panel or a remote command, this command is automatically set to off. Example RES:RANG:AUTO ON Set the range to be selected automatically for resistance measurements.
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Though you can send any value when you send this command, the instrument selects the next highest range value. For example, if you send 15 for the lowest voltage range, the instrument will be set to the 20 V range as the low limit.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference When autorange rebound is enabled, it prevents the source from being limited to a value that is below the source limit. After an autoranged measurement is made, the measure range is restored to match the limit range once the autoranged measurement is complete.
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual For resistance measurements, you can use this command when automatic range selection is enabled to put an upper bound on the range that is used for resistance measurements. The upper limit must be more than the lower limit.
Page 472
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference This command is primarily intended to eliminate the time that is required by the instrument to automatically search for a range. When a range is fixed, any signal greater than the entered range generates an overrange condition.
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual [:SENSe[1]]:<function>:RELative This command contains the relative offset value. Type Affected by Where saved Default value Command and query Recall settings Save settings Instrument reset Measure configuration list Power cycle Measure configuration list Usage...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference [:SENSe[1]]:<function>:RELative:ACQuire This command acquires a measurement and stores it as the relative offset value. Type Affected by Where saved Default value Command only Not applicable Not applicable Not applicable Usage [:SENSe[1]]:<function>:RELative:ACQuire...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual [:SENSe[1]]:<function>:RELative:STATe This command enables or disables the application of a relative offset value to the measurement. Type Affected by Where saved Default value Command and query Recall settings Save settings OFF (0) Instrument reset...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference [:SENSe[1]]:<function>:RSENse This command selects local (2-wire) or remote (4-wire) sensing. Type Affected by Where saved Default value Command and query Recall settings Save settings 0 (OFF) Instrument reset Measure configuration list Power cycle Measure configuration list...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual [:SENSe[1]]:<function>:UNIT This command sets the units of measurement that are displayed on the front panel of the instrument and stored in the reading buffer. Type Affected by Where saved Default value Command and query...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Example FUNC "VOLT" Do a one-time refresh of the reference and zero measurements AZER:ONCE for the voltage function. Also see Automatic reference measurements (on page 5-26) [:SENSe[1]]:<function>:AZERo[:STATe] (on page 12-49) [:SENSe[1]]:CONFiguration:LIST:CATalog? This command returns the name of one measure configuration list that is stored on the instrument.
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details This command creates an empty configuration list. To add configuration indexes to this list, you need to use the store command. Configuration lists are not saved when the instrument is turned off. To save a configuration list, use a saved setup to store the instrument settings, which include defined configuration lists.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Example :SENS:CONF:LIST:DELete "myMeasList" Deletes a configuration list named myMeasList. :SENS:CONF:LIST:DELete "myMeasList", 2 Deletes configuration index 2 in a configuration list named myMeasList. Also see Configuration lists (on page 5-65) [:SENSe[1]]:CONFiguration:LIST:CREate (on page 12-67) [:SENSe[1]]:CONFiguration:LIST:QUERy?
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual [:SENSe[1]]:CONFiguration:LIST:RECall This command recalls a configuration index in a measure configuration list. Type Affected by Where saved Default value Command only Not applicable Not applicable Not applicable Usage [:SENSe[1]]:CONFiguration:LIST:RECall "<name>"...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Also see Configuration lists (on page 5-65) [:SENSe[1]]:CONFiguration:LIST:CREate (on page 12-67) *SAV (on page 12-10) [:SENSe[1]]:CONFiguration:LIST:QUERy? (on page 12-69) [:SENSe[1]]:CONFiguration:LIST:STORe (on page 12-72) :SOURce[1]:CONFiguration:LIST:RECall (on page 12-78) [:SENSe[1]]:CONFiguration:LIST:SIZE? This command returns the size (number of configuration indexes) of a measure configuration list.
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual [:SENSe[1]]:CONFiguration:LIST:STORe This command stores the active measure settings into the named configuration list. Type Affected by Where saved Default value Command only Recall settings Saved settings Not applicable Instrument reset Power cycle Usage...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference [:SENSe[1]]:COUNt This command sets the number of measurements to make when a measurement is requested. Type Affected by Where saved Default value Command and query Recall settings Save settings Instrument reset Measure configuration list...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Also see :MEASure? (on page 12-4) :TRACe:DATA? (on page 12-133) :TRIGger:LOAD "SimpleLoop" (on page 12-209) [:SENSe[1]]:FUNCtion[:ON] This command selects the active measure function. Type Affected by Where saved Default value Command and query Recall settings...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference SOURce subsystem The commands in the SOURce subsystem configure and control the current source and voltage source. :SOURce[1]:CONFiguration:LIST:CATalog? This command returns the name of one source configuration list. Type Affected by Where saved...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details This command creates an empty configuration list. To add configuration indexes to this list, you need to use the store command. Configuration lists are not saved when the instrument is turned off. If you want to save a configuration list, use a saved setup to store the instrument settings, which include defined configuration lists.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Example :SOUR:CONF:LIST:DEL "MySourceList" Deletes a configuration list named MySourceList. :SOUR:CONF:LIST:DEL "MySourceList", 2 Deletes configuration index 2 in the configuration list named MySourceList. Also see Configuration lists (on page 5-65) :SOURce[1]:CONFiguration:LIST:CREate (on page 12-75) :SOURce[1]:CONFiguration:LIST:QUERy?
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :SOURce[1]:CONFiguration:LIST:RECall This command recalls a specific configuration index in a specific source configuration list and an optional measure configuration list. Type Affected by Where saved Default value Command only Not applicable Not applicable...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Example :SOUR:CONF:LIST:REC "MySourceList", 5 Recalls configuration index 5 in a configuration list named MySourceList. :SOUR:CONF:LIST:REC "MySourceList" Because an index was not specified, this command recalls configuration index 1 from a configuration list named MySourceList.
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :SOURce[1]:CONFiguration:LIST:STORe This command stores the active source settings into the named configuration list. Type Affected by Where saved Default value Command only Recall settings Saved settings Not applicable Instrument reset Power cycle Source configuration list...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :SOURce[1]:<function>:DELay This command contains the source delay. Type Affected by Where saved Default value Command and query Recall settings Save settings Instrument reset Source configuration list Power cycle Source configuration list Usage :SOURce[1]:<function>:DELay <value>...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :SOURce[1]:<function>:DELay:AUTO This command enables or disables the automatic delay that occurs when the source is turned on. Type Affected by Where saved Default value Command and query Recall settings Save settings 1 (ON)
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :SOURce[1]:<function>:DELay:USER<n> This command sets a user-defined delay that you can use in the trigger model. Type Affected by Where saved Default value Command and query Recall settings Save settings Instrument reset Source configuration list...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :SOURce[1]:<function>:HIGH:CAPacitance This command enables or disables high-capacitance mode. Type Affected by Where saved Default value Command and query Recall settings Save settings 0 (OFF) Instrument reset Source configuration list Power cycle Source configuration list Usage...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :SOURce[1]:<function>[:LEVel][:IMMediate][:AMPLitude] This command immediately selects a fixed amplitude for the selected source function. Type Affected by Where saved Default value Command and query Recall settings Save settings Instrument reset Source configuration list Power cycle...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :SOURce[1]:<function>:<x>LIMit[:LEVel] This command selects the source limit for measurements of the selected function. Type Affected by Where saved Default value Command and query Recall settings Save settings Voltage: 105 µA Instrument reset Source configuration list...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Example :SOUR:CURR:VLIM 15 Set the voltage limit to 15 V. Also see :SOURce[1]:<function>:PROTection[:LEVel] (on page 12-88) :SOURce[1]:<function>:<x>LIMit[:LEVel]:TRIPped? (on page 12-87) :SOURce[1]:<function>:<x>LIMit[:LEVel]:TRIPped? This command indicates if the source exceeded the limits that were set for the selected measurements. Type Affected by Where saved...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :SOURce[1]:FUNCtion[:MODE] This command contains the source function, which can be voltage or current. Type Affected by Where saved Default value Command and query Recall settings Save settings VOLT Instrument reset Source configuration list...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Details Overvoltage protection restricts the maximum voltage level that the instrument can source. It is in effect when either current or voltage is sourced. This protection is in effect for both positive and negative output voltages. When this attribute is used in a test sequence, it should be set before turning the source on.
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :SOURce[1]:<function>:RANGe This command selects the range for the source for the selected source function. Type Affected by Where saved Default value Command and query Recall settings Save settings Current: 1e-8 A Instrument reset Source configuration list...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference If automatic range selection is set to on, when you select a specific range, automatic is set to off. To set the range to automatic selection, use the source autorange command. Example :SOUR:VOLT:RANG 3 Send this command to source levels around...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :SOURce[1]:<function>:READ:BACK This command determines if the instrument records the measured source value or the configured source value when making a measurement. Type Affected by Where saved Default value Command and query Recall settings Save settings...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :SOURce[1]:LIST:<function> This command allows you to set up a list of custom values for a sweep. Type Affected by Where saved Default value Command and query Recall settings Save settings Not applicable Instrument reset...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Also see :SOURce[1]:LIST:<function>:APPend (on page 12-94) :SOURce[1]:SWEep:<function>:LIST (on page 12-100) :SOURce[1]:LIST:<function>:APPend This command adds values to the source list for the selected source function. Type Affected by Where saved Default value Command only...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :SOURce[1]:LIST:<function>:POINts? This command queries the length of the source list for the selected source function. Type Affected by Where saved Default value Query only Not applicable Not applicable Not applicable Usage :SOURce[1]:LIST:CURRent:POINts?
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :SOURce[1]:SWEep:<function>:LINear This command sets up a linear sweep for a fixed number of measurement points. Type Affected by Where saved Default value Command only Recall settings Save settings Not applicable Instrument reset Power cycle...
Page 508
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference <dual> Determines if the sweep runs from start to stop and then from stop to start: ▪ Sweep from start to stop only: OFF (default) ▪ Sweep from start to stop, then stop to start: ON <bufferName>...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :SOURce[1]:SWEep:<function>:LINear:STEP This command sets up a linear source sweep configuration list and trigger model with a fixed number of steps. Type Affected by Where saved Default value Command only Recall settings Save settings...
Page 510
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference <bufferName> A string that indicates the reading buffer; the default buffers (defbuffer1 or defbuffer2) or the name of a user-defined buffer; if no buffer is specified, defbuffer1 is used Details When the sweep is started, the instrument sources a specific voltage or current voltage to the device under test (DUT).
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example *RST SOUR:FUNC CURR SOUR:CURR:RANGE 1 SENS:FUNC "VOLT" SENS:VOLT:RANGE 20 SOUR:SWE:CURR:LIN:STEP -1.05, 1.05, .25, 10e-3, 1, FIXED INIT Reset the instrument to its defaults. Set the source function to current. Set the source range to 1 A.
Page 512
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference <failAbort> Determines if the sweep is stopped immediately if a limit is exceeded; options are: ▪ Abort the sweep if a limit is exceeded: ON ▪ Complete the sweep even if a limit is exceeded: OFF <bufferName>...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example 2 SOUR:CONF:LIST:CRE "biasLevel" SOUR:FUNC VOLT SENS:FUNC "CURR" SOUR:VOLT:LEV 5 SOUR:CONF:LIST:STORE "biasLevel" SOUR:SWE:VOLT:LIST 1, .001, 1, 1, "defbuffer2", "biasLevel" INIT This example uses a user-defined configuration list. Create a configuration list named biasLevel.
Page 514
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference <start> The voltage or current source level at which the sweep starts: ▪ Current: 1 pA to 1.05 A ▪ Voltage: 1 pV to 1100 V <stop> The voltage or current at which the sweep stops: ▪...
Page 515
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual The range type specifies the source range that is used for the sweep. You can select the following options: • Auto: The instrument automatically goes to the most sensitive source range for each source level in the sweep.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference STATus subsystem The STATus subsystem controls the status registers of the instrument. For additional information on the status model, see Status model (on page 18-1). :STATus:CLEar This function clears event registers. Type Affected by Where saved...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :STATus:OPERation:ENABle This command sets or reads the contents of the Operation Event Enable Register of the status model. Type Affected by Where saved Default value Command and query STATus:PRESet Not applicable Usage...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Example STAT:OPER? Returns the contents of the Operation Event Register of the status model. Also see Operation Event Register (on page 18-7) :STATus:OPERation:MAP This command allows you to map event numbers to bits in the Operation Event Registers. Type Affected by Where saved...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Also see Operation Event Register (on page 18-7) Programmable status register sets (on page 18-4) :STATus:PRESet This command resets all bits in the status model. Type Affected by Where saved Default value Command only...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Also see Questionable Event Register (on page 18-6) Understanding bit settings (on page 18-16) :STATus:QUEStionable:ENABle This command sets or reads the contents of the questionable event enable register of the status model. Type Affected by Where saved...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :STATus:QUEStionable:MAP This command queries mapped event numbers or maps event numbers to bits in the event registers. Type Affected by Where saved Default value Command and query Not applicable Not applicable Usage...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :STATus:QUEStionable[:EVENt]? This command reads the Questionable Event Register. Type Affected by Where saved Default value Query only Not applicable Not applicable Not applicable Usage :STATus:QUEStionable[:EVENt]? Details This query reads the contents of the questionable status event register. After sending this command and addressing the instrument to talk, a value is sent to the computer.
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual SYSTem subsystem This subsystem contains commands that affect the overall operation of the instrument, such as passwords, beepers, communications, event logs, and time. :SYSTem:ACCess This command contains the type of access users have to the instrument through different interfaces. Type Affected by Where saved...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :SYSTem:BEEPer[:IMMediate] This command generates an audible tone. Type Affected by Where saved Default value Command only Not applicable Not applicable Not applicable Usage :SYSTem:BEEPer[:IMMediate] <frequency>, <duration> <frequency> The frequency of the beep (20 Hz to 8000 Hz) <duration>...
Page 525
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details The specifics of the current breakdown feature depend on the version of the analog board in your 2470. To determine the board version, send print(localnode.analogrevision). This command is only available using TSP. If your 2470 analog board revision is 878-1493-05 or later, when breakdown protection is set to ON, the SMU always puts the clamp in series with the output, even on the 1 A current range.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference A more comprehensive method of testing components to determine the DUT breakdown voltage is to measure the actual component breakdown voltage. To do this on a 1000 V rated MOSFET, you need to switch the sourcing method to current and the limit voltage to 1100 V (higher than the highest expected breakdown voltage).
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :SYSTem:COMMunication:LAN:CONFigure This command specifies the LAN configuration for the instrument. Type Affected by Where saved Default value Command and query Rear panel LAN reset Nonvolatile memory AUTO Usage :SYSTem:COMMunication:LAN:CONFigure "AUTO"...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Also see :SYSTem:COMMunication:LAN:MACaddress? (on page 12-118) :SYSTem:COMMunication:LAN:DST:PROTection This command allows you to prevent LAN connections from being closed inadvertently. Type Affected by Where saved Default value Command and query Power reset Not applicable Usage...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :SYSTem:COMMunication:LAN:MACaddress? This command queries the LAN media access control (MAC) address. Type Affected by Where saved Default value Query only Not applicable Not applicable Not applicable Usage :SYSTem:COMMunication:LAN:MACaddress? Details The MAC address is a character string representing the MAC address of the instrument in...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Note that if you have used :SYSTem:ERRor[:NEXT]? to check events, :SYSTem:EVENtlog:NEXT? shows the next event item after the last error that was returned by :SYSTem:ERRor[:NEXT]? You will not see warnings or information event log items that occurred before you used :SYSTem:ERRor[:NEXT]? Example SYST:ERR:NEXT?
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :SYSTem:ERRor:COUNt? This command returns the number of errors in the event log. Type Affected by Where saved Default value Query only Not applicable Not applicable Not applicable Usage :SYSTem:ERRor:COUNt? Details...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Example :SYST:EVEN:COUN? ERR Displays the present number of errors in the instrument event log. If there are three errors in the event log, output is: Also see :SYSTem:CLEar (on page 12-115) :SYSTem:EVENtlog:NEXT?
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual The information that is returned is in the order: <eventNumber>, <message>, <eventType>, <timeSeconds>, <timeNanoSeconds> <eventNumber> The event number <message> A description of the event <eventType> The type of event: ▪...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Example *CLS Clear the event log. SYST:EVEN:POST "my error", INF Post an error named my error. SYST:EVEN:NEXT? Output: 1003,"User: my error;4,1400469179,431599191" Also see Using the event log (on page 4-55) :SYSTem:EVENtlog:SAVE This command saves the event log to a file on a USB flash drive.
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :SYSTem:GPIB:ADDRess This command contains the GPIB address. Type Affected by Where saved Default value Command and query Not applicable Nonvolatile memory Usage :SYSTem:GPIB:ADDRess <n> :SYSTem:GPIB:ADDRess? <n> The GPIB address of the instrument: 1 to 30 Details The address can be set to any address value from 1 to 30.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :SYSTem:LFRequency? This query contains the power line frequency setting that is used for NPLC calculations. Type Affected by Where saved Default value Query only Power cycle Not applicable Not applicable Usage :SYSTem:LFRequency?
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :SYSTem:POSetup This command selects the defaults when you power on the instrument. Type Affected by Where saved Default value Command and query Not applicable Nonvolatile memory Usage :SYSTem:POSetup <name>...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :SYSTem:RANGe:COMPensation This command controls how switched operation behaves. Type Affected by Where saved Default value Command and query Recall setup Save Setup AUTO Instrument reset Power cycle Usage :SYSTem:RANGe:COMPensation <state>...
Page 539
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :SYSTem:TIME This command sets the absolute time of the instrument. Type Affected by Where saved Default value Command and query Not applicable Nonvolatile memory See Details Usage :SYSTem:TIME <year>, <month>, <day>, <hour>, <minute>, <second>...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :SYSTem:VERSion? This command returns the present SCPI version. Type Affected by Where saved Default value Query only Not applicable Not applicable Not applicable Usage :SYSTem:VERSion? Details This query command returns the SCPI version. Example SYSTem:VERSion? Query the version.
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example TRAC:MAKE "testData", 200 Creates 200 element reading buffer named testData. COUN 10 Set the measurement count to 10. MEAS:CURR? "testData" Set the measurement function to current. Make readings and store the readings in testData.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Example :TRAC:MAKE "test1", 100 :COUN 6 :MEAS:CURR? "test1" :TRAC:ACT:STAR? "test1" ; END? "test1" :MEAS:CURR? "test1" :TRAC:ACT:STAR? "test1" ; END? "test1" Create a buffer named test1 with a capacity of 100 readings. Set the measure count to 6.
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example :TRAC:MAKE "test1", 100 :COUN 6 :MEAS:CURR? "test1" :TRAC:ACT:STAR? "test1" ; END? "test1" Create a buffer named test1 with a capacity of 100 readings. Set the measure count to 6. Make measurements and store them in buffer test1.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :TRACe:DATA? This command returns specified data elements from a specified reading buffer. Type Affected by Where saved Default value Query only Not applicable Not applicable Not applicable Usage :TRACe:DATA? <startIndex>, <endIndex>...
Page 545
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual The options for <bufferElements> are described in the following table. Option Description DATE The date when the data point was measured FORMatted The measured value as it appears on the front panel FRACtional The fractional seconds for the data point when the data point was measured READing...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :TRACe:DELete This command deletes a user-defined reading buffer. Type Affected by Where saved Default value Command only Not applicable Not applicable Not applicable Usage :TRACe:DELete "<bufferName>" <bufferName> A string that contains the name of the user-defined reading buffer to delete Details You cannot delete the default reading buffers, defbuffer1 and defbuffer2.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Details When a reading buffer is set to fill once, no data is overwritten in the buffer. When the buffer is filled, no more data is stored in that buffer and new readings are discarded. When a reading buffer is set to fill continuously, the oldest data is overwritten by the newest data after the buffer fills.
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details If this is set to on, when the reading buffer is cleared (0% filled) or full (100% filled), an event is logged in the event log. If this is set to off, reading buffer status is not reported in the event log.
Page 550
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference If you create a reading buffer that has the same name as an existing user-defined buffer, the event message 1115, "Parameter error: TRACe:MAKE cannot take an existing reading buffer name"...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Also see Reading buffers (on page 7-1) Remote buffer operation (on page 7-26) :TRACe:FILL:MODE (on page 12-136) :TRACe:POINts (on page 12-143) :TRACe:WRITe:FORMat (on page 12-153) :TRACe:WRITe:READing (on page 12-156) :TRACe:MATH This command allows you to run a mathematical expression on a measurement.
Page 552
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference ▪ ▪ DC current: AMP Frequency: HERTz ▪ ▪ AC current: AMPAC Kelvin: KELVin ▪ ▪ Celsius: CELSius No unit: NONE ▪ ▪ Custom unit 1: CUSTOM1 Resistance: OHM ▪...
Page 553
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Expression <expression> Formula NONE No math applied Not applicable r + a AVERage Average DIVide Divide EXPonent Exponent LOG10 Log10 MULTiply Multiply r * a POLY Polynomial POWer Power RATE...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :TRACe:POINts This command sets the number of readings a buffer can store. Type Affected by Where saved Default value Command and query Recall settings Save settings Not applicable Instrument reset Power cycle Usage...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :TRACe:SAVE This command saves data from the specified reading buffer to a USB flash drive. Type Affected by Where saved Default value Command only Not applicable Not applicable Not applicable Usage :TRACe:SAVE "<fileName>"...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Example TRAC:MAKE "MyBuffer", 100 SENS:COUN 5 MEAS:CURR:DC? "MyBuffer" TRAC:DATA? 1, 5, "MyBuffer", READ, REL, SOUR TRAC:SAVE "/usb1/myData.csv", "MyBuffer" TRAC:SAVE "/usb1/myDataRel.csv", "MyBuffer", REL Create a buffer called MyBuffer with a maximum size of 100. Make five readings for each measurement request and return the data.
Page 557
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual <timeFormat> Indicates how date and time information from the buffer is saved in the file on the USB flash drive; the values are: ▪ All information: ALL ▪...
Page 558
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :TRACe:STATistics:AVERage? This command returns the average of all readings in the buffer. Type Affected by Where saved Default value Query only Not applicable Not applicable Not applicable Usage :TRACe:STATistics:AVERage? :TRACe:STATistics:AVERage? "<bufferName>"...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :TRACe:STATistics:CLEar This command clears the statistical information associated with the specified buffer. Type Affected by Where saved Default value Command only Not applicable Not applicable Not applicable Usage :TRACe:STATistics:CLEar :TRACe:STATistics:CLEar "<bufferName>"...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :TRACe:STATistics:MAXimum? This command returns the maximum reading value in the reading buffer. Type Affected by Where saved Default value Query only Not applicable Not applicable Not applicable Usage :TRACe:STATistics:MAXimum? :TRACe:STATistics:MAXimum? "<bufferName>"...
Page 561
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example TRAC:STAT:MIN? Returns the minimum reading value in the default buffer defbuffer1. TRAC:STAT:MIN? "testData" Returns the minimum reading value in the user-defined buffer testData. Also see Reading buffers (on page 7-1) Remote buffer operation (on page 7-26)
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :TRACe:STATistics:STDDev? This command returns the standard deviation of all readings in the buffer. Type Affected by Where saved Default value Query only Not applicable Not applicable Not applicable Usage :TRACe:STATistics:STDDev? :TRACe:STATistics:STDDev? "<bufferName>"...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example TRAC:MAKE "MyBuffer", 100 Create a buffer called MyBuffer with a maximum size of 100. COUN 5 Make readings and store them in MyBuffer. TRAC:TRIG "MyBuffer" Recall the relative time when the data points were measured TRAC:DATA? 1, 5, "MyBuffer", rel for the first five readings in the buffer.
Page 564
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Example *RST TRAC:MAKE "expressions", 100, FULL SENS:FUNC "VOLT" TRAC:UNIT CUSTOM1, "fb" TRAC:MATH "expressions", CUSTOM1, ADD COUN 10 READ? "expressions" TRAC:DATA? 1, 10, "expressions", READ, EXTR DISP:SCR READ Instrument has terminals set to FRONT.
Page 565
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual <units> The units for the first measurement in the buffer index: ▪ ▪ KELVin ▪ ▪ AMP_AC NONE ▪ ▪ AMPAC ▪ ▪ CELSius PERCent ▪ ▪ CUSTOM1 (user-defined unit) RATio ▪...
Page 566
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Example 1 :TRAC:MAKE "write2me", 1000, WRITable :TRAC:WRIT:FORM "write2me", WATT, 4 :TRAC:WRIT:READ "write2me", 1 :TRAC:WRIT:READ "write2me", 2 :TRAC:WRIT:READ "write2me", 3 :TRAC:WRIT:READ "write2me", 4 :TRAC:WRIT:READ "write2me", 5 :TRAC:WRIT:READ "write2me", 6 :TRAC:DATA? 1, 6, "write2me", read, unit Creates a 1000-point reading buffer named write2me.
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :TRACe:WRITe:READing This command allows you to write readings into the reading buffer. Type Affected by Where saved Default value Command only Not applicable Not applicable Not applicable Usage For buffers that are set to the writable buffer style: :TRACe:WRITe:READing "<bufferName>", <readingValue>...
Page 568
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Buffer status bits for sense measurements Bit (hex) Decimal Description 0x0001 Measure status questionable 0x0006 A/D converter from which reading originated; for the 2470, this will always be 0 (main) 0x0008 Measure terminal;...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Also see Reading buffers (on page 7-1) :TRACe:DATA? (on page 12-133) :TRACe:MAKE (on page 12-138) :TRACe:WRITe:FORMat (on page 12-153) Writable reading buffers (on page 7-32) TRIGger subsystem The commands in this subsystem configure and control the trigger operations, including the trigger model.
Page 570
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :TRIGger:BLENder<n>:CLEar This command clears the blender event detector and resets the overrun indicator of blender <n>. Type Affected by Where saved Default value Command only Not applicable Not applicable Not applicable Usage...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example :DIG:LINE3:MODE TRIG, IN Set digital I/O lines 3 and 5 as trigger in lines. Generate a :DIG:LINE5:MODE TRIG, IN trigger blender 1 event when a digital I/O trigger happens on :TRIG:BLEN1:MODE OR line 3 or 5.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :TRIGger:BLENder<n>:STIMulus<m> This command specifies the events that trigger the blender. Type Affected by Where saved Default value Command and query Recall settings Save settings NONE Instrument reset Power cycle Trigger blender clear Usage...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example :DIG:LINE3:MODE TRIG, IN Set digital I/O lines 3 and 5 as trigger in lines. Generate a :DIG:LINE5:MODE TRIG, IN trigger blender 1 event when a digital I/O trigger happens on :TRIG:BLEN1:MODE OR line 3 or 5.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :TRIGger:BLOCk:BRANch:COUNter This command defines a trigger model block that branches to a specified block a specified number of times. Type Affected by Where saved Default value Command only Recall settings Save settings Not applicable...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :TRIGger:BLOCk:BRANch:COUNter:COUNt? This command returns the count value of the trigger model counter block. Type Affected by Where saved Default value Query only Not applicable Not applicable Not applicable Usage :TRIGger:BLOCk:BRANch:COUNter:COUNt? <blockNumber>...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :TRIGger:BLOCk:BRANch:COUNter:RESet This command creates a block in the trigger model that resets a branch counter to 0. Type Affected by Where saved Default value Command only Recall settings Save settings Not applicable Instrument reset...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :TRIGger:BLOCk:BRANch:DELTa This command defines a trigger model block that goes to a specified block if the difference of two measurements meets preset criteria. Type Affected by Where saved Default value Command only Recall settings...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :TRIGger:BLOCk:BRANch:EVENt This command branches to a specified block when a specified trigger event occurs. Type Affected by Where saved Default value Command only Recall settings Save settings Not applicable Instrument reset Power cycle...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Trigger events Event description Event constant TIMer<n> Trigger timer <n> (1 to 4) expired TSPLink<n> Line edge detected on TSP-Link synchronization line <n> (1 to 3) Example :TRIG:BLOC:BRAN:EVEN 6, DISP, 2 When the trigger model reaches this block, if the front-panel TRIGGER key has been pressed, the trigger model returns to block 2.
Page 580
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Details The branch-on-constant-limits block goes to a branching block if a measurement meets the criteria set by this command. The type of limit can be: • Above: The measurement is above the value set by limit B; limit A must be set, but is ignored when this type is selected •...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :TRIGger:BLOCk:BRANch:LIMit:DYNamic This command defines a trigger model block that goes to a specified block in the trigger model if a measurement meets user-defined criteria. Type Affected by Where saved Default value Command only...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference The measure/digitize block must occur in the trigger model before the branch-on-dynamic-limits block. If no block is defined, the measurement from the previous measure/digitize block is used. If no previous measure/digitize block exists, an error is reported.
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :TRIGger:BLOCk:BRANch:ONCE:EXCLuded This command causes the trigger model to go to a specified building block every time the trigger model encounters it, except for the first time. Type Affected by Where saved Default value...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Details When trigger model execution reaches the buffer clear trigger block, the instrument empties the specified reading buffer. The specified buffer can be the default buffer or a buffer that you defined.
Page 585
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual The first time the trigger model encounters this block for a specific configuration list, the first index is recalled if the list has not already had an index recalled by the recall block command in an earlier trigger model block.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :TRIGger:BLOCk:CONFig:PREVious This command defines a trigger model block that recalls the settings stored at the previous index in a source or measure configuration list. Type Affected by Where saved Default value Command only...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual The configuration lists must be defined before you can use this block. If you need to swap the source and measure configuration lists, you need to delete this block and create a new Config List Prev block.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Example SOUR:CONF:LIST:CRE "biasLevel" Create a configuration list named SOUR:FUNC VOLT biasLevel. Set the source function to 5 V SENS:FUNC "CURR" and the measure function to current. SOUR:VOLT:LEV 5 Store the source settings at index 1 in the configuration list named biasLevel.
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example SOUR:CONF:LIST:CRE "ampLevel" Create configuration lists named ampLevel SOUR:CONF:LIST:CRE "biasLevel" and biasLevel. SOUR:FUNC VOLT Set the source function to 5 V and the SENS:FUNC "CURR" measurement function to current. SOUR:VOLT:LEV 5 Store the settings in the ampLevel SOUR:CONF:LIST:STORE "ampLevel"...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Each measure function can have up to five unique user delay times (M1 to M5). Each source function can also have up to five unique user delay times (S1 to S5). The delay time is set by the user-delay command, which is only available over a remote interface.
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example :DIGital:LINE3:MODE DIG,OUT The first four lines of code configures digital I./O lines 3 through :DIGital:LINE4:MODE DIG,OUT 6 as digital outputs. :DIGital:LINE5:MODE DIG,OUT Trigger block 4 is then configured with a bit pattern of 20 :DIGital:LINE6:MODE DIG,OUT (digital I/O lines 3 and 5 high).
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :TRIGger:BLOCk:LOG:EVENt This command allows you to log an event in the event log when the trigger model is running. Type Affected by Where saved Default value Command only Recall settings Save settings Not applicable...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :TRIGger:BLOCk:MDIGitize This command defines a trigger block that makes or digitizes a measurement. Type Affected by Where saved Default value Command only Recall settings Save settings Not applicable Instrument reset Power cycle Usage...
Page 594
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Digitized measurements are not a feature on the 2470. However, you can use this command to communicate with other Keithley instruments that do offer the digitized measurements feature and to share code with other Keithley instruments.
Page 595
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example 2 *RST SENS:CONF:LIST:CRE "countactive" COUN 2 SENS:CONF:LIST:STOR "countactive" COUN 10 SENS:CONF:LIST:STOR "countactive" COUN 3 SENS:CONF:LIST:STOR "countactive" TRIG:BLOC:CONF:NEXT 1, "countactive" TRIG:BLOC:MDIG 2, "defbuffer1", AUTO TRIG:BLOC:DEL:CONS 3, 1 TRIG:BLOC:BRAN:COUN 4, 3, 1 INIT *WAI...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :TRIGger:BLOCk:NOP This command creates a placeholder that performs no action in the trigger model; available only using remote commands. Type Affected by Where saved Default value Command only Recall settings Save settings Not applicable...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual When you call this event, you use the format NOTIFY followed by the notify identification number. For example, if you assign <notifyID> as 4, you would refer to it as NOTIFY4 in the command that references it.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :TRIGger:BLOCk:WAIT This command defines a trigger model block that waits for an event before allowing the trigger model to continue. Type Affected by Where saved Default value Command only Recall settings Save settings...
Page 599
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual All items in the list are subject to the same action; you cannot combine AND and OR logic in a single block. You cannot leave the first event as no trigger. If the first event is not defined, the trigger model errors when you attempt to initiate it.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Example 2 :TRIGger:BLOCk:WAIT 9, DISP, ENTer Set trigger model block 9 to wait for a user to press the TRIGGER key on the front panel before continuing and to act only on a recorded TRIGGER key event that gets detected when block 9 is reached.
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :TRIGger:DIGital<n>:IN:CLEar This command clears the trigger event on a digital input line. Type Affected by Where saved Default value Command only Not applicable Not applicable Not applicable Usage :TRIGger:DIGital<n>:IN:CLEar <n>...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Details This command sets the logic on which the trigger event detector and the output trigger generator operate on the specified trigger line. To directly control the line state, set the mode of the line to digital and use the write command.
Page 603
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example TRIG:DIG1:IN:OVER? Returns 0 if no overruns have occurred or 1 if one or more overruns have occurred for I/O line 1. Also see Digital I/O port configuration (on page 9-14) :DIGital:LINE<n>:MODE (on page 12-26)
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :TRIGger:DIGital<n>:OUT:PULSewidth This command describes the length of time that the trigger line is asserted for output triggers. Type Affected by Where saved Default value Command and query Recall settings Save settings 10e-6 (10 µs)
Page 605
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details The digital trigger pulsewidth command determines how long the trigger is asserted. The trigger stimulus for a digital I/O line can be set to one of the trigger events that are described in the following table.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :TRIGger:LAN<n>:IN:CLEar This command clears the event detector for a LAN trigger. Type Affected by Where saved Default value Command only Not applicable Not applicable Not applicable Usage :TRIGger:LAN<n>:IN:CLEar <n>...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual LAN trigger mode values Mode Trigger packets detected as input LAN trigger packet generated for output with a… EITHer Rising or falling edge (positive or negative state) negative state FALLing Falling edge (negative state)
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :TRIGger:LAN<n>:OUT:CONNect:STATe This command prepares the event generator for outgoing trigger events. Type Affected by Where saved Default value Command and query Not applicable Not applicable Not applicable Usage :TRIGger:LAN<n>:OUT:CONNect:STATe <state>...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details Sets the IP address for outgoing trigger events. After you change this setting, you must send the connect command before outgoing messages can be sent. Example TRIG:LAN1:OUT:IP:ADDR "192.0.32.10"...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :TRIGger:LAN<n>:OUT:PROTocol This command sets the LAN protocol to use for sending trigger messages. Type Affected by Where saved Default value Command and query Recall settings Save settings Instrument reset Power cycle Usage...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :TRIGger:LAN<n>:OUT:STIMulus This command specifies events that cause this trigger to assert. Type Affected by Where saved Default value Command and query Recall settings Save settings NONE Instrument reset Power cycle Usage :TRIGger:LAN<n>:OUT:STIMulus <LANevent>...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Example TRIG:LAN1:OUT:STIM TIM1 Set the timer 1 trigger event as the source for the LAN packet 1 trigger stimulus. Also see :TRIGger:LAN<n>:OUT:CONNect:STATe (on page 12-197) :TRIGger:LOAD "ConfigList" This command loads a trigger-model template configuration that uses source and measure configuration lists.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Details When you load this trigger-model template, you can specify amount of time to make a measurement and the length of the delay before the measurement. After selecting a trigger-model template, you can view the trigger-model blocks in a graphical format by pressing the front-panel MENU key and under Trigger, selecting Configure.
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example TRIG:LOAD "Empty" TRIG:BLOC:BUFF:CLEAR 1 TRIG:BLOC:MDIG 2 TRIG:BLOC:BRAN:COUN 3, 5, 2 TRIG:BLOC:DEL:CONS 4, 1 TRIG:BLOC:BRAN:COUN 5, 3, 2 TRAC:ACT? "defbuffer1" Reset trigger model settings. Clear defbuffer1 at the beginning of execution of the trigger model. Loop and take 5 readings.
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Also see :TRIGger:BLOCk:LIST? (on page 12-180) :TRIGger:LOAD "LogicTrigger" This command loads a trigger-model template configuration that sets up a digital trigger through the digital I/O. Type Affected by Where saved Default value Command only...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :TRIGger:LOAD "LoopUntilEvent" This command loads a trigger-model template configuration that makes continuous measurements until the specified event occurs. Type Affected by Where saved Default value Command only Recall settings Save settings Not applicable...
Page 619
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual You can use the TRIGger:BLOCk:LIST? command to view the trigger-model blocks in a list format. Trigger events Event description Event constant DISPlay Front-panel TRIGGER key press NOTify<n> Notify trigger block <n>...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :TRIGger:LOAD "SimpleLoop" This command loads a trigger-model template configuration. Type Affected by Where saved Default value Command only Recall settings Save settings Not applicable Instrument reset Power cycle Usage :TRIGger:LOAD "SimpleLoop", <count>...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :TRIGger:LOAD "SortBinning" This command loads a trigger-model template configuration that sets up a sorting operation. Type Affected by Where saved Default value Command only Recall settings Save settings Not applicable Instrument reset Power cycle...
Page 622
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference <limitxLow> x is 1, 2, 3, or 4; the lower limit that the measurement is compared against <limit1Pattern> The bit pattern that is sent when the measurement passes limit 1; range 1 to 15; default is 1 <limit2Pattern>...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :TRIGger:PAUSe This command pauses a running trigger model. Type Affected by Where saved Default value Command only Not applicable Not applicable Not applicable Usage :TRIGger:PAUSe Details This command pauses the trigger model. To continue the trigger model, send the resume command.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :TRIGger:STATe? This command returns the present state of the trigger model. Type Affected by Where saved Default value Query only Not applicable Not applicable Not applicable Usage :TRIGger:STATe? Details This command returns the state of the trigger model.
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :TRIGger:TIMer<n>:CLEar This command clears the timer event detector and overrun indicator for the specified trigger timer number. Type Affected by Where saved Default value Command only Not applicable Not applicable Not applicable Usage...
Page 626
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Example 1 TRIG:TIM2:COUN 4 Set the number of events to generate for trigger timer 2 to four. Example 2 *RST TRIG:TIM4:DEL 0.5 TRIG:TIM4:STAR:STIM NOT8 TRIG:TIM4:STAR:GEN OFF TRIG:TIM4:COUN 20 TRIG:TIM4:STAT ON TRIG:LOAD "Empty"...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual :TRIGger:TIMer<n>:DELay This command sets and reads the timer delay. Type Affected by Where saved Default value 1e-5 (10 s) Command and query Recall settings Save settings Instrument reset Power cycle Usage :TRIGger:TIMer<n>:DELay <interval>...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Example TRIG:TIM1:STAR:SEC 60 Set the timer for 60.5 s. TRIG:TIM1:START:FRAC 0.5 Enable the trigger timer for timer 1. TRIG:TIM1:STAT ON Also see :TRIGger:TIMer<n>:STARt:SEConds (on page 12-218) :TRIGger:TIMer<n>:STATe (on page 12-220) :TRIGger:TIMer<n>:STARt:GENerate This command specifies when timer events are generated.
Page 629
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details This command 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 built into the timer itself. It does not indicate if an overrun occurred in any other part of the trigger model or in any other construct that is monitoring the delay completion event.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference :TRIGger:TIMer<n>:STARt:STIMulus This command describes the event that starts the trigger timer. Type Affected by Where saved Default value Command and query Recall settings Save settings NONE Instrument reset Power cycle Usage :TRIGger:TIMer<n>:STARt:STIMulus <event>...
Section 12: SCPI command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example *RST Reset the instrument to default settings. Set digital I/O line 1 for DIG:LINE1:MODE TRIG,IN use as a trigger input. DIG:LINE2:MODE TRIG,OUT Set digital I/O line 2 for use as a trigger output. TRIG:TIM1:DEL 35e-3 Set timer 1 to delay 35 ms.
Page 632
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 12: SCPI command reference Example 2 *RST Configure timer 3 to generate five pulses on DIG:LINE5:MODE TRIG,OUT digital I/O line 5 that are 3 ms apart. TRIG:DIG5:OUT:STIM TIM3 TRIG:TIM3:DEL 3e-3 TRIG:TIM3:COUNT 5 TRIG:TIM3:STAT ON Example 3 *RST...
Section 13 Introduction to TSP commands In this section: Introduction to TSP operation..........13-1 Fundamentals of scripting for TSP ......... 13-4 Fundamentals of programming for TSP ....... 13-14 Test Script Builder ..............13-34 Memory considerations for the runtime environment ... 13-45 About TSP Commands ............
Page 634
Section 13: Introduction to TSP commands Model 2470 High Voltage 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 635
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands To set the characteristics, attribute-based commands define a value. For many attributes, the value is in the form of a number, enumerated type, or a predefined constant. Example 1: Set an attribute using a number testData = buffer.make(500) Use a function to create a buffer named...
Section 13: Introduction to TSP commands Model 2470 High Voltage SourceMeter Instrument Reference Manual Queries Test Script Processor (TSP ) enabled instruments do not have inherent query commands. Like any other scripting environment, the print() and printnumber() commands generate output in the form of response messages. Each print() command creates one response message.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands Scripting helps you combine commands into a block of code that the instrument can run. Scripts help you communicate with the instrument more efficiently. Scripts offer several advantages compared to sending individual commands from the host controller (computer): •...
Section 13: Introduction to TSP commands Model 2470 High Voltage SourceMeter Instrument Reference Manual Nonvolatile memory is where information is stored even when the instrument is turned off. Save scripts to nonvolatile memory to save them even if the power is cycled. The scripts that are in nonvolatile memory are loaded into the runtime environment when the instrument is turned on.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands Tools for managing scripts You can use any of the following tools to manage scripts: • The front-panel menu options and USB flash drive. For information, refer to Saving setups (on page 4-49).
Section 13: Introduction to TSP commands Model 2470 High Voltage SourceMeter Instrument Reference Manual Loading a script into the instrument You can load scripts from the front-panel display by copying them from a USB flash drive. You can also load them over a remote interface using loadscript commands. If a script on a USB flash drive is named autoinstall.tsp, the script is automatically copied to the list of internal scripts when the drive is inserted into the instrument.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands To load a script: Send the loadscript command with a script name. This tells the instrument to start collecting messages for the function named testInfo: loadscript testInfo Send the commands for the script;...
Page 642
Section 13: Introduction to TSP commands Model 2470 High Voltage SourceMeter Instrument Reference Manual To run a script from the home screen: 1. Press the HOME key. 2. Select the Script Indicator. The available scripts are displayed. 3. Select the script. A confirmation prompt is displayed. 4.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands To rename a script in nonvolatile memory: Send the commands: scriptVar = script.load(file) scriptVar.save() Where: • scriptVar is the name of variable that references the script •...
Section 13: Introduction to TSP commands Model 2470 High Voltage SourceMeter Instrument Reference Manual Deleting a user script using a remote interface Deleting a user script deletes the script from the instrument. To delete a script from the instrument: Send the command: script.delete("name") Where: name is the user-defined name of the script.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands Commands that cannot be used in scripts You cannot use the following commands as variables in scripts: There are some functions that resemble some of the strings below but are actually defined TSP functions.
Section 13: Introduction to TSP commands Model 2470 High Voltage 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.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands An example of a short comment is: -- Turn off the front-panel display. An example of a long comment is: --[[Display a menu with three menu items. If the second menu item is selected, the selection is given the value Test2.]] Function and variable name restrictions You cannot use Lua reserved words and top-level command names for function or...
Section 13: Introduction to TSP commands Model 2470 High Voltage 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 649
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands Example: Hex constant You can enter hexadecimal values, but to return a hexadecimal value, you must create a function, as shown in this example. Note that hexadecimal values are handled as a number type.
Section 13: Introduction to TSP commands Model 2470 High Voltage SourceMeter Instrument Reference Manual Delete a global variable To delete a global variable, assign nil to the global variable. This removes the global variable from the runtime environment. Operators You can compare and manipulate Lua variables and constants using operators. Arithmetic operators Operator Description...
Page 651
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands Logical and bitwise operators The logical operators in Lua are and, or, and not. All logical operators consider both false and nil as false and anything else as true. The operator not always returns false or true.
Section 13: Introduction to TSP commands Model 2470 High Voltage SourceMeter Instrument Reference Manual Example 3 hex = function (i) return "0x"..string.format("%X", i) end a, b = 0b01010100, 0b01100110 print(hex(a), "&", hex(b), "=", hex(a & b)) Set the format to return hexadecimal values, define binary values for a and b, then AND a and b. Output: 0x54 &...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands 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.
Page 654
Section 13: Introduction to TSP commands Model 2470 High Voltage 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.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands 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.
Page 656
Section 13: Introduction to TSP commands Model 2470 High Voltage SourceMeter Instrument Reference Manual Example: If and else x = 2 Output: if not x then This is from the else block print("This is from the if block") else print("This is from the else block") Example: Else and elseif x = 1 y = 2...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands Loop control If you need to repeat code execution, you can use the Lua while, repeat, and for control structures. To exit a loop, you can use the break keyword. While loops To use conditional expressions to determine whether to execute or end a loop, you use while loops.
Section 13: Introduction to TSP commands Model 2470 High Voltage SourceMeter Instrument Reference Manual Repeat until loops To repeat a command, you use the repeat ... until statement. The body of a repeat statement always executes at least once. It stops repeating when the conditions of the until clause are met.
Page 659
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands Example: Numeric for list = {"One", "Two", "Three", "Four", "Five", "Six"} ---------- For loop ----------- print("Counting from one to three:") for element = 1, 3 do print(element, list[element]) print("Counting from one to four, in steps of two:") for element = 1, 4, 2 do...
Page 660
Section 13: Introduction to TSP commands Model 2470 High Voltage SourceMeter Instrument Reference Manual Break The break statement terminates the execution of a while, repeat, or for loop, skipping to the next statement after the loop. A break ends the innermost enclosing loop. Return and break statements can only be written as the last statement of a block.
Page 661
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands Example: Break with infinite loop a, b = 0, 1 This example uses a break statement that while true do causes the while loop to exit if the value of a print(a, b) becomes greater than 500.
Section 13: Introduction to TSP commands Model 2470 High Voltage SourceMeter Instrument Reference Manual 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. while atable[i] do The Boolean value of atable[index] evaluates to print(atable[i])
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands 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.
Section 13: Introduction to TSP commands Model 2470 High Voltage 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).
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands 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.
Section 13: Introduction to TSP commands Model 2470 High Voltage SourceMeter Instrument Reference Manual Test Script Builder Keithley Test Script Builder (TSB) is a software tool you can use to develop scripts for TSP- enabled instruments. You must use the TSP command set to use TSB. Refer to Determining the command set you will use (on page 3-34) for information about the command sets and changing them.
Page 667
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands The following figure shows an example of the Test Script Builder. As shown, the workspace is divided into these areas: • Project navigator • Script editor •...
Section 13: Introduction to TSP commands Model 2470 High Voltage SourceMeter Instrument Reference Manual Project navigator The project navigator consists of project folders and the script files (.tsp) created for each project. Each project folder can have one or more script files. To view the script files in a project folder, select the plus (+) symbol next to the project folder.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands 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.
Page 670
Section 13: Introduction to TSP commands Model 2470 High Voltage SourceMeter Instrument Reference Manual 2. The Select Instrument dialog box opens. Select an existing instrument from the list or type the VISA resource ID of the instrument in the Select or enter new instrument box. 3.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands Creating a new TSP project To create a new Test Script Processor (TSP ) project: 1. On the File menu in the TSP perspective, select New > TSP Project. The New TSP Project dialog box opens.
Section 13: Introduction to TSP commands Model 2470 High Voltage SourceMeter Instrument Reference Manual Adding a new TSP file to a project To add a new TSP file to a project: 1. Select the File menu and select New > TSP File. The New TSP File dialog box opens. 2.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands Creating a run configuration A run configuration allows you to download multiple script files to an instrument and execute them as a single script. To create a run configuration: 1.
Page 674
Section 13: Introduction to TSP commands Model 2470 High Voltage SourceMeter Instrument Reference Manual 7. Select OK. Figure 145: Project Selection dialog box The TSP files for the selected project are added to the Available Project Files list on the Main tab.
Page 675
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands 8. Select the files you want to add to the run configuration and select Add to add them to the Load Order list. To change the load order of the TSP files, choose the files you want to move and select Up or Down until the files are in the correct order.
Page 676
Section 13: Introduction to TSP commands Model 2470 High Voltage SourceMeter Instrument Reference Manual Figure 148: Script Attributes tab 12. In the Storage area of the Script Attributes tab, select Volatile or Non-volatile. For products that support autorun scripts, if you select Non-volatile, you can select Auto Run to have the script run automatically when the instrument is turned on.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands Memory considerations for the runtime environment The 2470 reserves a large amount of memory for use with interactions with the front panel, commands, and test scripts. The amount of memory usage is affected by the following product features: •...
Section 13: Introduction to TSP commands Model 2470 High Voltage SourceMeter Instrument Reference Manual The buffer style is set when you create a user-defined reading buffer. The buffer style cannot be changed after the buffer has been created, so to eliminate memory problems caused by the style, you may need to delete or adjust the capacity of the buffers.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands The source configuration list commands are: smu.source.configlist.catalog() (on page 14-186) smu.source.configlist.create() (on page 14-186) smu.source.configlist.delete() (on page 14-187) smu.source.configlist.query() (on page 14-188) smu.source.configlist.recall() (on page 14-189) smu.source.configlist.size() (on page 14-190) smu.source.configlist.store()
Section 13: Introduction to TSP commands Model 2470 High Voltage SourceMeter Instrument Reference Manual Event log You can use the event log to view specific details about LAN triggering events. eventlog.clear() (on page 14-83) eventlog.getcount() (on page 14-84) eventlog.next() (on page 14-85) eventlog.post() (on page 14-86) eventlog.save()
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands Instrument identification These commands store strings that describe the instrument. available() (on page 14-9) localnode.access (on page 14-107) localnode.analogrevision (on page 14-108) localnode.gettime() (on page 14-108) localnode.gettimewithfractional() (on page 14-109) localnode.linefreq...
Section 13: Introduction to TSP commands Model 2470 High Voltage SourceMeter Instrument Reference Manual Miscellaneous The miscellaneous functions and attributes allow you to control instrument features and functions that are not category specific. delay() (on page 14-62) exit() (on page 14-89) localnode.linefreq (on page 14-109) localnode.password...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands Reading buffer Reading buffers capture measurements, ranges, instrument status, and output states of the instrument. buffer.clearstats() (on page 14-10) buffer.delete() (on page 14-11) buffer.getstats() (on page 14-12) buffer.make() (on page 14-15) buffer.math()
Section 13: Introduction to TSP commands Model 2470 High Voltage SourceMeter Instrument Reference Manual Reset Resets settings to their default settings. digio.line[N].reset() (on page 14-64) reset() (on page 14-124) smu.reset() (on page 14-184) timer.cleartime() (on page 14-229) trigger.blender[N].reset() (on page 14-232) trigger.timer[N].reset() (on page 14-300) tsplink.line[N].reset()
Page 685
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands SMU measure commands are: smu.measure.autorange (on page 14-133) smu.measure.autorangehigh (on page 14-134) smu.measure.autorangelow (on page 14-135) smu.measure.autorangerebound (on page 14-136) smu.measure.autozero.enable (on page 14-138) smu.measure.autozero.once() (on page 14-139) smu.measure.configlist.catalog() (on page 14-139) smu.measure.configlist.create()
Page 686
Section 13: Introduction to TSP commands Model 2470 High Voltage SourceMeter Instrument Reference Manual SMU source commands are: smu.source.autorange (on page 14-184) smu.source.autodelay (on page 14-185) smu.source.configlist.catalog() (on page 14-186) smu.source.configlist.create() (on page 14-186) smu.source.configlist.delete() (on page 14-187) smu.source.configlist.query() (on page 14-188) smu.source.configlist.recall() (on page 14-189) smu.source.configlist.size()
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands Status model The status model is a set of status registers and queues. You can use the following commands to manipulate and monitor these registers and queues to view and control various instrument events.
Section 13: Introduction to TSP commands Model 2470 High Voltage SourceMeter Instrument Reference Manual Trigger model The trigger model commands allow you to control and set the trigger model options. trigger.model.abort() (on page 14-253) trigger.model.getblocklist() (on page 14-254) trigger.model.getbranchcount() (on page 14-254) trigger.model.initiate() (on page 14-255) trigger.model.load() —...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands Triggering The triggering commands allow you to set the conditions that the instrument uses to determine when measurements are captured. trigger.blender[N].clear() (on page 14-230) trigger.blender[N].orenable (on page 14-231) trigger.blender[N].overrun (on page 14-232) trigger.blender[N].reset()
Section 13: Introduction to TSP commands Model 2470 High Voltage SourceMeter Instrument Reference Manual trigger.tsplinkin[N].overrun (on page 14-307) trigger.tsplinkin[N].wait() (on page 14-308) trigger.tsplinkout[N].assert() (on page 14-308) trigger.tsplinkout[N].logic (on page 14-309) trigger.tsplinkout[N].pulsewidth (on page 14-310) trigger.tsplinkout[N].release() (on page 14-310) trigger.tsplinkout[N].stimulus (on page 14-311) trigger.wait() (on page 14-312) TSP-Link...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 13: Introduction to TSP commands TSP-Net TSP-Net provides a simple socket-like programming interface to Test Script Processor (TSP) enabled instruments. tspnet.clear() (on page 14-320) tspnet.connect() (on page 14-321) tspnet.disconnect() (on page 14-322) tspnet.execute() (on page 14-323) tspnet.idn()
Section 14 TSP command reference In this section: TSP command programming notes ........14-1 Using the TSP command reference ........14-4 TSP commands ..............14-9 TSP command programming notes This section contains general information about using TSP commands. TSP syntax rules This section provides rules that explain what you can and cannot do when entering TSP commands.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual White space You can send commands with or without white spaces. For example, the following functions, which set the length and frequency of the instrument beeper, are equivalent: beeper.beep(2,2400) beeper.beep (2, 2400)
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Local and remote control The instrument can be controlled locally or remotely. When the instrument is controlled locally, you operate the instrument using the front-panel controls. When it is controlled remotely, you operate the instrument through a controller (usually a computer).
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Using the TSP command reference The TSP command reference contains detailed descriptions of each of the TSP commands that you can use to control your instrument. Each command description is broken into subsections.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Command name, brief description, and summary table Each instrument command description starts with the command name, followed by a brief description and a table with information for each command. Descriptions of the numbered items in the figure below are provided below.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Where saved. Indicates where the command settings reside once they are used on an instrument. Options include: ▪ Not saved: Command is not saved and must be typed each time you use it. ▪...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference User-supplied parameters: Indicated by italics. For example, for the function beeper.beep(duration, frequency), replace duration with the number of seconds and frequency with the frequency of the tone. Send beeper.beep(2, 2400) to generate a two-second, 2400 Hz tone.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example section The Example section of the remote command description shows examples of how you can use the command. Figure 153: TSP example code Actual example code that you can copy from this table and paste into your own programming application.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference TSP commands The TSP commands available for the instrument are listed in alphabetical order. available() This function checks for the presence of specific instrument functionality. Type TSP-Link accessible Affected by Where saved Default value...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details You can use the beeper of the instrument to provide an audible signal at a specific frequency and time duration. For example, you can use the beeper to signal the end of a lengthy sweep.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference buffer.delete() This function deletes a user-defined reading buffer. Type TSP-Link accessible Affected by Where saved Default value Function Usage buffer.delete(bufferName) bufferName The name of a user-defined reading buffer Details You cannot delete the default reading buffers, defbuffer1 and defbuffer2.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual buffer.getstats() This function returns statistics from a specified reading buffer. Type TSP-Link accessible Affected by Where saved Default value Function Usage statsVar = buffer.getstats() statsVar = buffer.getstats(bufferVar) statsVar = buffer.getstats(bufferVar, absStartTime, absStartFractional, absEndTime, absEndFractional) statsVar = buffer.getstats(bufferVar, relStartTime, relEndTime)
Page 704
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference The statsVar parameter contains the values described in the following table. Attribute When returned Description n 0 A table that contains data about the minimum reading value that was added to the buffer;...
Page 705
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example reset() trigger.model.load("SimpleLoop", 12, 0.001, defbuffer1) trigger.model.initiate() waitcomplete() stats = buffer.getstats(defbuffer1) print(stats) Reset the instrument. Set up the SimpleLoop trigger-model template to make 12 readings with a 0.001 s delay. Readings are stored in defbuffer1.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference buffer.make() This function creates a user-defined reading buffer. Type TSP-Link accessible Affected by Where saved Default value Function Usage bufferVar = buffer.make(bufferSize) bufferVar = buffer.make(bufferSize, style) bufferVar The name of the buffer bufferSize The maximum number of readings that can be stored in bufferVar;...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Writable reading buffers are used to bring external data into the instrument. You cannot assign them to collect data from the instrument. You can change the buffer capacity for an existing buffer through the front panel or by using the bufferVar.capacity command.
Page 708
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference readingBuffer The name of the reading buffer; the reading buffer selected must be set to the style FULL unit The units to be applied to the value generated by the expression: ▪...
Page 709
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual You must use remote commands to set up the expressions, but you can view results from the front panel using the reading table and the graph. To use mathematical expressions, you must use a reading buffer that is set to the style FULL.
Page 710
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Example reset() mathExp = buffer.make(200, buffer.STYLE_FULL) smu.measure.func = smu.FUNC_DC_VOLTAGE buffer.math(mathExp, buffer.UNIT_NONE, buffer.EXPR_MULTIPLY) for x = 1, 3 do print("Reading: ", smu.measure.read(mathExp)) display.changescreen(display.SCREEN_READING_TABLE) print("Extra value reading 1: ", mathExp.extravalues[1]) print("Extra value reading 2: ", mathExp.extravalues[2]) print("Extra value reading 3: ", mathExp.extravalues[3]) Reset the instrument.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual buffer.save() This function saves data from the specified reading buffer to a USB flash drive. Type TSP-Link accessible Affected by Where saved Default value Function Usage buffer.save(bufferVar, "fileName") buffer.save(bufferVar, "fileName", timeFormat) buffer.save(bufferVar, "fileName", timeFormat, start, end) bufferVar...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Also see buffer.make() (on page 14-15) buffer.saveappend() (on page 14-21) Reading buffers (on page 7-1) Remote buffer operation (on page 7-26) buffer.saveappend() This function appends data from the reading buffer to a file on the USB flash drive. Type TSP-Link accessible Affected by...
Page 713
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual buffer.saveappend(bufferVar, "/usb1/myData.txt") — The only allowed extension is .csv. If .csv is not assigned, it is automatically added. Example 1 buffer.saveappend(MyBuffer, "/usb1/myData.csv") Append reading and default time information from a buffer named MyBuffer to a file named myData.csv on the USB flash drive.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Also see buffer.make() (on page 14-15) buffer.save() (on page 14-20) Reading buffers (on page 7-1) Remote buffer operation (on page 7-26) buffer.unit() This function allows you to create up to three custom units of measure for use in buffers. Type TSP-Link accessible Affected by...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example reset() mathExp = buffer.make(200, buffer.STYLE_FULL) smu.measure.func = smu.FUNC_DC_VOLTAGE buffer.unit(buffer.UNIT_CUSTOM1, "fb") buffer.math(mathExp, buffer.UNIT_CUSTOM1, buffer.EXPR_MULTIPLY) for x = 1, 3 do print("Reading "..x..":", smu.measure.read(mathExp)) display.changescreen(display.SCREEN_READING_TABLE) for x = 1, 3 do print("Extra value reading "..x..":", mathExp.extravalues[x]) Instrument has terminals set to FRONT.
Page 716
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Details This command allows you to change or view how many readings a buffer can store. Changing the size of a buffer will cause any existing data in the buffer to be lost. If you select 0, the instrument creates the largest reading buffer possible based on the available memory when the buffer is created.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual bufferVar.clear() This function clears all readings and statistics from the specified buffer. Type TSP-Link accessible Affected by Where saved Default value Function Usage bufferVar.clear() bufferVar The name of the reading buffer, which may be a default buffer (defbuffer1 or defbuffer2) or a user-defined buffer Example reset()
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference bufferVar.dates This attribute contains the dates of readings that are stored in the reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Restore configuration Not applicable Not applicable Instrument reset...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual bufferVar.endindex This attribute indicates the last index in a reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Restore configuration Not applicable Not applicable Instrument reset Power cycle Usage...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference bufferVar.extraformattedvalues This attribute contains the measurement and the unit of measure of the additional values in a reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Restore configuration Not applicable...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Also see buffer.delete() (on page 14-11) buffer.make() (on page 14-15) bufferVar.clear() (on page 14-26) print() (on page 14-119) printbuffer() (on page 14-120) Reading buffers (on page 7-1) Remote buffer operation (on page 7-26) bufferVar.extravalues...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Also see buffer.delete() (on page 14-11) buffer.make() (on page 14-15) bufferVar.clear() (on page 14-26) print() (on page 14-119) printbuffer() (on page 14-120) Reading buffers (on page 7-1) Remote buffer operation (on page 7-26) bufferVar.extravalueunits...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Also see buffer.delete() (on page 14-11) buffer.make() (on page 14-15) bufferVar.clear() (on page 14-26) print() (on page 14-119) printbuffer() (on page 14-120) Reading buffers (on page 7-1) Remote buffer operation (on page 7-26) bufferVar.fillmode...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Also see buffer.delete() (on page 14-11) buffer.make() (on page 14-15) bufferVar.clear() (on page 14-26) print() (on page 14-119) printbuffer() (on page 14-120) Reading buffers (on page 7-1) Remote buffer operation (on page 7-26) bufferVar.formattedreadings...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Also see bufferVar.readings (on page 14-37) buffer.delete() (on page 14-11) buffer.make() (on page 14-15) bufferVar.clear() (on page 14-26) print() (on page 14-119) printbuffer() (on page 14-120) Reading buffers (on page 7-1) Remote buffer operation (on page 7-26)
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Also see bufferVar.seconds (on page 14-39) buffer.delete() (on page 14-11) buffer.make() (on page 14-15) bufferVar.clear() (on page 14-26) print() (on page 14-119) printbuffer() (on page 14-120) Reading buffers (on page 7-1) Remote buffer operation (on page 7-26)
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual bufferVar.n This attribute contains the number of readings in the specified reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Restore configuration Not applicable Not applicable Instrument reset Power cycle...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Also see buffer.delete() (on page 14-11) buffer.make() (on page 14-15) bufferVar.clear() (on page 14-26) print() (on page 14-119) printbuffer() (on page 14-120) Reading buffers (on page 7-1) Remote buffer operation (on page 7-26) bufferVar.readings...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual bufferVar.relativetimestamps This attribute contains the timestamps, in seconds, when each reading occurred, relative to the timestamp of the first entry in the reading buffer. Type TSP-Link accessible Affected by Where saved Default value...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference bufferVar.seconds This attribute contains the timestamp of a reading in seconds, in UTC format. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Restore configuration Not applicable Not applicable Instrument reset...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual bufferVar.sourceformattedvalues This attribute contains the source levels formatted as they appear on the front-panel display when the readings in the reading buffer were acquired. Type TSP-Link accessible Affected by Where saved Default value...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference bufferVar.sourcestatuses This attribute contains the source status conditions of the instrument for the reading point. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Restore configuration Not applicable Not applicable Instrument reset...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example reset() testData = buffer.make(50) smu.source.output = smu.ON trigger.model.load("SimpleLoop", 2, 0, testData) trigger.model.initiate() waitcomplete() printbuffer(1, 2, testData.sourcestatuses) Create a reading buffer named testData, configure the instrument to make two measurements, and store the readings in the buffer.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Example reset() Create a reading buffer named testData, testData = buffer.make(50) configure the instrument to make three smu.source.output = smu.ON measurements, and store the readings in the testData.fillmode = buffer.FILL_CONTINUOUS buffer.
Page 735
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details This attribute is like an array (a Lua table) of the sourced value in effect at the time of the reading. The values returned by this command depend on the source readback state: ▪...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference bufferVar.startindex This attribute indicates the starting index in a reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Restore configuration Not applicable Not applicable Instrument reset Power cycle Usage...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual bufferVar.statuses This attribute contains the status values of readings in the reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Restore configuration Not applicable Not applicable Instrument reset Power cycle...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Example reset() Create a reading buffer named testData, testData = buffer.make(50) configure the instrument to make two smu.source.output = smu.ON measurements, and store the readings in trigger.model.load("SimpleLoop", 2, 0, testData) the buffer.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example reset() This example creates a reading buffer testData = buffer.make(50) named testData and makes three trigger.model.load("SimpleLoop", 3, 0, testData) measurements. trigger.model.initiate() The print() command outputs the time waitcomplete() of the first reading.
Page 740
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Details This attribute contains the timestamps (date, hours, minutes, seconds, and fractional seconds) of readings stored in the reading buffer. When using the compact buffer style, there is a very small drift between the triggering clock and the timestamp clock, which may result in timestamp truncation and discontinuities over time.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual bufferVar.units This attribute contains the unit of measure that is stored with readings in the reading buffer. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Restore configuration Not applicable Not applicable...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Also see buffer.delete() (on page 14-11) buffer.make() (on page 14-15) bufferVar.clear() (on page 14-26) print() (on page 14-119) printbuffer() (on page 14-120) Reading buffers (on page 7-1) Remote buffer operation (on page 7-26) buffer.write.format()
Page 743
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual extraUnits The units for the second measurement in the buffer index; the selections are the same as units (only valid for buffer style WRITABLE_FULL); if not specified, uses the value for units extraDigits The number of digits to use for the second measurement;...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Example 2 extBuffer = buffer.make(100, buffer.STYLE_WRITABLE_FULL) buffer.write.format(extBuffer, buffer.UNIT_WATT, buffer.DIGITS_3_5, buffer.UNIT_WATT, buffer.DIGITS_3_5) buffer.write.reading(extBuffer, 1, 7) buffer.write.reading(extBuffer, 2, 8) buffer.write.reading(extBuffer, 3, 9) buffer.write.reading(extBuffer, 4, 10) buffer.write.reading(extBuffer, 5, 11) buffer.write.reading(extBuffer, 6, 12) printbuffer(1, 6, extBuffer.readings, extBuffer.units, extBuffer.extravalues, extBuffer.units) Creates a 100-point reading buffer named extBuffer.
Page 745
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual For buffers that are set to the full writable buffer style: buffer.write.reading(bufferVar, readingValue, extraValue) buffer.write.reading(bufferVar, readingValue, extraValue, seconds) buffer.write.reading(bufferVar, readingValue, extraValue, seconds, fractionalSeconds) buffer.write.reading(bufferVar, readingValue, extraValue, seconds, fractionalSeconds, status) bufferVar The name of the buffer...
Page 746
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Example 1 extBuffer = buffer.make(100, buffer.STYLE_WRITABLE) buffer.write.format(extBuffer, buffer.UNIT_WATT, buffer.DIGITS_3_5) buffer.write.reading(extBuffer, 1) buffer.write.reading(extBuffer, 2) buffer.write.reading(extBuffer, 3) buffer.write.reading(extBuffer, 4) buffer.write.reading(extBuffer, 5) buffer.write.reading(extBuffer, 6) printbuffer(1, 6, extBuffer.readings, extBuffer.units) Creates a 100-point reading buffer named extBuffer. Style is writable. Set the data format to show units of watts with 3½...
Page 747
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual createconfigscript() This function creates a setup file that captures most of the present settings of the instrument. Type TSP-Link accessible Affected by Where saved Default value Function Usage createconfigscript("scriptName") scriptName...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: 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...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Also see dataqueue.CAPACITY (on page 14-58) dataqueue.clear() (on page 14-59) dataqueue.count (on page 14-60) dataqueue.next() (on page 14-61) Using the data queue for real-time communications (on page 10-11) dataqueue.CAPACITY This constant is the maximum number of entries that you can store in the data queue.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference dataqueue.clear() This function clears the data queue. Type TSP-Link accessible Affected by Where saved Default value Function Usage dataqueue.clear() Details This function forces all dataqueue.add() commands that are in progress to time out and deletes all data from the data queue.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual dataqueue.count This attribute contains the number of items in the data queue. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage count = dataqueue.count...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference dataqueue.next() This function removes the next entry from the data queue. Type TSP-Link accessible Affected by Where saved Default value Function Usage value = dataqueue.next() value = dataqueue.next(timeout) value The next entry in the data queue timeout...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Also see dataqueue.add() (on page 14-57) dataqueue.CAPACITY (on page 14-58) dataqueue.clear() (on page 14-59) dataqueue.count (on page 14-60) format.asciiprecision (on page 14-95) Using the data queue for real-time communications (on page 10-11) delay() This function delays the execution of the commands that follow it.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference digio.line[N].mode This attribute sets the mode of the digital I/O line to be a digital line, trigger line, or synchronous line and sets the line to be input, output, or open-drain. Type TSP-Link accessible Affected by...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual The following settings of lineMode set the line as a trigger line: • digio.MODE_TRIGGER_IN: The line automatically responds to and detects externally generated triggers. It detects falling-edge, rising-edge, or either-edge triggers as input. This line state uses the edge setting specified by the trigger.digin[N].edge attribute.
Page 756
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Details This function resets the following attributes to their default values: ▪ digio.line[N].mode ▪ trigger.digin[N].edge ▪ trigger.digout[N].logic ▪ trigger.digout[N].pulsewidth ▪ trigger.digout[N].stimulus It also clears trigger.digin[N].overrun. Example -- Set the digital I/O trigger line 3 for a falling edge digio.line[3].mode = digio.MODE_TRIGGER_OUT trigger.digout[3].logic = trigger.LOGIC_NEGATIVE -- Set the digital I/O trigger line 3 to have a pulsewidth of 50 microseconds.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual digio.line[N].state This function sets a digital I/O line high or low when the line is set for digital control and returns the state on the digital I/O lines. Type TSP-Link accessible Affected by...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Details The binary equivalent of the returned value indicates the value of the input lines on the digital I/O port. The least significant bit (bit B1) of the binary number corresponds to digital I/O line 1;...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example 1 digio.writeport(63) Sets digital I/O lines 1 through 6 high (binary 111111). Example 2 digio.writeport(0b111111) Sets digital I/O lines 1 through 6 high (digital 63). Also see digio.readport() (on page 14-66) Digital I/O port configuration...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference display.changescreen() This function changes which front-panel screen is displayed. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.changescreen(screenName) screenName The screen to display: ▪ Home screen: display.SCREEN_HOME ▪...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual display.clear() This function clears the text from the front-panel USER swipe screen. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.clear() Example display.clear() Clear the USER swipe screen. display.changescreen(display.SCREEN_USER_SWIPE) Set the first line to read "Serial display.settext(display.TEXT1, "Serial number:")
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Example removePrompt3 = display.prompt(display.BUTTONS_NONE, "This prompt will disappear in 3 seconds") delay(3) display.delete(removePrompt3) This example displays a prompt that is automatically removed in three seconds. Also see display.prompt() (on page 14-79) display.input.number()
Page 763
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual defaultValue The value that is initially displayed in the displayed keypad minimumValue The lowest value that can be entered maximumValue The highest value that can be entered Details This command prompts the instrument operator to enter a value.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference display.input.option() This function allows you to create an option dialog box with customizable buttons on the front-panel display. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.BUTTON_OPTIONn = display.input.option("dialogTitle", "buttonTitle1",...
Page 765
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example optionID = display.input.option("Select an option", "Apple", "Orange", "Papaya", "Pineapple", "Blueberry", "Banana", "Grapes", "Peach", "Apricot", "Guava") print(optionID) This example displays the following dialog box: If the user selects Peach, the return is display.BUTTON_OPTION8. Also see display.input.number() (on page 14-71)
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference display.input.prompt() This function allows you to create a prompt that accepts a user response from the front-panel display. Type TSP-Link accessible Affected by Where saved Default value Function Usage buttonReturn = display.input.prompt(buttonSet, "dialogTitle")
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example result = display.input.prompt(display.BUTTONS_YESNO, "Do you want to display the graph screen?") if result == display.BUTTON_YES then display.changescreen(display.SCREEN_GRAPH) This displays the prompt "Do you want to display the graph screen?" on the front-panel display: If the operator selects Yes, the graph screen is displayed.
Page 768
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Details This command creates a prompt to the instrument operator to enter a string value. The prompt is displayed until it has been responded to. You can only send one input prompt command at a time.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual display.lightstate This attribute sets the light output level of the front-panel display. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Power cycle Not applicable display.STATE_LCD_50 Usage brightness = display.lightstate...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference display.prompt() This function allows you to create an interactive dialog prompt that displays a custom message on the front-panel display. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example smu.source.sweeplinear("test", 1, 10, 10) display.prompt(display.BUTTONS_YESNO, "Would you like to start the sweep now?") sweepTest, result = display.waitevent() if result == display.BUTTON_YES then trigger.model.initiate() display.prompt(display.BUTTONS_YESNO, "Would you like to switch to the Graph screen?") promptID, result = display.waitevent() if result == display.BUTTON_YES then...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference display.settext() This function defines the text that is displayed on the front-panel USER swipe screen. Type TSP-Link accessible Affected by Where saved Default value Function Usage display.settext(display.TEXT1, "userDisplayText1") display.settext(display.TEXT2, "userDisplayText2") userDisplayText1 String that contains the message for the top line of the USER swipe screen (up to 20...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Also see display.clear() (on page 14-70) display.changescreen() (on page 14-69) display.waitevent() This function causes the instrument to wait for a user to respond to a prompt that was created with a prompt command.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Example smu.source.sweeplinear("test", 1, 10, 10) display.prompt(display.BUTTONS_YESNO, "Would you like to start the sweep now?") sweepTest, result = display.waitevent() if result == display.BUTTON_YES then trigger.model.initiate() display.prompt(display.BUTTONS_YESNO, "Would you like to switch to the Graph screen?") promptID, result = display.waitevent() if result == display.BUTTON_YES then...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual eventlog.getcount() This function returns the number of unread events in the event log. Type TSP-Link accessible Affected by Where saved Default value Function Usage eventlog.getcount() eventlog.getcount(eventType) eventType Limits the return to specific event log types;...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference eventlog.next() This function returns the oldest unread event message from the event log. Type TSP-Link accessible Affected by Where saved Default value Function Usage eventNumber, message, severity, nodeID, timeSeconds, timeNanoSeconds = eventlog.next() eventNumber, message, severity, nodeID, timeSeconds, timeNanoSeconds = eventlog.next(eventType)
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details When an event occurs on the instrument, it is placed in the event log. The eventlog.next() command retrieves an unread event from the event log. Once an event is read, it can no longer be accessed remotely.
Page 778
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Details You can use this command to create your own event log entries and assign a severity level to them. This can be useful for debugging and status reporting. From the front panel, you must set the Log Warnings and Log Information options on to have the custom warning and information events placed into the event log.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual eventlog.save() This function saves the event log to a file on a USB flash drive. Type TSP-Link accessible Affected by Where saved Default value Function Usage eventlog.save("filename") eventlog.save("filename", eventType) filename A string that represents the name of the file to be saved...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference exit() This function stops a script that is presently running. Type TSP-Link accessible Affected by Where saved Default value Function Usage exit() Details Terminates script execution when called from a script that is being executed. This command does not wait for overlapped commands to complete before terminating script execution.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual file.flush() This function writes buffering data to a file on the USB flash drive. Type TSP-Link accessible Affected by Where saved Default value Function Usage file.flush(fileNumber) fileNumber The file number returned from the file.open() function to flush Details The file.write() function may be buffering data instead of writing immediately to the...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference -- Write the string data to a file file.write(fileNumber, "Tested to Company Standard ABC.123\n") -- Ensure a hurry-up of data written to the file before close or script end file.flush(fileNumber) -- Close the data file file.close(fileNumber)
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual file.open() This function opens a file on the USB flash drive for later reference. Type TSP-Link accessible Affected by Where saved Default value Function Usage fileNumber = file.open("fileName", accessType) fileNumber A number identifying the open file that you use with other file commands to write, read, flush, or close the file after opening...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference file.read() This function reads data from a file on the USB flash drive. Type TSP-Link accessible Affected by Where saved Default value Function Usage fileContents = file.read(fileNumber, readAction) fileContents The contents of the file based on the readAction parameter fileNumber...
Page 785
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details You can call this command from a script to verify that a USB flash drive is inserted before attempting to write data to it. Example local response local xMax = 10 for x = 1, xMax do -- Make xMax readings and store them in defbuffer1.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference file.write() This function writes data to a file on the USB flash drive. Type TSP-Link accessible Affected by Where saved Default value Function Usage file.write(fileNumber, "string") fileNumber The file number returned from the file.open() function to write string A string that contains the data to write to the file...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details This attribute specifies the precision (number of digits) for numeric data printed with the print(), printbuffer(), and printnumber() functions. The format.asciiprecision attribute is only used with the ASCII format. The precision value must be a number from 0 to 16.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Example x = 1.23 The output depends on the terminal program format.data = format.REAL32 you use, but it looks something like: #0¤p?? format.byteorder = format.LITTLEENDIAN #0??p¤ printnumber(x) format.byteorder = format.BIGENDIAN printnumber(x) Also see...
Page 789
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example format.asciiprecision = 10 Output a number represented by x in ASCII x = 3.14159265 using a precision of 10, then output the same format.data = format.ASCII number in binary using double-precision printnumber(x) format.
Page 790
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Also see None fs.cwd() This function returns the absolute path of the current working directory. Type TSP-Link accessible Affected by Where saved Default value Function Usage path = fs.cwd() path The absolute path of the current working directory Example...
Page 791
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details The file system path may be absolute or relative to the current working system path. 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.
Page 792
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference 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 793
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details The directory path may be absolute or relative to the current working directory. This command is nonrecursive. For example, entries in subfolders are not returned. An error is logged to the error queue if the given path does not exist or does not represent a directory.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Example rootDirectory = "/usb1/" tempDirectoryName = "temp" if fs.is_dir(rootDirectory..tempDirectoryName) == false then fs.mkdir(rootDirectory..tempDirectoryName) fs.rmdir(rootDirectory..tempDirectoryName) Insert a USB flash drive into the front panel of the instrument. Set rootDirectory to be the USB port. Set tempDirectoryName to be equivalent to temp.
Page 795
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example gpib.address = 26 address = gpib.address print(address) Sets the GPIB address and reads the address. Output: Also see GPIB setup (on page 3-3) lan.dstprotection This command allows you to prevent LAN connections from being closed inadvertently. Type TSP-Link accessible Affected by...
Page 796
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference lan.ipconfig() This function specifies the LAN configuration for the instrument. Type TSP-Link accessible Affected by Where saved Default value Function Rear panel LAN reset Nonvolatile memory lan.MODE_AUTO Usage method, ipV4Address, subnetMask, gateway = lan.ipconfig() lan.ipconfig(method)
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual lan.lxidomain This attribute contains the LXI domain. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) LAN restore defaults Nonvolatile memory Usage domain = lan.lxidomain lan.lxidomain = domain domain The LXI domain number (0 to 255)
Page 798
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference localnode.access This attribute contains the type of access users have to the instrument through different interfaces. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Not applicable Nonvolatile memory localnode.ACCESS_FULL...
Page 799
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual localnode.analogrevision This attribute stores the revision number of the 2470 analog board. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage revisionno = localnode.analogrevision...
Page 800
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference localnode.gettimewithfractional() This function retrieves the number of seconds elapsed since January 1, 1970, with fractional seconds appended to the returned response. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
Page 801
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual localnode.model This attribute stores the model number. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage model = localnode.model model The model number of the instrument Example...
Page 802
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Also see localnode.access (on page 14-107) 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...
Page 803
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Do not disable prompting when using Test Script Builder. Test Script Builder requires prompts and sets the prompting mode automatically. If you disable prompting, the instrument stops responding when you communicate using Test Script Builder because it is waiting for a common complete prompt from Test Script Builder.
Page 804
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference localnode.serialno This attribute stores the serial number of the instrument. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Not applicable Not applicable Not applicable Usage serialno = localnode.serialno serialno...
Page 805
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details Internally, the instrument bases time in UTC time. UTC time is specified as the number of seconds since Jan 1, 1970, UTC. You can use UTC time from a local time specification, or you can use UTC time from another source (for example, your computer).
Page 806
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Details Enable this attribute to have the instrument output generated events to the remote interface. Events are output after a command message is executed but before prompts are issued (if prompts are enabled with localnode.prompts).
Page 807
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual node[N].execute() This function starts test scripts on a remote TSP-Link node. Type TSP-Link accessible Affected by Where saved Default value Function Yes (see Details) Usage node[N].execute("scriptCode") The node number of this instrument: 1 to 63 scriptCode A string containing the source code Details...
Page 808
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference node[N].getglobal() This function returns the value of a global variable. Type TSP-Link accessible Affected by Where saved Default value Function Usage value = node[N].getglobal("name") value The value of the variable The node number of this instrument: 1 to 63 name The global variable name...
Page 809
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example node[3].setglobal("x", 5) Sets the global variable x on node 3 to the value of 5. Also see node[N].getglobal() (on page 14-117) opc() This function sets the operation complete (OPC) bit after all pending commands, including overlapped commands, have been executed.
Page 810
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: 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 811
Section 14: TSP command reference Model 2470 High Voltage 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 812
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Attribute Description bufferVar.readings The readings stored in a specified reading buffer. See bufferVar.readings (on page 14-37). bufferVar.dates The dates of readings stored in the reading buffer. See bufferVar.dates (on page 14-27).
Page 813
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example 1 reset() testData = buffer.make(200) format.data = format.ASCII format.asciiprecision = 6 trigger.model.load("SimpleLoop", 6, 0, testData) trigger.model.initiate() waitcomplete() printbuffer(1, testData.n, testData.readings, testData.units, testData.relativetimestamps) Reset the instrument. Set the data format and ASCII precision. Use trigger model SimpleLoop to create a 6-count loop with no delays that stores data in the reading buffer testBuffer.
Page 814
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference printnumber() This function prints numbers using the configured format. Type TSP-Link accessible Affected by Where saved Default value Function Usage printnumber(value1) printnumber(value1, value2) printnumber(value1, ..., valueN) value1 First value to print in the configured format value2 Second value to print in the configured format...
Page 815
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual reset() This function resets commands to their default settings and clears the buffers. Type TSP-Link accessible Affected by Where saved Default value Function Usage reset() reset(system) system If the node is the master, the entire system is reset: true Only the local group is reset: false Details...
Page 816
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Details This function accesses the catalog of scripts stored in nonvolatile memory, which allows you to process all scripts in nonvolatile memory. The entries are enumerated in no particular order.
Page 817
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual script.load() This function creates a script from a specified file. Type TSP-Link accessible Affected by Where saved Default value Function Usage script.load("file") scriptVar = script.load("file") file A string that contains the path and file name of the script file to load; if scriptVar is not defined, this name is used as the global variable name for this script scriptVar The created script;...
Page 818
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Example test8.run() Runs the script referenced by the variable test8. Also see None scriptVar.save() This function saves the script to nonvolatile memory or to a USB flash drive. Type TSP-Link accessible Affected by...
Page 819
Section 14: TSP command reference Model 2470 High Voltage 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 (R) Not applicable Not applicable Not applicable Usage code = scriptVar.source code...
Page 820
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference smu.breakdownprotection This attribute allows you to enable the breakdown protection in situations where the current may exceed the programmed current or the limit current value due to a breakdown condition. Type TSP-Link accessible Affected by...
Page 821
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual When the breakdown protection is set for AUTO operation, the clamp is in place for the 200 V range, 1000 V range, and current ranges less than or equal to the 10 mA range. Above the 10 mA range or on lower voltage ranges, the breakdown protection clamp is automatically taken out of series with the SMU force lead.
Page 822
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Example selection = display.input.option("Breakdown Control", "Auto", "Always On", "Always Off") if selection ~= nil then if selection == display.BUTTON_OPTION1 then smu.breakdownprotection = smu.BREAKDOWN_AUTO elseif selection == display.BUTTON_OPTION2 then smu.breakdownprotection = smu.BREAKDOWN_ON elseif selection == display.BUTTON_OPTION3 then smu.breakdownprotection = smu.BREAKDOWN_OFF...
Page 823
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual If Interlock is set to On, when the safety interlock signal is not asserted, the following occurs: • You cannot turn on the source output. • The front-panel INTERLOCK indicator is not illuminated. •...
Page 824
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Details This command gives you the status of the interlock. When the safety interlock signal is asserted, all voltage ranges of the instrument are available. However, when the safety interlock signal is not asserted, the 200 V and 1000 V ranges are hardware limited to a nominal output of less than ±42 V.
Page 825
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details Autorange selects the best range in which to measure the signal that is applied to the input terminals of the instrument. When autorange is enabled, the range increases at 100 percent of range.
Page 826
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Details This command can be written to and read for resistance measurements. For current and voltage measurements, it can only be read. For current and voltage measurements, the upper limit is controlled by the current or voltage limit.
Page 827
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details You can use this command when automatic range selection is enabled. It prevents the instrument from selecting a range that is below this limit. Because the lowest ranges generally require longer settling times, setting the low limit that is appropriate for your application but above the lowest possible range can make measurements require less settling time.
Page 828
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Details The effective source limit is the lesser of either the programmed source limit or 105% of the active measure range. If you use fixed measure ranges, the instrument prevents you from selecting different limit and measure ranges.
Page 829
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual smu.measure.autozero.enable This attribute enables or disables automatic updates to the internal reference measurements (autozero) of the instrument. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script smu.ON...
Page 830
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference smu.measure.autozero.once() This function causes the instrument to refresh the reference and zero measurements once. Type TSP-Link accessible Affected by Where saved Default value Function Usage smu.measure.autozero.once() Details This command forces a refresh of the reference and zero measurements that are used for the present aperture setting for the selected function.
Page 831
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example print(smu.measure.configlist.catalog()) Request the name of one measure configuration list that is stored in the instrument. Send the command again until it returns nil to get all stored lists. print(smu.measure.configlist.catalog()) If there are two configuration lists on the instrument.
Page 832
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference smu.measure.configlist.delete() This function deletes a measure configuration list. Type TSP-Link accessible Affected by Where saved Default value Function Usage smu.measure.configlist.delete("listName") smu.measure.configlist.delete("listName", index) listName A string that represents the name of a measure configuration list index A number that defines a specific configuration index in the configuration list Details...
Page 833
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual smu.measure.configlist.query() This function returns a list of TSP commands and parameter settings that are stored in the specified configuration index. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
Page 834
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Example print(smu.measure.configlist.query("testMeasList", 2, "\n")) Returns the TSP commands and parameter settings that represent the settings in configuration index 2. Example output: smu.measure.func = smu.FUNC_DC_CURRENT smu.measure.range = 1.000000e-08 smu.measure.autorange = smu.ON smu.measure.autorangelow = 1.000000e-08 smu.measure.autozero.enable = smu.ON...
Page 835
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual smu.measure.configlist.recall() This function recalls a configuration index in a measure configuration list and an optional source configuration list. Type TSP-Link accessible Affected by Where saved Default value Function Usage smu.measure.configlist.recall("listName")
Page 836
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference For additional information about the information this command recalls when using a configuration list query command, see Settings stored in a measure configuration index page 5-66). Example smu.measure.configlist.recall("MyMeasList") Because an index was not specified, this command recalls configuration index 1 from...
Page 837
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual smu.measure.configlist.store() This function stores the active measure settings into the named configuration list. Type TSP-Link accessible Affected by Where saved Default value Function Usage smu.measure.configlist.store("listName") smu.measure.configlist.store("listName", index) listName A string that represents the name of a measure configuration list index...
Page 838
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference smu.measure.configlist.storefunc() This function allows you to store the settings for a measure function into a measure configuration list whether or not the function is active. Type TSP-Link accessible Affected by Where saved Default value...
Page 839
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual smu.measure.count This attribute sets the number of measurements to make when a measurement is requested. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script Instrument reset Measure configuration list...
Page 840
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Example 1 reset() -- Set up measure function smu.measure.func = smu.FUNC_DC_CURRENT smu.terminals = smu.TERMINALS_REAR smu.measure.autorange = smu.ON smu.measure.nplc = 1 smu.measure.count = 200 -- Set up source function smu.source.func = smu.FUNC_DC_VOLTAGE smu.source.ilimit.level = 0.1 smu.source.level = 20...
Page 841
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example 2 reset() -- Set up measure function smu.measure.func = smu.FUNC_DC_CURRENT smu.terminals = smu.TERMINALS_REAR smu.measure.autorange = smu.ON smu.measure.nplc = 1 -- Set up source function smu.source.func = smu.FUNC_DC_VOLTAGE smu.source.ilimit.level = 0.1 smu.source.level = 20 smu.source.delay = 0.1...
Page 842
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference smu.measure.displaydigits This attribute determines the number of digits that are displayed for measurements on the front panel for the selected function. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration...
Page 843
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual smu.measure.filter.count This attribute sets the number of measurements that are averaged when filtering is enabled. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script Instrument reset Measure configuration list...
Page 844
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference smu.measure.filter.enable This attribute enables or disables the averaging filter for the selected measurement function. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script smu.OFF Instrument reset...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual smu.measure.filter.type This attribute sets the type of averaging filter that is used for the selected measure function when the measurement filter is enabled. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference The repeating average filter produces slower results but produces more stable results than the moving average filter. For either method, the greater the number of measurements that are averaged, the slower the averaged sample rate, but the lower the noise error.
Page 847
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example smu.measure.func = smu.FUNC_DC_VOLTAGE Sets the instrument to measure voltage and smu.measure.math.format = smu.MATH_PERCENT set the math format to percent and enable smu.measure.math.enable = smu.ON the math functions. smu.measure.func = smu.FUNC_RESISTANCE Set the instrument to measure resistance and set the math format to reciprocal and...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference smu.measure.limit[Y].audible This attribute determines if the instrument beeper sounds when a limit test passes or fails. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script smu.AUDIBLE_NONE...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual smu.measure.limit[Y].autoclear This attribute indicates if the test result for limit Y should be cleared automatically or not. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script smu.ON...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference smu.measure.limit[Y].clear() This function clears the results of the limit test defined by Y for the selected measurement function. Type TSP-Link accessible Affected by Where saved Default value Function Usage smu.measure.limit[Y].clear()
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details This command enables or disables a limit test for the selected measurement function. When this attribute is enabled, the limit Y testing occurs on each measurement made by the instrument.
Page 852
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Details This command queries the result of a limit test for the selected measurement function. The response message indicates if the limit test passed or how it failed (on the high or low limit).
Page 853
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual reset() -- set the instrument source current smu.source.func = smu.FUNC_DC_CURRENT -- set the instrument to measure voltage smu.measure.func = smu.FUNC_DC_VOLTAGE -- set the range to 10 V smu.measure.range = 10 -- set the nplc to 0.1 smu.measure.nplc = 0.1...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference smu.measure.limit[Y].high.value This attribute specifies the upper limit for a limit test. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script Instrument reset Measure configuration list Power cycle Measure configuration list...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual smu.measure.limit[Y].low.value This attribute specifies the lower limit for a limit test. Type TSP-Link accessible Affected by Where saved Default value −1 Attribute (RW) Restore configuration Configuration script Instrument reset Measure configuration list Power cycle...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference smu.measure.math.enable This attribute enables or disables math operations on measurements for the selected measurement function. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script smu.OFF Instrument reset...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual smu.measure.math.format This attribute specifies which math operation is performed on measurements when math operations are enabled. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script smu.MATH_PERCENT...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Also see Calculations that you can apply to measurements (on page 5-32) smu.measure.math.enable (on page 14-165) smu.measure.math.mxb.bfactor (on page 14-167) smu.measure.math.mxb.mfactor (on page 14-168) smu.measure.math.percent (on page 14-169) smu.measure.math.mxb.bfactor This attribute specifies the offset, b, for the y = mx + b operation.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example smu.measure.func = smu.FUNC_DC_VOLTAGE Set the measurement function to voltage. smu.measure.math.format = smu.MATH_MXB Set the math operation to mx+b. smu.measure.math.mxb.mfactor = 0.80 Set the scale factor for the mx +b operation smu.measure.math.mxb.bfactor = 50 to 0.80.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Example smu.measure.func = smu.FUNC_DC_VOLTAGE Set the measurement function to voltage. smu.measure.math.format = smu.MATH_MXB Set the math operation to mx+b. smu.measure.math.mxb.mfactor = 0.80 Set the scale factor for the mx+b operation to smu.measure.math.mxb.bfactor = 50 0.80.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example smu.measure.func = smu.FUNC_DC_VOLTAGE Set the measurement function to voltage. smu.measure.math.format = smu.MATH_PERCENT Set the math operations to percent. smu.measure.math.percent = 50 Set the percentage value to 50 for voltage smu.measure.math.enable = smu.ON measurements.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference The longest amount of time provides the lowest reading noise and more usable digits but has the slowest reading rate. Settings between the fastest and slowest number of power line cycles are a compromise between speed and noise.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example smu.measure.func = smu.FUNC_RESISTANCE Sets the measurement function to resistance. smu.measure.sense = smu.SENSE_4WIRE Set the instrument for 4-wire measurements smu.measure.offsetcompensation = smu.ON and turn offset compensation on. Turn on the source, make a measurement, and turn the smu.source.output = smu.ON source off.
Page 864
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference If the source function is the same as the measurement function (for example, sourcing voltage and measuring voltage), the measurement range is the same as the source range, regardless of measurement range setting.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details This function makes a measurement using the present function setting, stores the reading in a reading buffer, and returns the last reading. The smu.measure.count attribute determines how many measurements are performed. You can also use the trigger model Simple Loop.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Details This command initiates measurements using the present function setting, stores the readings in a reading buffer, and returns the last reading. The smu.measure.count attribute determines how many measurements are performed. When you use a reading buffer with a command or action that makes multiple readings, all readings are available in the reading buffer.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example smu.measure.func = smu.FUNC_DC_VOLTAGE Acquires a relative offset level value for rel_value = smu.measure.rel.acquire() voltage measurements and turns the relative smu.measure.rel.enable = smu.ON offset feature on. Also see smu.measure.rel.enable (on page 14-176) smu.measure.rel.level...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference smu.measure.rel.level This attribute contains the relative offset value. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script Instrument reset Measure configuration list Power cycle Measure configuration list Function change...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Also see Relative offset (on page 5-29) smu.measure.rel.acquire() (on page 14-175) smu.measure.rel.enable (on page 14-176) smu.measure.sense This attribute selects local (2-wire) or remote (4-wire) sensing. Type TSP-Link accessible Affected by Where saved Default value...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Example smu.measure.func = smu.FUNC_RESISTANCE Set the measurement function to resistance. smu.measure.sense = smu.SENSE_4WIRE Set the sense to 4-wire remote. Also see Two-wire local sense connections (on page 2-18) Four-wire remote sense connections (on page 2-20) smu.measure.setattribute()
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Measure options (on page 14-133): smu.ATTR_MEAS_RANGE_AUTO Autorange (on page 14-134): smu.ATTR_MEAS_RANGE_HIGH Autorange high limit (on page 14-135): smu.ATTR_MEAS_RANGE_LOW Autorange low limit (on page 14-136): smu.ATTR_MEAS_RANGE_REBOUND Autorange rebound (on page 14-138): smu.ATTR_MEAS_AUTO_ZERO Autozero enable (on page 14-148): smu.ATTR_MEAS_COUNT...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference smu.measure.unit This attribute sets the units of measurement that are displayed on the front panel of the instrument and stored in the reading buffer. Type TSP-Link accessible Affected by Where saved Default value...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual smu.measure.userdelay[N] This attribute sets a user-defined delay that you can use in the trigger model. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script 0 (0 s) Instrument reset...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference smu.rangecompensation This attribute controls how switched operation behaves. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script smu.RANGECOMP.AUTO Instrument reset Power cycle Usage setting = smu.rangecompensation smu.rangecompensation = setting...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual smu.reset() This function turns off the output and resets the commands that begin with smu. to their default settings. Type TSP-Link accessible Affected by Where saved Default value Function Usage smu.reset()
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Details This command indicates the state of the range for the selected source. When automatic source range is disabled, the source range is set manually. When automatic source range is enabled, the instrument selects the range that is most appropriate for the value that is being sourced.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example smu.source.autodelay = smu.OFF Turn off autodelay when current is being sourced. Also see smu.source.delay (on page 14-193) smu.source.configlist.catalog() This function returns the name of one source configuration list. Type TSP-Link accessible Affected by...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Details This command creates an empty configuration list. To add configuration indexes to this list, you need to use the store command. Configuration lists are not saved when the instrument is turned off. If you want to save a configuration list through a power cycle, create a configuration script to save instrument settings, including any defined configuration lists.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details Deletes a configuration list. If the index is not specified, the entire configuration list is deleted. If the index is specified, only the specified configuration index in the list is deleted. When an index is deleted from a configuration list, the index numbers of the following indexes are shifted up by one.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Example print(smu.source.configlist.query("MyScrList", 2)) Returns the TSP commands and parameter settings that represent the settings in configuration index 2. Also see Configuration lists (on page 5-65) smu.source.configlist.create() (on page 14-186) Settings stored in a source configuration index (on page 5-66) smu.source.configlist.recall()
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual To recall a source configuration list separately (not with this command), recall the source configuration list before the measure configuration list. This order ensures that dependencies between source and measure settings will be properly handled. Example smu.source.configlist.recall("MySourceList") Because an index was not specified, this...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Example print(smu.source.configlist.size("MyScrList")) Determine the number of configuration indexes in a source configuration list named MyScrList. Example output: Also see Configuration lists (on page 5-65) smu.source.configlist.create() (on page 14-186) smu.source.configlist.store() This function stores the active source settings into the named configuration list.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual smu.source.configlist.storefunc() This function allows you to store the settings for a source function into a source configuration list whether or not the function is active. Type TSP-Link accessible Affected by Where saved Default value...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference smu.source.delay This attribute contains the source delay. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script Instrument reset Source configuration list Power cycle Source configuration list Function change...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual smu.source.func This attribute contains the source function, which can be voltage or current. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script smu.FUNC_DC_VOLTAGE Instrument reset Source configuration list...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Details You can retrieve one attribute at a time. Example print(smu.source.getattribute(smu.FUNC_DC_CURRENT, smu.ATTR_SRC_DELAY)) Retrieve the source delay setting for DC current. Example return: 1.05e-07 Also see smu.source.setattribute() (on page 14-203) smu.source.highc This attribute enables or disables high-capacitance mode.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual smu.source.level This attribute immediately selects a fixed amplitude for the selected source function. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script Instrument reset Source configuration list Power cycle...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference smu.source.offmode This attribute defines the state of the source when the output is turned off. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script smu.OFFMODE_NORMAL Instrument reset...
Page 889
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual When the high-impedance output-off state is selected and the output is turned off: • The measurement sense is set to 2-wire • The output relay opens, disconnecting the instrument as a load Opening the relay disconnects external circuitry from the inputs and outputs of the instrument.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference smu.source.output This attribute enables or disables the source output. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script smu.OFF Instrument reset Source configuration list Power cycle Source configuration list...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details Overvoltage protection restricts the maximum voltage level that the instrument can source. It is in effect when either current or voltage is sourced. This protection is in effect for both positive and negative output voltages. When this attribute is used in a test sequence, it should be set before turning the source on.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Also see Overvoltage protection (on page 5-16) smu.source.protect.level (on page 14-199) smu.source.range This attribute selects the range for the source for the selected source function. Type TSP-Link accessible Affected by Where saved Default value...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual To select the range, you can specify the approximate source value that you will use. The instrument selects the lowest range that can accommodate that level. For example, if you expect to source levels around 50 mV, send 0.05 (or 50e-3) to select the 200 mV range.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference When source readback is on, the front-panel display shows the measured source value and the buffer records the measured source value immediately before the device-under-test measurement. When source readback is off, the front-panel display shows the configured source value and the buffer records the configured source value immediately before the device-under-test measurement.
Page 895
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details You can set the following parameters. The links in the list below link to the descriptions of the corresponding TSP command descriptions. The settings available for each parameter are the same as the settings for the TSP commands.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference smu.source.sweeplinear() This function sets up a linear sweep for a fixed number of measurement points. Type TSP-Link accessible Affected by Where saved Default value Function Usage smu.source.sweeplinear("configListName", start, stop, points) smu.source.sweeplinear("configListName", start, stop, points, sDelay) smu.source.sweeplinear("configListName", start, stop, points, sDelay, count) smu.source.sweeplinear("configListName", start, stop, points, sDelay, count,...
Page 897
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details When the sweep is started, the instrument sources a specific voltage or current value to the device under test (DUT). A measurement is made for each point of the sweep. When the sweep command is sent, it clears any existing trigger models, creates a source configuration list, and populates the trigger model.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference smu.source.sweeplinearstep() This function sets up a linear source sweep configuration list and trigger model with a fixed number of steps. Type TSP-Link accessible Affected by Where saved Default value Function Usage...
Page 899
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details When the sweep is started, the instrument sources a specific voltage or current voltage to the device under test (DUT). A measurement is made for each point of the sweep. When the sweep command is sent, it deletes the existing trigger model and creates a trigger model with a uniform series of ascending or descending voltage or current changes, called steps.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Also see Sweep operation (on page 5-37) smu.source.sweeplist() This function sets up a sweep based on a configuration list, which allows you to customize the sweep. Type TSP-Link accessible Affected by Where saved...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference smu.source.sweeplog() This function sets up a logarithmic sweep for a set number of measurement points. Type TSP-Link accessible Affected by Where saved Default value Function Usage smu.source.sweeplog("configListName", start, stop, points) smu.source.sweeplog("configListName", start, stop, points, sDelay) smu.source.sweeplog("configListName", start, stop, points, sDelay, count) smu.source.sweeplog("configListName", start, stop, points, sDelay, count,...
Page 903
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual dual Determines if the sweep runs from start to stop and then from stop to start: ▪ Sweep from start to stop only: smu.OFF (default) ▪ Sweep from start to stop, then stop to start: smu.ON bufferName The name of a reading buffer;...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Example reset() smu.source.func = smu.FUNC_DC_VOLTAGE smu.source.range = 20 smu.measure.func = smu.FUNC_DC_CURRENT smu.measure.range = 100e-6 smu.source.sweeplog("VoltLogSweep", 1, 10, 20, 1e-3, 1, smu.RANGE_FIXED) trigger.model.initiate() Reset the instrument to its defaults. Set the source function to voltage.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example smu.source.userdelay[1] = 5 trigger.model.setblock(1, trigger.BLOCK_SOURCE_OUTPUT, smu.ON) trigger.model.setblock(2, trigger.BLOCK_DELAY_DYNAMIC, trigger.USER_DELAY_S1) trigger.model.setblock(3, trigger.BLOCK_MEASURE_DIGITIZE) trigger.model.setblock(4, trigger.BLOCK_SOURCE_OUTPUT, smu.OFF) trigger.model.setblock(5, trigger.BLOCK_BRANCH_COUNTER, 10, 1) trigger.model.initiate() Set user delay for source 1 to 5 s. Set trigger block 1 to turn the source output on.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference If you change the measure range to a range that is not appropriate for this limit, the instrument changes the source limit to a limit that is appropriate to the range and a warning is generated.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example print(smu.source.vlimit.tripped) Check the state of the source limit for voltage. If the limit was exceeded, the output is: smu.ON Also see smu.source.xlimit.level (on page 14-214) smu.terminals This attribute describes which set of input and output terminals the instrument is using.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Details This command clears the event registers of the Questionable Event and Operation Event Register set. It does not affect the Questionable Event Enable or Operation Event Enable registers.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Decimal Constant When set, indicates the following has occurred: value status.MSB An enabled measurement event Not used status.EAV An error or status message is present in the Error Queue status.QSB An enabled questionable event status.MAV...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference status.operation.enable This attribute sets or reads the contents of the Operation Event Enable Register of the status model. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) status.preset() Not applicable...
Page 911
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example status.request_enable = status.OSB status.operation.setmap(0, 4918, 4917) status.operation.enable = 1 defbuffer1.clear() defbuffer1.fillmode = buffer.FILL_ONCE defbuffer1.capacity = 10 smu.measure.count = 10 smu.measure.read() print(status.operation.event) Set bits in the Status Request Enable Register to record an enabled event in the Operation Status Register. Map event number 4918 (a default buffer is full) to set bit 0 in the Operation Event Register and event number 4917 (a default buffer is empty) to clear bit 0.
Page 912
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Also see Operation Event Register (on page 18-7) Programmable status register sets (on page 18-4) status.operation.setmap() (on page 14-221) status.operation.setmap() This function allows you to map events to bits in the Operation Event Register. Type TSP-Link accessible Affected by...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual status.preset() This function resets all bits in the status model. Type TSP-Link accessible Affected by Where saved Default value Function Usage status.preset() Details This function clears the event registers and the enable registers for operation and questionable.
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference status.questionable.enable This attribute sets or reads the contents of the questionable event enable register of the status model. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) status.preset() Not applicable...
Page 915
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details This query reads the contents of the questionable status event register. After sending this command and addressing the instrument to talk, a value is sent to the computer. This value indicates which bits in the appropriate register are set.
Page 916
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference status.questionable.setmap() This function maps events to bits in the questionable event registers. Type TSP-Link accessible Affected by Where saved Default value Function Usage status.questionable.setmap(bitNumber, setEvent) status.questionable.setmap(bitNumber, setEvent, clearEvent) bitNumber The bit number that is mapped to an event: 0 to 14 setEvent...
Page 917
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual status.request_enable This attribute stores the settings of the Service Request (SRQ) Enable Register. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) status.preset() Not applicable Usage SRQEnableRegister = status.request_enable status.request_enable = SRQEnableRegister...
Page 918
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Example 2 -- decimal 129 = binary 10000001 requestSRQEnableRegister = 129 status.request_enable = requestSRQEnableRegister Uses a decimal value to set the MSB and OSB bits and clear all other bits of the service request (SRQ) enable register.
Page 919
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual The instrument returns a decimal value that corresponds to the binary-weighted sum of all bits set in the register. Decimal Constant When set, indicates the following has occurred: value status.standard.OPC All pending selected instrument operations are...
Page 920
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Details When this command returns zero (0), no bits are set. You can send 0 to clear all bits. The instrument returns a decimal value that corresponds to the binary-weighted sum of all bits set in the register.
Page 921
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual timer.gettime() This function measures the elapsed time since the timer was last cleared. Type TSP-Link accessible Affected by Where saved Default value Function Usage time = timer.gettime() time The elapsed time in seconds (1 µs resolution) Example...
Page 922
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: 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) Restore configuration Configuration script false (AND) Instrument reset Power cycle...
Page 923
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual trigger.blender[N].overrun This attribute indicates whether or not an event was ignored because of the event detector state. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) Instrument reset Not applicable Not applicable...
Page 924
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Details The trigger.blender[N].reset() function resets the following attributes to their factory defaults: • trigger.blender[N].orenable • trigger.blender[N].stimulus[M] It also clears trigger.blender[N].overrun. Example trigger.blender[1].reset() Resets the trigger blender 1 settings to factory defaults. Also see trigger.blender[N].orenable (on page 14-231)
Page 925
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual The event parameter may be any of the trigger events shown in the following table. Trigger events Event description Event constant trigger.EVENT_BLENDERN Trigger event blender N (1 to 2), which combines trigger events trigger.EVENT_COMMAND A command interface trigger:...
Page 926
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference trigger.blender[N].wait() This function waits for a blender trigger event to occur. Type TSP-Link accessible Affected by Where saved Default value Function Usage triggered = trigger.blender[N].wait(timeout) triggered Trigger detection indication for blender The trigger blender (up to two) on which to wait timeout Maximum amount of time in seconds to wait for the trigger blender event...
Page 927
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual trigger.clear() This function clears any pending command triggers. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.clear() Details A command trigger indicates if a trigger event has been detected over a command interface since the last trigger.wait() command was sent.
Page 928
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference trigger.continuous This attribute determines the trigger mode setting after bootup. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Never Nonvolatile memory trigger.CONT_AUTO Usage setting = trigger.continuous trigger.continuous = setting setting Do not start continuous measurements after boot: trigger.CONT_OFF...
Page 929
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual trigger.digin[N].clear() This function clears the trigger event on a digital input line. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.digin[N].clear() Digital I/O trigger line: 1 to 6 Details The event detector of a trigger enters the detected state when an event is detected.
Page 930
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Details This command sets the logic on which the trigger event detector and the output trigger generator operate on the specified trigger line. To directly control the line state, set the mode of the line to digital and use the write command.
Page 931
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example overrun = trigger.digin[1].overrun If there is no trigger overrun on digital print(overrun) input 1, the output is: false Also see digio.line[N].mode (on page 14-63) digio.line[N].reset() (on page 14-64) Digital I/O port configuration (on page 9-14) trigger.digin[N].clear()
Page 932
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference trigger.digout[N].assert() This function asserts a trigger pulse on one of the digital I/O lines. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.digout[N].assert() Digital I/O trigger line: 1 to 6 Details Initiates a trigger event and does not wait for completion.
Page 933
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example digio.line[4].mode = digio.MODE_TRIGGER_OUT trigger.digout[4].logic = trigger.LOGIC_NEGATIVE Sets line 4 mode to be a trigger output and sets the output logic of the trigger event generator to negative (asserts a low pulse).
Page 934
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference trigger.digout[N].release() This function releases an indefinite length or latched trigger. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.digout[N].release() Digital I/O trigger line: 1 to 6 Details Releases a trigger that was asserted with an indefinite pulsewidth time.
Page 935
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Trigger events Event description Event constant trigger.EVENT_BLENDERN Trigger event blender N (1 to 2), which combines trigger events trigger.EVENT_COMMAND A command interface trigger: ▪ Any remote interface: *TRG ▪...
Page 936
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: 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 937
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual trigger.lanin[N].overrun This attribute contains the overrun status of the LAN event detector. Type TSP-Link accessible Affected by Where saved Default value Attribute (R) LAN trigger N clear Not applicable Not applicable Usage...
Page 938
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Details If one or more trigger events have been detected since the last time trigger.lanin[N].wait() or trigger.lanin[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 939
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Also see lan.lxidomain (on page 14-106) trigger.lanin[N].clear() (on page 14-244) trigger.lanin[N].overrun (on page 14-246) trigger.lanin[N].wait() (on page 14-246) trigger.lanout[N].assert() (on page 14-247) trigger.lanout[N].ipaddress (on page 14-250) trigger.lanout[N].protocol (on page 14-251) trigger.lanout[N].stimulus (on page 14-252)
Page 940
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference trigger.lanout[N].connected This attribute contains 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 = trigger.lanout[N].connected connected The LAN event connection state:...
Page 941
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details When this command is set for TCP connections, this closes the TCP connection. The LAN trigger automatically disconnects when either the trigger.lanout[N].protocol or trigger.lanout[N].ipaddress attributes for this event are changed.
Page 942
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference trigger.lanout[N].logic This attribute sets the logic on which the trigger event detector and the output trigger generator operate on the given trigger line. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW)
Page 943
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details The LAN trigger listens for trigger messages on all the supported protocols. However, it uses the designated protocol for sending outgoing messages. After you change this setting, you must re-connect the LAN trigger event generator before you can send outgoing event messages.
Page 944
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference If any events are detected before the trigger LAN connection is sent, the event is ignored, and the action overrun is set. Trigger events Event description Event constant trigger.EVENT_BLENDERN Trigger event blender N (1 to 2), which combines trigger events...
Page 945
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example trigger.model.abort() Terminates all commands related to the trigger model on the instrument. Also see Aborting the trigger model (on page 9-54) Effect of GPIB line events on 2470 (on page 3-6) Trigger model (on page 9-27)
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Details This command returns the counter value. When the counter is active, this returns the present count. If the trigger model has started or is running but has not yet reached the counter block, this value is 0.
Page 947
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Usage trigger.model.load("ConfigList", "measureConfigList", "sourceConfigList") trigger.model.load("ConfigList", "measureConfigList", "sourceConfigList", delay) trigger.model.load("ConfigList", "measureConfigList", "sourceConfigList", delay, bufferName) measureConfigList A string that contains the name of the measurement configuration list to use sourceConfigList A string that contains the name of the source configuration list to delay...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference trigger.model.load() — DurationLoop This function loads a trigger-model template configuration that makes continuous measurements for a specified amount of time. Type TSP-Link accessible Affected by Where saved Default value Function Restore configuration...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual trigger.model.load() — Empty This function clears the trigger model. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.model.load("Empty") Details When you load this trigger-model template, any blocks that have been defined in the trigger model are cleared so the trigger model has no blocks defined.
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual trigger.model.load() — LogicTrigger This function loads a trigger-model template configuration that sets up a logic trigger through the digital I/O. Type TSP-Link accessible Affected by Where saved Default value Function Restore configuration...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference trigger.model.load() — LoopUntilEvent This function loads a trigger-model template configuration that makes continuous measurements until the specified event occurs. Type TSP-Link accessible Affected by Where saved Default value Function Restore configuration Configuration script...
Page 953
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual The following table lists the options that are available for triggerEvent. Trigger events Event description Event constant trigger.EVENT_DISPLAY Front-panel TRIGGER key press trigger.EVENT_NOTIFYN Notify trigger block N (1 to 8) generates a trigger event when the trigger model executes it trigger.EVENT_COMMAND A command interface trigger:...
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference trigger.model.load() — SimpleLoop This function loads a trigger-model template configuration that makes a specific number of measurements. Type TSP-Link accessible Affected by Where saved Default value Function Restore configuration Configuration script Not applicable...
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual -- Parse index and data into three columns print("Rdg #", "Time (s)", "Current (A)") for i = 1, defbuffer1.n do print(i, defbuffer1.relativetimestamps[i], defbuffer1[i]) -- Discharge the capacitor to 0 V and turn off the output smu.source.level = 0 delay(2) smu.source.output = smu.OFF...
Page 957
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual trigger.model.pause() This function pauses a running trigger model. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.model.pause() Details This command pauses the trigger model. To continue the trigger model, send the resume command.
Page 958
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference trigger.model.resume() This function continues a paused trigger model. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.model.resume() Details This command continues running the trigger model operation if the trigger model was paused.
Page 959
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual trigger.model.setblock() — trigger.BLOCK_BRANCH_ALWAYS This function defines a trigger model block that always goes to a specific block. Type TSP-Link accessible Affected by Where saved Default value Function Restore configuration Configuration script Not applicable...
Page 960
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Counters increment every time the trigger model reaches them until they are more than or equal to the count value. At that point, the trigger model continues to the next building block in the sequence.
Page 961
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details This block calculates the difference between the last two measurements from a measure/digitize block. It subtracts the most recent measurement from the previous measurement. The difference between the measurements is compared to the target difference. If the difference is less than the target difference, the trigger model goes to the specified branching block.
Page 962
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference limitA The lower limit that the measurement is tested against; if limitType is set to: ▪ trigger.LIMIT_ABOVE: This value is ignored ▪ trigger.LIMIT_BELOW: The measurement must be below this value ▪...
Page 963
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Also see Constant Limit block (on page 9-41) trigger.model.setblock() — trigger.BLOCK_BRANCH_LIMIT_DYNAMIC This function defines a trigger model block that goes to a specified block in the trigger model if a measurement meets user-defined criteria.
Page 964
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference There are two user-defined limits: limit 1 and limit 2. Both include their own high and low values, which are set using the front-panel Calculations limit settings or through commands. The results of these limit tests are recorded in the reading buffer that accompanies each stored reading.
Page 965
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details The branch-on-event block goes to a branching block after a specified trigger event occurs. If the trigger event has not yet occurred when the trigger model reaches the branch-on-event block, the trigger model continues to execute the blocks in the normal sequence.
Page 966
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference trigger.model.setblock() — trigger.BLOCK_BRANCH_ONCE This function causes the trigger model to branch to a specified building block the first time it is encountered in the trigger model. Type TSP-Link accessible Affected by Where saved...
Page 967
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual trigger.model.setblock() — trigger.BLOCK_BRANCH_ONCE_EXCLUDED This function defines a trigger model block that causes the trigger model to go to a specified building block every time the trigger model encounters it, except for the first time. Type TSP-Link accessible Affected by...
Page 968
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Details When trigger model execution reaches the buffer clear trigger block, the instrument empties the specified reading buffer. The specified buffer can be the default buffer or a buffer that you defined.
Page 969
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual The first time the trigger model encounters this block for a specific configuration list, the first index is recalled if the list has not already had an index recalled by the recall block command in an earlier trigger model block.
Page 970
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference trigger.model.setblock() — trigger.BLOCK_CONFIG_PREV This function defines a trigger model block that recalls the settings stored at the previous index in a source or measure configuration list, or both a source and measure configuration list. Type TSP-Link accessible Affected by...
Page 971
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual The first time the trigger model encounters this block, the last index in the configuration list is recalled if the list has not already had an index recalled by the recall block command in an earlier trigger model block.
Page 972
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference trigger.model.setblock() — trigger.BLOCK_CONFIG_RECALL This function recalls the system settings that are stored in a source or measure configuration list, or both a source and measure configuration list. Type TSP-Link accessible Affected by...
Page 973
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example 1 trigger.model.setblock(3, trigger.BLOCK_CONFIG_RECALL, "measTrigList", 5) Configure trigger block 3 to load index 5 from the configuration list named measTrigList. Example 2 trigger.model.setblock(3, trigger.BLOCK_CONFIG_RECALL, "measTrigList", 5, "sourTrigList") print(trigger.model.getblocklist()) Configure trigger block 3 to load index 5 from the configuration list named measTrigList and load index 1 from the configuration list name sourTrigList.
Page 974
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference trigger.model.setblock() — trigger.BLOCK_DELAY_DYNAMIC This function adds a user delay to the execution of the trigger model. Type TSP-Link accessible Affected by Where saved Default value Function Restore configuration Configuration script Not applicable Instrument reset...
Page 975
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Also see smu.measure.userdelay[N] (on page 14-182) smu.source.userdelay[N] (on page 14-213) trigger.model.setblock() — trigger.BLOCK_DIGITAL_IO This function defines a trigger model block that sets the lines on the digital I/O port high or low. Type TSP-Link accessible Affected by...
Page 976
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference trigger.model.setblock() — trigger.BLOCK_LOG_EVENT This function allows you to log an event in the event log when the trigger model is running. Type TSP-Link accessible Affected by Where saved Default value Function Restore configuration...
Page 977
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual trigger.model.setblock() — trigger.BLOCK_MEASURE_DIGITIZE This function defines a trigger block that makes or digitizes a measurement. Type TSP-Link accessible Affected by Where saved Default value Function Restore configuration Configuration script Not applicable Instrument reset...
Page 978
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Digitized measurements are not a feature on the 2470. However, you can use this command to communicate with other Keithley instruments that do offer the digitized measurements feature and to share code with other Keithley instruments.
Page 980
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference trigger.model.setblock() — trigger.BLOCK_NOP This function creates a placeholder that performs no action in the trigger model; available only using remote commands. Type TSP-Link accessible Affected by Where saved Default value Function Restore configuration...
Page 981
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Example digio.line[3].mode = digio.MODE_TRIGGER_OUT trigger.model.setblock(5, trigger.BLOCK_NOTIFY, trigger.EVENT_NOTIFY2) trigger.digout[3].stimulus = trigger.EVENT_NOTIFY2 Define trigger model block 5 to be the notify 2 event. Assign the notify 2 event to be the stimulus for digital output line 3.
Page 982
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Also see trigger.model.getbranchcount() (on page 14-254) trigger.model.setblock() — trigger.BLOCK_BRANCH_COUNTER (on page 14-268) trigger.model.setblock() — trigger.BLOCK_SOURCE_OUTPUT This function defines a trigger block that turns the output source on or off. Type TSP-Link accessible Affected by...
Page 983
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual trigger.model.setblock() — trigger.BLOCK_WAIT This function defines a trigger model block that waits for an event before allowing the trigger model to continue. Type TSP-Link accessible Affected by Where saved Default value Function...
Page 984
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference The event can occur before trigger model execution reaches the wait block. If the event occurs after trigger model execution starts but before the trigger model execution reaches the wait block, the trigger model records the event.
Page 985
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Also see Wait block (on page 9-31) trigger.model.state() This function returns the present state of the trigger model. Type TSP-Link accessible Affected by Where saved Default value Function Usage status, status, n = trigger.model.state()
Page 986
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Also see None 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...
Page 987
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Set the count to zero (0) to cause the timer to generate trigger events indefinitely. If you use the trigger timer with a trigger model, make sure the count value is the same or more than any count values expected in the trigger model.
Page 988
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Also see trigger.timer[N].clear() (on page 14-295) trigger.timer[N].delay (on page 14-297) trigger.timer[N].reset() (on page 14-300) 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 989
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual trigger.timer[N].delaylist This attribute sets an array of timer intervals. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script 10e-6 (10 µs) Instrument reset Power cycle Trigger timer N reset...
Page 990
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference trigger.timer[N].enable This attribute enables the trigger timer. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration Configuration script trigger.OFF Instrument reset Power cycle Trigger timer N reset Usage state = trigger.timer[N].enable...
Page 991
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual trigger.timer[N].reset() This function resets trigger timer settings to their default values. Type TSP-Link accessible Affected by Where saved Default value Function Usage trigger.timer[N].reset() Trigger timer number: 1 to 4 Details The trigger.timer[N].reset() function resets the following attributes to their default values:...
Page 992
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference trigger.timer[N].start.fractionalseconds This attribute configures the fractional seconds of an alarm or a time in the future when the timer will start. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration...
Page 993
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details When this is set to on, a trigger event is generated immediately when the timer is triggered. When it is set to off, a trigger event is generated when the timer elapses. This generates the event trigger.EVENT_TIMERN.
Page 994
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference trigger.timer[N].start.seconds This attribute configures the seconds of an alarm or a time in the future when the timer will start. Type TSP-Link accessible Affected by Where saved Default value Attribute (RW) Restore configuration...
Page 995
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details Set the stimulus to any trigger event to start the timer when that event occurs. Set the stimulus to none to disable event processing and use the timer as a timer or alarm based on the start time.
Page 996
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference trigger.timer[N].wait() This function waits for a trigger. Type TSP-Link accessible Affected by Where saved Default value Function Usage triggered = trigger.timer[N].wait(timeout) triggered Trigger detection indication Trigger timer number: 1 to 4 timeout Maximum amount of time in seconds to wait for the trigger Details...
Page 997
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual Details The trigger event detector enters the detected state when an event is detected. When this command is sent, the instrument: • Clears the trigger event detector •...
Page 998
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Also see digio.writeport() (on page 14-67) tsplink.line[N].mode (on page 14-315) tsplink.line[N].reset() (on page 14-315) trigger.tsplinkin[N].overrun This attribute indicates if the event detector ignored an event while in the detected state. Type TSP-Link accessible Affected by...
Page 999
Section 14: TSP command reference Model 2470 High Voltage SourceMeter Instrument Reference Manual trigger.tsplinkin[N].wait() This function waits for a trigger. Type TSP-Link accessible Affected by Where saved Default value Function Usage triggered = trigger.tsplinkin[N].wait(timeout) triggered Trigger detection indication; set to one of the following values: ▪...
Page 1000
Model 2470 High Voltage SourceMeter Instrument Reference Manual Section 14: TSP command reference Details Initiates a trigger event and does not wait for completion. The set pulse width determines how long the trigger is asserted. Example tsplink.line[2].mode = tsplink.MODE_TRIGGER_OPEN_DRAIN trigger.tsplinkout[2].assert() Asserts trigger on trigger line 2.
Need help?
Do you have a question about the Keithley 2470 and is the answer not in the manual?
Questions and answers