1. DL manuals
  2. Keithley
  3. Measuring Instruments
  4. 2657A
  5. Reference Manual

Keithley 2657A Reference Manual - Display.Inputvalue()

Manual is about: High Power System SourceMeter Instrument

Summary of 2657A

  • Page 1

    Www.Keithley.Com e c n e d i f n o c f o e r u s a e m r e t a e r g a model 2657a high power system sourcemeter ® instrument reference manual 2657a-901-01 rev. B / december 2012 2657a-901-01 *p2657a90101*.

  • Page 2

    High power system sourcemeter ® instrument reference manual © 2008-2012, keithley instruments, inc. Cleveland, ohio, u.S.A. All rights reserved. Any unauthorized reproduction, photocopy, or use of the information herein, in whole or in part, without the prior written approval of keithley instruments...

  • Page 4: Safety

    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 produ...

  • Page 5

    Do not exceed the maximum signal levels of the instruments and accessories, as defined in the specifications and operating information, and as shown on the instrument or test fixture panels, or switching card. When fuses are used in a product, replace with the same type and rating for continued prot...

  • Page 6: Table of Contents

    Introduction ................................................................................................................. 1-1 welcome .............................................................................................................................. 1-1 extended warranty ...............

  • Page 7

    Table of contents model 2657a high power system sourcemeter® instrument reference manual ii 2657a-901-01 rev. B/december 2012 multiple smu connections ....................................................................................................... 2-51 guarding and shielding ....................

  • Page 8

    Model 2657a high power system sourcemeter® instrument reference manual table of contents 2657a-901-01 rev. B/december 2012 iii sweep programming examples ............................................................................................... 3-30 triggering .....................................

  • Page 9

    Table of contents model 2657a high power system sourcemeter® instrument reference manual iv 2657a-901-01 rev. B/december 2012 information on scripting and programming ................................................................................ 5-3 about tsp commands ................................

  • Page 10

    Model 2657a high power system sourcemeter® instrument reference manual table of contents 2657a-901-01 rev. B/december 2012 v using test script builder (tsb) .............................................................................................. 6-30 project navigator ............................

  • Page 11

    Table of contents model 2657a high power system sourcemeter® instrument reference manual vi 2657a-901-01 rev. B/december 2012 bit.Get() .................................................................................................................................... 7-11 bit.Getfield() ..............

  • Page 12

    Model 2657a high power system sourcemeter® instrument reference manual table of contents 2657a-901-01 rev. B/december 2012 vii display.Loadmenu.Catalog() ..................................................................................................... 7-68 display.Loadmenu.Delete() ................

  • Page 13

    Table of contents model 2657a high power system sourcemeter® instrument reference manual viii 2657a-901-01 rev. B/december 2012 lan.Config.Dns.Domain ........................................................................................................... 7-110 lan.Config.Dns.Dynamic ................

  • Page 14

    Model 2657a high power system sourcemeter® instrument reference manual table of contents 2657a-901-01 rev. B/december 2012 ix os.Time() ................................................................................................................................ 7-147 print() ........................

  • Page 15

    Table of contents model 2657a high power system sourcemeter® instrument reference manual x 2657a-901-01 rev. B/december 2012 smux.Measure.Count ............................................................................................................ 7-197 smux.Measure.Delay .........................

  • Page 16

    Model 2657a high power system sourcemeter® instrument reference manual table of contents 2657a-901-01 rev. B/december 2012 xi smux.Trigger.Source_complete_event_id ................................................................ 7-246 smux.Trigger.Sweep_complete_event_id ...............................

  • Page 17

    Table of contents model 2657a high power system sourcemeter® instrument reference manual xii 2657a-901-01 rev. B/december 2012 trigger.Blender[n].Overrun ..................................................................................................... 7-332 trigger.Blender[n].Reset() ..............

  • Page 18

    Model 2657a high power system sourcemeter® instrument reference manual table of contents 2657a-901-01 rev. B/december 2012 xiii troubleshooting guide ............................................................................................... 8-1 introduction ........................................

  • Page 19

    Table of contents model 2657a high power system sourcemeter® instrument reference manual xiv 2657a-901-01 rev. B/december 2012 maintenance ................................................................................................................A-1 line fuse replacement ..........................

  • Page 20

    Model 2657a high power system sourcemeter® instrument reference manual table of contents 2657a-901-01 rev. B/december 2012 xv telnet connection .................................................................................................................... C-16 dead socket connection ..............

  • Page 21: Welcome

    In this section: welcome .................................................................................. 1-1 extended warranty ................................................................... 1-1 contact information .................................................................. 1-1 cd-rom ...

  • Page 22: Cd-Rom Contents

    Section 1: introduction model 2657a high power system sourcemeter® instrument reference manual 1-2 2657a-901-01 rev. B/december 2012 cd-rom contents two cd-roms are shipped with each series 2650a instrument: • the series 2650a product information cd-rom (keithley instruments part number 2650as-950-0...

  • Page 23

    Model 2657a high power system sourcemeter® instrument reference manual section 1: introduction 2657a-901-01 rev. B/december 2012 1-3 organization of manual sections the information in this manual is organized into the following major categories: • general operation: describes the components of the i...

  • Page 24: Capabilities and Features

    Section 1: introduction model 2657a high power system sourcemeter® instrument reference manual 1-4 2657a-901-01 rev. B/december 2012 capabilities and features the model 2657a high power system sourcemeter ® instrument has the following features: • resistance and power measurement functions • four-qu...

  • Page 25: General Ratings

    In this section: general ratings ......................................................................... 2-1 controls, indicators, and connectors ........................................ 2-2 cooling vents ........................................................................... 2-7 turning your ...

  • Page 26

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-2 2657a-901-01 rev. B/december 2012 controls, indicators, and connectors model 2657a controls, indicators, and the usb port are on the front panel (on page 2-2). Make connections to the model 2657a ...

  • Page 27

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-3 2. Smu setup, performance control, special operation, and numbers smu (source-measure unit) setup src selects the source function (v or a) and places the cursor i...

  • Page 28

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-4 2657a-901-01 rev. B/december 2012 numbers number keys when enabled and in edit mode, the number keys (0-9, +/-, 0000) allow direct numeric entry. Press the navigation wheel to enter edit mode. For...

  • Page 29

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-5 7. Usb port use the usb port to connect a usb flash drive to the instrument. The usb flash drive can be used to store reading buffer data, scripts, and user setup...

  • Page 30

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-6 2657a-901-01 rev. B/december 2012 3. Power module contains the ac line receptacle and power line fuse. The instrument can operate on line voltages of 100 v to 240 v ac at line frequencies of 50 hz...

  • Page 31: Cooling Vents

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-7 cooling vents the model 2657a has top and side intake vents and a rear exhaust vent. The rear exhaust vent and either the top or both side intake vents must be un...

  • Page 32

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-8 2657a-901-01 rev. B/december 2012 operating the instrument on an incorrect line voltage may cause damage to the instrument, possibly voiding the warranty. To turn a model 2657a on and off: 1. Befo...

  • Page 33: System Information

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-9 line frequency configuration at the factory, each model 2657a is configured to match the power line frequency appropriate for your country (either 50 hz or 60 hz)...

  • Page 34: Menu Overview

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-10 2657a-901-01 rev. B/december 2012 menu overview menu navigation to navigate through the menus and submenus, the model 2657a must not be in edit mode (the edit indicator is not illuminated). Selec...

  • Page 35

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-11 main menu the main menu structure is summarized in the following figure and table. For other menu items, see configuration menus (on page 2-13). Figure 3: main m...

  • Page 36

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-12 2657a-901-01 rev. B/december 2012 the following table contains descriptions of the main menu options and cross-references to related information. To access a menu option, press the menu key, turn...

  • Page 37

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-13 configuration menus the configuration menu structure is summarized in the following figure and table. For directions on navigating the menu, see menu navigation ...

  • Page 38

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-14 2657a-901-01 rev. B/december 2012 press the exit key to return to a previous menu. The following table contains descriptions of the configuration menus, as well as cross-references to related inf...

  • Page 39

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-15 to set a value to zero, press the 0000 numeric entry key. To toggle the polarity of a value, press the +/– numeric entry key. 1. If the keypad is disabled, press...

  • Page 40: Beeper

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-16 2657a-901-01 rev. B/december 2012 the up and down range keys change the format of the limit value. Beeper the model 2657a includes a beeper. When it is enabled, a beep indicates one of the follow...

  • Page 41: Basic Operation

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-17 basic operation hazardous voltages may be present on all output and guard terminals. To prevent electrical shock that could cause injury or death, never make or ...

  • Page 42

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-18 2657a-901-01 rev. B/december 2012 voltage and current the following table lists the source and measure limits for the voltage and current functions. The full range of operation is explained in op...

  • Page 43

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-19 maximum limits for model 2657a range maximum limit range maximum limit 200 v 120 ma 1 na 3000 v 500 v 120 ma 10 na 1500 v 120 ma 100 na 3000 v 20 ma 1 µa 10 µa 1...

  • Page 44

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-20 2657a-901-01 rev. B/december 2012 remote limit the table below summarizes basic commands to program a limit. For a more complete description of these commands, refer to the tsp command reference ...

  • Page 45

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-21 when using the i-source as a sink, always set the voltage compliance limit and configure overvoltage protection (ovp) (on page 2-65) to levels that are higher th...

  • Page 46

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-22 2657a-901-01 rev. B/december 2012 figure 6: fundamental source-measure configurations operation considerations for the adc the following paragraphs discuss autozero and nplc caching. Autozero and...

  • Page 47

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-23 this extra time can cause problems in sweeps and other test sequences in which measurement timing is critical. To avoid the extra time for the reference measurem...

  • Page 48

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-24 2657a-901-01 rev. B/december 2012 nplc caching nplc caching speeds up operation by caching a/d reference and zero values for up to the ten most recent measurement aperture settings. Whenever the ...

  • Page 49

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-25 step 3: select the measurement function and range select measurement function and range as follows: 1. Select the measurement function by pressing the meas key. ...

  • Page 50

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-26 2657a-901-01 rev. B/december 2012 basic source-measure commands command description smua.Source.Autorangei = smua.Autorange_on enable current source autorange. Smua.Source.Autorangev = smua.Autor...

  • Page 51

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-27 -- restore model 2657a defaults. Smua.Reset() -- select voltage source function. Smua.Source.Func = smua.Output_dcvolts -- set source range to auto. Smua.Source....

  • Page 52

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-28 2657a-901-01 rev. B/december 2012 triggering in local mode it is not necessary to change any trigger settings to use the basic source and measurement procedures covered in this section. Press the...

  • Page 53

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-29 count: sets the trigger count (number of measurements) as follows: • finite : the instrument goes through measurement cycles for the programmed trigger count (1 ...

  • Page 54

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-30 2657a-901-01 rev. B/december 2012 to manually configure the settings, refer to the applicable topics: • v-meter and i-meter measurements (on page 2-30) • ohms measurements (on page 2-30) • power ...

  • Page 55

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-31 ohms ranging the front panel ohms function does not use ranging. The instrument formats a calculated resistance reading (v/i) to best fit the display. There may ...

  • Page 56

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-32 2657a-901-01 rev. B/december 2012 -- restore model 2657a defaults. Smua.Reset() -- select current source function. Smua.Source.Func = smua.Output_dcamps -- set source range to 20 ma. Smua.Source....

  • Page 57

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-33 figure 8: two-wire resistance sensing i hi v m v r test current (i) resistance under test lead resistances r s i = current sourced v m = voltage measured v r = v...

  • Page 58

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-34 2657a-901-01 rev. B/december 2012 the 4-wire sensing method, as shown in the following figure (four-wire resistance sensing), minimizes or eliminates the effects of lead resistance by measuring t...

  • Page 59

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-35 hazardous voltages may be present on the output and guard terminals. To prevent electrical shock that could cause injury or death, never make or break connection...

  • Page 60

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-36 2657a-901-01 rev. B/december 2012 -- restore model 2657a defaults. Smua.Reset() -- select voltage source function. Smua.Source.Func = smua.Output_dcvolts -- enable source autoranging. Smua.Source...

  • Page 61

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-37 contact check measurements overview the contact check function prevents measurements that may be in error due to excessive resistance in the force or sense leads...

  • Page 62

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-38 2657a-901-01 rev. B/december 2012 contact check commands the following table summarizes the basic contact check commands. For a more complete description of these commands, refer to the tsp comma...

  • Page 63

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-39 saving user setups you can save the present model 2657a setup to internal nonvolatile memory or a usb flash drive. To save a user setup to nonvolatile memory fro...

  • Page 64

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-40 2657a-901-01 rev. B/december 2012 start-up configuration you can specify the model 2657a start-up (power-on) configuration from the front panel. Set the start-up configuration to a previously sto...

  • Page 65: Dut Test Connections

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-41 start-up (power-on) configuration you can specify the model 2657a start-up (power-on) configuration. Use the setup.Poweron attribute to select which setup to ret...

  • Page 66

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-42 2657a-901-01 rev. B/december 2012 basic connections: remember the following when making or breaking connections: • power off the model 2657a and all other instruments. • disconnect any devices th...

  • Page 67

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-43 the maximum common-mode voltage (voltage between lo and chassis ground) is 250 v dc. Exceeding this value may cause a breakdown in insulation, creating a shock h...

  • Page 68

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-44 2657a-901-01 rev. B/december 2012 lo, chassis ground, and protective earth (safety ground) connections to lo on the model 2657a are not necessarily at 0 v. Hazardous voltages could exist between ...

  • Page 69

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-45 item description notes (1) outer jacket (2) outer shield (3) inner shield spacing between the inner shield and any user accessible circuit: 33.5 mm; spacing betw...

  • Page 70

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-46 2657a-901-01 rev. B/december 2012 guard voltage can be hazardous. With an unguarded device under test (dut) connection, terminate the guard before the end of the cable. Refer to high-voltage tria...

  • Page 71

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-47 item description qty notes (1) protective earth (safety ground) for model 2657a 1 keithley instruments model ca-568-120 is a protective earth (safety ground) cab...

  • Page 72

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-48 2657a-901-01 rev. B/december 2012 guard voltage can be hazardous. With an unguarded device under test (dut) connection, terminate the guard before the end of the cable. Refer to high-voltage tria...

  • Page 73

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-49 item description qty notes (1) protective earth (safety ground) for model 2657a 1 keithley instruments model ca-568-120 is a protective earth (safety ground) cab...

  • Page 74

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-50 2657a-901-01 rev. B/december 2012 refer to the following figure if using a test fixture with shv connections. Figure 15: four-wire resistance connections (remote sensing with shv cables) line r a...

  • Page 75

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-51 item description qty notes (1) protective earth (safety ground) for model 2657a 1 keithley instruments model ca-568-120 is a protective earth (safety ground) cab...

  • Page 76

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-52 2657a-901-01 rev. B/december 2012 carefully consider and configure the appropriate output-off state, source, and compliance limits before connecting the model 2657a to a device that can deliver e...

  • Page 77

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-53 guard voltage can be hazardous. With an unguarded device under test (dut) connection, terminate the guard before the end of the cable. Refer to high-voltage tria...

  • Page 78

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-54 2657a-901-01 rev. B/december 2012 item description qty notes (1) protective earth (safety ground) for model 2657a 1 keithley instruments model ca-568-120 is a protective earth (safety ground) cab...

  • Page 79

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-55 figure 17: three-terminal device connections using two smus: connections guarding and shielding you can optimize source-measure performance and safety with the e...

  • Page 80

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-56 2657a-901-01 rev. B/december 2012 the safety shield can be metallic or nonconductive, and must completely surround the dut test circuit. A metal safety shield must be connected to a known protect...

  • Page 81

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-57 figure 18: high-impedance guarding line r ating 100-240 vac 50, 60 hz 350 va max. Line fuse slowblow 5.0 a, 250 v no interna l oper at or se rviceable p ar ts, s...

  • Page 82

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-58 2657a-901-01 rev. B/december 2012 item description qty notes (1) protective earth (safety ground) for model 2657a 1 keithley instruments model ca-568-120 is a protective earth (safety ground) cab...

  • Page 83

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-59 figure 19: noise shield line r ating 100-240 vac 50, 60 hz 350 va max. Line fuse slowblow 5.0 a, 250 v no interna l oper at or se rviceable p ar ts, se rvice b y...

  • Page 84

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-60 2657a-901-01 rev. B/december 2012 item description qty notes (1) protective earth (safety ground) for model 2657a 1 keithley instruments model ca-568-120 is a protective earth (safety ground) cab...

  • Page 85

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-61 figure 20: connections for noise shield, safety shield, and guarding metal noise shield line r ating 100-240 vac 50, 60 hz 350 va max. Line fuse slowblow 5.0 a, ...

  • Page 86

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-62 2657a-901-01 rev. B/december 2012 item description qty notes (1) protective earth (safety ground) for model 2657a 1 keithley instruments model ca-568-120 is a protective earth (safety ground) cab...

  • Page 87

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-63 when hazardous voltages (>30 v rms, 42 v peak) will be present, the test fixture must meet the following safety requirements: construction material : a metal tes...

  • Page 88: Dut Connection Settings

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-64 2657a-901-01 rev. B/december 2012 the model 2657a connections for the floating configuration are shown below. Figure 22: floating the model 2657a smu connections the maximum floating (common mode...

  • Page 89

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-65 front panel sense mode selection to check or change the sense mode from the front panel: 1. Press the config key. 2. Press the src or meas key. You can access an...

  • Page 90

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-66 2657a-901-01 rev. B/december 2012 front panel overvoltage protection to configure overvoltage protection: 1. Press the config key, and then press the src key. Choose v-source > protection . 2. Se...

  • Page 91

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-67 output-off modes turning a source-measure unit (smu) off may not completely isolate the smu from the external circuit. The output-off mode can be used to place t...

  • Page 92

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-68 2657a-901-01 rev. B/december 2012 to configure the output-off mode from the front panel: 1. Press the config key. 2. Press the output on/off control. The configure output a menu is displayed. 3. ...

  • Page 93

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-69 to configure the output-off function from the front panel: 1. Press the config key. 2. Press the output on/off control. The configure output a menu is displayed....

  • Page 94: Usb Storage Overview

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-70 2657a-901-01 rev. B/december 2012 remote programming output-off states quick reference the content of the following table is a quick reference of commands for programming output-off states from a...

  • Page 95

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-71 figure 23: usb port file system navigation the model 2657a can use commands from the lua fs library to navigate and list files that are available on a flash driv...

  • Page 96: Range

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-72 2657a-901-01 rev. B/december 2012 displayed error and status messages during operation and programming, front-panel messages may be briefly displayed. Typical messages are either status or error ...

  • Page 97

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-73 measure auto delay the measure delay is a specific delay that is applied before each measurement is taken. This delay is set to the auto delay setting by default...

  • Page 98

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-74 2657a-901-01 rev. B/december 2012 when you change a source value, source autoranging is automatically turned off and remains off until you re-enable it. Low range limits the low range limit sets ...

  • Page 99

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-75 range considerations the source range and measure range settings can interact depending on the source function. Additionally, the output state (on/off) can affec...

  • Page 100

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-76 2657a-901-01 rev. B/december 2012 range programming range commands the following tables summarize commands necessary to control measure and source ranges. See the tsp command reference (on page 7...

  • Page 101: Digits

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-77 range programming example the programming example below illustrates how to control both source and measure ranges. The model 2657a is set up as follows: • voltag...

  • Page 102: Speed

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-78 2657a-901-01 rev. B/december 2012 speed the model 2657a has two analog-to-digital converters (adc): one integrating, one high speed. Fastest reading rates are achieved by selecting the fast adc. ...

  • Page 103

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-79 remote speed programming speed command the following table summarizes commands to control speed. See tsp command reference (on page 7-1) for more information. Sp...

  • Page 104

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-80 2657a-901-01 rev. B/december 2012 supported remote interfaces the model 2657a supports the following remote interfaces: • gpib. General purpose interface bus is an ieee-488 instrumentation data b...

  • Page 105

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-81 lan communications the model 2657a is an lxi version 1.4 core 2011 compliant instrument that supports tcp/ip and complies with ieee std 802.3 (ethernet). There i...

  • Page 106

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-82 2657a-901-01 rev. B/december 2012 when the led is: the network: off is not connected on is connected blinking is sending or receiving data using the lan with remote operations the following table...

  • Page 107

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-83 gpib operation this topic contains information about gpib standards, bus connections, and primary address selection. Gpib standards the gpib is the ieee-488 inst...

  • Page 108

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-84 2657a-901-01 rev. B/december 2012 to connect the instrument to the ieee-488 bus, line up the cable connector with the connector on the rear panel. Install and tighten the screws securely, making ...

  • Page 109

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-85 to set the primary address remotely: gpib.Address = address to set the primary address remotely to 20: gpib.Address = 20 note that changing the gpib address take...

  • Page 110

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-86 2657a-901-01 rev. B/december 2012 ifc the interface clear (ifc) command is sent by the controller to place the model 2657a in the talker idle state and the listener idle state. The instrument res...

  • Page 111

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-87 get the group execute trigger (get) command is a gpib trigger that triggers the instrument to take readings from a remote interface. Spe, spd use the serial poll...

  • Page 112

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-88 2657a-901-01 rev. B/december 2012 local key the exit (local) key cancels the remote state and restores local operation of the instrument. Pressing the exit (local) key also turns off the rem indi...

  • Page 113

    Model 2657a high power system sourcemeter® instrument reference manual section 2: general operation 2657a-901-01 rev. B/december 2012 2-89 changes to a serial port setting take effect when the command is processed. Any response messages generated after the commands are processed will be sent with th...

  • Page 114

    Section 2: general operation model 2657a high power system sourcemeter® instrument reference manual 2-90 2657a-901-01 rev. B/december 2012 rs-232 connections connect the rs-232 serial port of the model 2657a to the serial port of a computer using a straight- through rs-232 cable terminated with db-9...

  • Page 115: Relative Offset

    In this section: relative offset .......................................................................... 3-1 filters ....................................................................................... 3-2 reading buffers ...........................................................................

  • Page 116: Filters

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-2 2657a-901-01 rev. B/december 2012 to establish a unique relative offset value from the front panel: 1. Press the config key and then the rel key. 2. Select the measurement function ( current ...

  • Page 117

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-3 filter types the model 2657a has three filter types. These three filter types are broken down into two averaging filters and one median filter. The two avera...

  • Page 118

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-4 2657a-901-01 rev. B/december 2012 figure 31: median filter when a moving average filter or a median filter is first enabled, the stack is empty. The first reading conversion is placed in the ...

  • Page 119

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-5 remote filter programming filter commands the following table summarizes the filter commands. See the tsp command reference (on page 7-1) for details about c...

  • Page 120: Reading Buffers

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-6 2657a-901-01 rev. B/december 2012 reading buffers reading buffers capture measurements, ranges, instrument status, and output state of the keithley instruments model 2657a. The model 2657a ha...

  • Page 121

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-7 • buffer2 : configure buffer 2. • clear : clear buffer (yes or no). • elements : enable (on) or disable (off) data storage elements: • src-val : enable or di...

  • Page 122

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-8 2657a-901-01 rev. B/december 2012 to configure the instrument to append or overwrite measurements the next time data is acquired: 1. Press the config key. Select store , and then select stora...

  • Page 123

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-9 to save the reading buffer data: 1. From the front panel, press the store key, and then select save . 2. Select internal to save to internal nonvolatile memo...

  • Page 124

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-10 2657a-901-01 rev. B/december 2012 displaying other buffer readings and statistics to display other readings and statistics in the reading buffer: 1. While still in the buffer recall mode: • ...

  • Page 125

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-11 reading buffer commands the following table summarizes commands associated with the reading buffers. See tsp command reference (on page 7-1) for detailed re...

  • Page 126

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-12 2657a-901-01 rev. B/december 2012 commands to access readings: printbuffer( start_index, end_index, st_1, st_2, ... St_n ) prints data from buffer subtables: start_index (starting index of v...

  • Page 127

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-13 buffer read-only attributes the following table contains buffer read-only attributes. Buffer read-only attributes: read-only attributes used to access buffe...

  • Page 128

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-14 2657a-901-01 rev. B/december 2012 statistic attributes use the smua.Buffer.Getstats() function to access the reading buffer data statistics. The table below displays the attributes that you ...

  • Page 129

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-15 reading buffer attributes use the reading buffer attributes to access the reading buffer data. The table below displays the attributes that you can use to a...

  • Page 130

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-16 2657a-901-01 rev. B/december 2012 buffer status the buffer reading status attribute includes the status information as a numeric value; see the following table for values. For example, to ac...

  • Page 131

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-17 buffer examples dedicated reading buffer example the following programming example illustrates how to store data using dedicated reading buffer 1. In the ex...

  • Page 132

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-18 2657a-901-01 rev. B/december 2012 dual buffer example the programming example below shows a script for storing both current and voltage readings using buffer 1 for current and buffer 2 for v...

  • Page 133: Sweep Operation

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-19 dynamically allocated buffer example the programming example below illustrates how to store data to an allocated buffer called mybuffer . The model 2657a st...

  • Page 134

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-20 2657a-901-01 rev. B/december 2012 figure 32: sweep types dc and pulsed linear staircase sweeps (a): with this type of sweep, the voltage or current increases or decreases in fixed steps, beg...

  • Page 135

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-21 sweep characteristics for any of the sweep types, program a pulse mode sweep by configuring the end pulse action. Refer to pulse mode sweeps (on page 3-26) ...

  • Page 136

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-22 2657a-901-01 rev. B/december 2012 the sweep can be either positive-going or negative-going, depending on the relative values of the start and stop parameters. When the sweep starts, the outp...

  • Page 137

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-23 figure 34: increasing logarithmic sweep figure 35: decreasing logarithmic sweep 0 100 200 300 400 500 600 700 800 900 1 2 3 4 5 6 7 8 point source level 5 6...

  • Page 138

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-24 2657a-901-01 rev. B/december 2012 solving for k and b provides the following formulas: where: v end = the source value at the end point v start = the source value at the start point n = the ...

  • Page 139

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-25 in this example: a = 0, v start = 100, v end = 1000, n = 5 using the formula above, k = 1 step size ( b ) for the sweep in the above figure is calculated as...

  • Page 140

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-26 2657a-901-01 rev. B/december 2012 list sweeps use a list sweep to configure a sweep with arbitrary steps. When enabled, a measurement is made at each point after source and measurement settl...

  • Page 141

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-27 timers must be used to configure the pulse width and period. Refer to using timers to perform pulse mode sweeps (on page 3-44) for details. The pulse width ...

  • Page 142

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-28 2657a-901-01 rev. B/december 2012 configuring and running sweeps use the following topics to configure and run a sweep. Configuring compliance limits remotely voltage and current limits can ...

  • Page 143

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-29 initiating and running sweeps to run a sweep, you must configure the number of sweep points to output and the number of sweeps to perform. Use the trigger c...

  • Page 144

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-30 2657a-901-01 rev. B/december 2012 sweep programming examples procedures for programming and running a sweep for three sweep types are given on the following pages. Each of these procedures i...

  • Page 145: Triggering

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-31 pulse current sweep example the programming example below illustrates a pulse sweep. -- restore model 2657a defaults. Smua.Reset() -- set compliance to 100 ...

  • Page 146

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-32 2657a-901-01 rev. B/december 2012 you can obtain very precise timing and synchronization between channels of multiple instruments using the trigger model to control the actions of the source...

  • Page 147

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-33 trigger events are identified by means of an event id. The following table describes the trigger event ids. Trigger event ids* event id event description sm...

  • Page 148

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-34 2657a-901-01 rev. B/december 2012 figure 41: remote trigger model: normal (synchronous) mode idle smu x .Trigger.Initiate() configure and enable sweep source or sweep measure actions, then s...

  • Page 149

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-35 figure 42: remote trigger model: asynchronous mode end sweep action trigger layer idle smu x .Trigger.Initiate() configure and enable sweep source or sweep ...

  • Page 150

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-36 2657a-901-01 rev. B/december 2012 when the smu x .Trigger.Measure.Action attribute is set to smu x .Disable or smu x . Enable , the trigger model will operate in synchronous measurement mode...

  • Page 151

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-37 the source-measure unit (smu) can be configured to perform any or all available measurements during a sweep using the smua.Trigger.Measure. Y () function. T...

  • Page 152

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-38 2657a-901-01 rev. B/december 2012 smu event detectors as shown in the using the remote trigger model (on page 3-33) topic, the source-measure unit (smu) has multiple event detectors (see the...

  • Page 153

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-39 the programming example below illustrates how to configure a 10-point linear voltage sweep on smu a, where each step is triggered by the front-panel trig ke...

  • Page 154

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-40 2657a-901-01 rev. B/december 2012 figure 44: using trigger events to start actions a stimulus input can be configured to monitor for only one trigger event id at a time. To monitor more than...

  • Page 155

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-41 to disable triggering on the hardware trigger lines, set the mode to bypass. This allows direct control of the line. Hardware trigger mode summary trigger m...

  • Page 156

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-42 2657a-901-01 rev. B/december 2012 figure 45: external instrument triggering action overruns on hardware lines an action overrun occurs when a trigger event is received before the digital i/o...

  • Page 157

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-43 timer delays timers can be configured to perform the same delay each time or configured with a delay list that allows the timer to sequence through an array...

  • Page 158

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-44 2657a-901-01 rev. B/december 2012 figure 46: using a timer for an sdm cycle timer action overruns the timer generates an action overrun when it is triggered while a timer delay is still in p...

  • Page 159

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-45 the following figure shows the trigger setup for this example. Figure 47: single pulse triggering single pulse example code -- generate a single 50 ms, 100 ...

  • Page 160

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-46 2657a-901-01 rev. B/december 2012 pulse train example: the programming example below illustrates how to use two timers: one to control the pulse period, a second to control the pulse width. ...

  • Page 161

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-47 the following figure shows the trigger setup for this example. Figure 49: pulse train triggering stimulus input: trigger.Timer[1].Stimulus stimulus input: t...

  • Page 162

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-48 2657a-901-01 rev. B/december 2012 pulse train example code -- generate a 10-point pulse train where each pulse has a width of 50 -- milliseconds and a pulse period of 100 milliseconds. -- al...

  • Page 163

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-49 event blender modes event blenders can be used to perform logical and and logical or functions on trigger events. For example, trigger events can be trigger...

  • Page 164

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-50 2657a-901-01 rev. B/december 2012 understanding hardware value and pseudo line state lan triggering is similar to hardware synchronization except that lxi trigger packets are used instead of...

  • Page 165

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-51 the programming example below illustrates how to configure the lan trigger mode. -- set lan trigger 2 to have falling-edge mode. Lan.Trigger[2].Mode = lan.T...

  • Page 166

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-52 2657a-901-01 rev. B/december 2012 the command queue can fill up with trigger entries if too many *trg messages are received while a test script is running, even if the script is processing t...

  • Page 167

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-53 using the assert function to generate output triggers certain trigger objects can be used to generate output triggers on demand. These trigger objects are t...

  • Page 168

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-54 2657a-901-01 rev. B/december 2012 the programming example below illustrates how to have the smu immediately perform an action the first time through the trigger model, even if a programmed t...

  • Page 169

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-55 manual triggering example the programming example below illustrates how to pause a script and prompt the operator to press the trig key when they are ready ...

  • Page 170

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-56 2657a-901-01 rev. B/december 2012 falling edge trigger mode the falling edge trigger mode generates low pulses and detects all falling edges. The figure titled "falling edge input trigger" s...

  • Page 171

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-57 rising edge master trigger mode use the rising edge master (risingm) trigger mode (see the figure titled "risingm output trigger") to synchronize with non-k...

  • Page 172

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-58 2657a-901-01 rev. B/december 2012 figure 53: risinga input trigger output characteristics: • in addition to trigger events from other trigger objects, the digio.Trigger[ n ].Assert() and tsp...

  • Page 173

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-59 figure 55: either edge input trigger output characteristics: • in addition to trigger events from other trigger objects, the digio.Trigger[ n ].Assert() and...

  • Page 174

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-60 2657a-901-01 rev. B/december 2012 synchronous master trigger mode (synchronousm) use the synchronous master trigger mode (synchronousm) to generate falling edge output triggers, to detect th...

  • Page 175

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-61 figure 58: synchronousm output trigger synchronous acceptor trigger mode (synchronousa) use the synchronous acceptor trigger mode (synchronousa) in conjunct...

  • Page 176

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-62 2657a-901-01 rev. B/december 2012 figure 60: synchronousa output trigger synchronous trigger mode the synchronous trigger mode is a combination of synchronousa and synchronousm trigger modes...

  • Page 177: High-Capacitance Mode

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-63 output characteristics : • in addition to trigger events from other trigger objects, the digio.Trigger[ n ].Assert() and tsplink.Trigger[ n ].Assert() funct...

  • Page 178

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-64 2657a-901-01 rev. B/december 2012 understanding high-capacitance mode the source-measure unit (smu) in the model 2657a drives 100 nf of capacitance in normal operation. Typically, an interna...

  • Page 179

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-65 understanding the capacitor based on the capacitor's dielectric absorption performance, the settling time may change. Tantalum or electrolytic capacitors ar...

  • Page 180

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-66 2657a-901-01 rev. B/december 2012 command interface turning on high-c mode has the following effects on the smu settings: • smua.Measure.Autorangei is set to smua.Autorange_follow_limit and ...

  • Page 181

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-67 2. To run the i_leakage_measure() function in the kihighc factory script, send: -- charges the capacitor. Smua.Source.Levelv = 100 smua.Source.Output = smua...

  • Page 182: Display Operations

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-68 2657a-901-01 rev. B/december 2012 display operations display functions and attributes the display functions and attributes are used to perform the display operations covered in this section....

  • Page 183

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-69 display features display screen keithley instruments model 2657a high power system sourcemeter ® instrument displays source- measure values and readings or ...

  • Page 184

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-70 2657a-901-01 rev. B/december 2012 the display of the model 2657a can be used to display user-defined messages. For example, while a test is running, the following message can be displayed on...

  • Page 185

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-71 the function to set cursor position can be used two ways: display.Setcursor( row , column ) display.Setcursor( row , column , style ) where: row 1 or 2 colu...

  • Page 186

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-72 2657a-901-01 rev. B/december 2012 character codes the following special codes can be embedded in the text string to configure and customize the message: $n starts text on the next line (newl...

  • Page 187

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-73 returning a text message the display.Gettext() function returns the displayed message ( text ) and can be used in five ways: text = display.Gettext() text =...

  • Page 188

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-74 2657a-901-01 rev. B/december 2012 the following programming example illustrates how to present the operator with the choice of two menu items: test1 or test2. If test1 is selected, the messa...

  • Page 189

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-75 both the display.Inputvalue() and display.Prompt() functions display the editable input field, but the display.Inputvalue() function does not include the te...

  • Page 190

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-76 2657a-901-01 rev. B/december 2012 bit identification for indicators bit b16 b15 b14 b13 b12 b11 b10 b9 annunciator rel rear srq lstn talk rem err edit weighted value* 32768 16384 8192 4096 2...

  • Page 191

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-77 adding user tests menu entries you can use the following function in either of two ways to add an entry into the user tests menu: display.Loadmenu.Add( disp...

  • Page 192

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-78 2657a-901-01 rev. B/december 2012 the following programming example removes the entry named “part1” from the front-panel user tests menu: display.Loadmenu.Delete("part1") running a test from...

  • Page 193

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-79 display.Getlastkey() the display.Getlastkey() function is used to immediately return the key code for the last pressed key. The following programming exampl...

  • Page 194: Digital I/o

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-80 2657a-901-01 rev. B/december 2012 the following programming example illustrates how to prompt the user to press the exit (local) key to abort the script, or any other key to continue it: dis...

  • Page 195

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-81 digital i/o lines the port provides 14 digital i/o lines. Each output is set high (+5 v) or low (0 v) and can read high or low logic levels. Each digital i/...

  • Page 196

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-82 2657a-901-01 rev. B/december 2012 controlling digital i/o lines although the digital i/o lines are primarily intended for use with a device handler for limit testing, they can also be used f...

  • Page 197

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-83 digital i/o bit weighting bit weighting for the digital i/o lines is shown in the following table. Digital bit weight line # bit decimal weighting hexadecim...

  • Page 198

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-84 2657a-901-01 rev. B/december 2012 digital i/o programming example the programming commands below illustrate how to set bit b1 of the digital i/o port high, and then read the entire port valu...

  • Page 199

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-85 operation when sourcing, the output of the model 2657a can only be turned on when the interlock line is driven high through a switch to +5 v (as shown). If ...

  • Page 200

    Section 3: functions and features model 2657a high power system sourcemeter® instrument reference manual 3-86 2657a-901-01 rev. B/december 2012 tsp-link synchronization lines the model 2657a has three synchronization lines that you can use for triggering, digital i/o, and to synchronize multiple ins...

  • Page 201

    Model 2657a high power system sourcemeter® instrument reference manual section 3: functions and features 2657a-901-01 rev. B/december 2012 3-87 programming example the programming example below illustrates how to set bit b1 of the tsp-link digital i/o port high, and then read the entire port value: ...

  • Page 202: Analog-to-Digital Converter

    In this section: analog-to-digital converter ....................................................... 4-1 source-measure concepts ....................................................... 4-1 effects of load on current source settling time ........................ 4-25 creating pulses with the model 26...

  • Page 203

    Section 4: theory of operation model 2657a high power system sourcemeter® instrument reference manual 4-2 2657a-901-01 rev. B/december 2012 compliance limit principles a compliance limit acts as a clamp. If the output reaches the limit value, the high power system sourcemeter ® instrument attempts t...

  • Page 204

    Model 2657a high power system sourcemeter® instrument reference manual section 4: theory of operation 2657a-901-01 rev. B/december 2012 4-3 general power equation p cs the maximum power generated in an instrument channel that can be properly dissipated by the instrument cooling system measured in wa...

  • Page 205

    Section 4: theory of operation model 2657a high power system sourcemeter® instrument reference manual 4-4 2657a-901-01 rev. B/december 2012 operating boundaries source or sink depending on how it is programmed and what is connected to the output (load or source), the instrument can operate in any of...

  • Page 206

    Model 2657a high power system sourcemeter® instrument reference manual section 4: theory of operation 2657a-901-01 rev. B/december 2012 4-5 operation as a sink when operating the model 2657a in the second or fourth quadrant, the smu operates as a load that sinks and dissipates the power internally. ...

  • Page 207

    Section 4: theory of operation model 2657a high power system sourcemeter® instrument reference manual 4-6 2657a-901-01 rev. B/december 2012 figure 70: model 2657a v-source boundaries the first graph in the figure (labeled "a: output characteristics"), shows the output characteristics for the v-sourc...

  • Page 208

    Model 2657a high power system sourcemeter® instrument reference manual section 4: theory of operation 2657a-901-01 rev. B/december 2012 4-7 load considerations (v-source) the boundaries within which the high power system sourcemeter ® instrument operates depends on the load (device-under-test (dut))...

  • Page 209

    Section 4: theory of operation model 2657a high power system sourcemeter® instrument reference manual 4-8 2657a-901-01 rev. B/december 2012 notice that as resistance decreases, the slope of the dut load line increases. As resistance approaches infinity (open output), the system sourcemeter instrumen...

  • Page 210

    Model 2657a high power system sourcemeter® instrument reference manual section 4: theory of operation 2657a-901-01 rev. B/december 2012 4-9 the following figure shows a voltage sweep on a resistive load of 80 k Ω . For this example, the system sourcemeter instrument is programmed to sweep voltage fr...

  • Page 211

    Section 4: theory of operation model 2657a high power system sourcemeter® instrument reference manual 4-10 2657a-901-01 rev. B/december 2012 v-source sink operating boundaries the quadrant within which the model 2657a operates depends on the device-under-test (dut) connected to the model 2657a outpu...

  • Page 212

    Model 2657a high power system sourcemeter® instrument reference manual section 4: theory of operation 2657a-901-01 rev. B/december 2012 4-11 since the battery is a power source, initial operation can occur anywhere along the initial battery voltage line. This voltage is only limited by the capabilit...

  • Page 213

    Section 4: theory of operation model 2657a high power system sourcemeter® instrument reference manual 4-12 2657a-901-01 rev. B/december 2012 i-source operating boundaries model 2657a i-source operating boundaries the following figure shows the operating boundaries for the i-source. Only the first qu...

  • Page 214

    Model 2657a high power system sourcemeter® instrument reference manual section 4: theory of operation 2657a-901-01 rev. B/december 2012 4-13 load considerations (i-source) the boundaries within which the high power system sourcemeter ® instrument operates depends on the load (device-under-test (dut)...

  • Page 215

    Section 4: theory of operation model 2657a high power system sourcemeter® instrument reference manual 4-14 2657a-901-01 rev. B/december 2012 notice that as resistance increases, the slope of the dut load line increases. As resistance increases and approaches infinity (open output), the system source...

  • Page 216

    Model 2657a high power system sourcemeter® instrument reference manual section 4: theory of operation 2657a-901-01 rev. B/december 2012 4-15 the following figure shows a current sweep on a resistive load of 20 k Ω. For this example, the system sourcemeter instrument is programmed to sweep current fr...

  • Page 217

    Section 4: theory of operation model 2657a high power system sourcemeter® instrument reference manual 4-16 2657a-901-01 rev. B/december 2012 i-source sink operating boundaries the quadrant within which the model 2657a operates depends on the device-under-test (dut) connected to the model 2657a outpu...

  • Page 218

    Model 2657a high power system sourcemeter® instrument reference manual section 4: theory of operation 2657a-901-01 rev. B/december 2012 4-17 make sure to take into account that reversing the polarity may destroy some power sources. To prevent a negative charge, monitor the smu’s measurement of the b...

  • Page 219

    Section 4: theory of operation model 2657a high power system sourcemeter® instrument reference manual 4-18 2657a-901-01 rev. B/december 2012 basic circuit configurations source v when configured to source voltage (v-source), as shown in the figure below, the instrument functions as a low-impedance v...

  • Page 220

    Model 2657a high power system sourcemeter® instrument reference manual section 4: theory of operation 2657a-901-01 rev. B/december 2012 4-19 source i when the instrument is configured to source current (i-source), as shown in the figure below, the instrument functions as a high-impedance current sou...

  • Page 221

    Section 4: theory of operation model 2657a high power system sourcemeter® instrument reference manual 4-20 2657a-901-01 rev. B/december 2012 source i measure i, source v measure v the high power system sourcemeter ® instrument can measure the function it is sourcing. When sourcing a voltage, you can...

  • Page 222

    Model 2657a high power system sourcemeter® instrument reference manual section 4: theory of operation 2657a-901-01 rev. B/december 2012 4-21 in the following figure, the instrument uses a 2-wire local sensing configuration and is set to measure current only by setting it to source 0 v and measure cu...

  • Page 223

    Section 4: theory of operation model 2657a high power system sourcemeter® instrument reference manual 4-22 2657a-901-01 rev. B/december 2012 figure 88: contact check circuit configuration remote sense hi hi remote lo sense lo local local x1 guard cchk sw cchk sw + – 1 2 2 4 4 1 2 3 3 aggregate conta...

  • Page 224

    Model 2657a high power system sourcemeter® instrument reference manual section 4: theory of operation 2657a-901-01 rev. B/december 2012 4-23 guard guard is at the same potential as output hi. Thus, if hazardous voltages are present at output hi, they are also present at the guard terminal. Guard ove...

  • Page 225

    Section 4: theory of operation model 2657a high power system sourcemeter® instrument reference manual 4-24 2657a-901-01 rev. B/december 2012 inside the test fixture, a triaxial cable can be used to extend guard to the device under test (dut). The center conductor of the cable is used for hi, and the...

  • Page 226

    Model 2657a high power system sourcemeter® instrument reference manual section 4: theory of operation 2657a-901-01 rev. B/december 2012 4-25 output connection considerations use care when designing a system that contains the model 2657a (or any other high voltage source). There are several specific ...

  • Page 227

    Section 4: theory of operation model 2657a high power system sourcemeter® instrument reference manual 4-26 2657a-901-01 rev. B/december 2012 pulse rise and fall times although the model 2657a can create pulses, it is not a pulse generator (pulse rise times are not programmable). The pulse rise time ...

  • Page 228

    Model 2657a high power system sourcemeter® instrument reference manual section 4: theory of operation 2657a-901-01 rev. B/december 2012 4-27 load and operating mode settling times for the current source will vary with the resistive load applied. In addition to the load, the times will vary dependent...

  • Page 229

    In this section: introduction to tsp operation ................................................... 5-1 about tsp commands ............................................................. 5-3 factory scripts ........................................................................ 5-18 introduction to ts...

  • Page 230

    Section 5: introduction to tsp operation model 2657a high power system sourcemeter® instrument reference manual 5-2 2657a-901-01 rev. B/december 2012 example 2 you can use the results of a function-based command directly or assign variables to the results for later access. The following code saves t...

  • Page 231: About Tsp Commands

    Model 2657a high power system sourcemeter® instrument reference manual section 5: introduction to tsp operation 2657a-901-01 rev. B/december 2012 5-3 information on scripting and programming if you need information about using scripts with your tsp-enabled instrument, see fundamentals of scripting f...

  • Page 232

    Section 5: introduction to tsp operation model 2657a high power system sourcemeter® instrument reference manual 5-4 2657a-901-01 rev. B/december 2012 the test script processor (tsp) scripting engine stores all numbers internally as ieee std 754 double-precision floating point values. The logical ope...

  • Page 233

    Model 2657a high power system sourcemeter® instrument reference manual section 5: introduction to tsp operation 2657a-901-01 rev. B/december 2012 5-5 digital i/o the digital i/o port of the instrument can control external circuitry (such as a component handler for binning operations). The i/o port h...

  • Page 234

    Section 5: introduction to tsp operation model 2657a high power system sourcemeter® instrument reference manual 5-6 2657a-901-01 rev. B/december 2012 error queue when errors and events occur, the error and status messages are placed in the error queue. Use the error queue commands to request error a...

  • Page 235

    Model 2657a high power system sourcemeter® instrument reference manual section 5: introduction to tsp operation 2657a-901-01 rev. B/december 2012 5-7 file descriptors cannot be passed between nodes in a tsp-link ® system, so the io.Open() , filevar::read() , and filevar::write commands are not acces...

  • Page 236

    Section 5: introduction to tsp operation model 2657a high power system sourcemeter® instrument reference manual 5-8 2657a-901-01 rev. B/december 2012 lan and lxi the lan commands have options that allow you to review and configure network settings. The lan.Config.* commands allow you to configure la...

  • Page 237

    Model 2657a high power system sourcemeter® instrument reference manual section 5: introduction to tsp operation 2657a-901-01 rev. B/december 2012 5-9 localnode.Passwordmode (on page 7-137) miscellaneous delay() (on page 7-48) exit() (on page 7-87) localnode.Linefreq (on page 7-135) localnode.Passwor...

  • Page 238

    Section 5: introduction to tsp operation model 2657a high power system sourcemeter® instrument reference manual 5-10 2657a-901-01 rev. B/december 2012 reading buffer reading buffers capture measurements, ranges, instrument status, and output states of the instrument. Buffervar.Appendmode (on page 7-...

  • Page 239

    Model 2657a high power system sourcemeter® instrument reference manual section 5: introduction to tsp operation 2657a-901-01 rev. B/december 2012 5-11 saved setups use the saved setups commands to save and restore the configuration of the instrument. You can save or restore configurations to or from...

  • Page 240

    Section 5: introduction to tsp operation model 2657a high power system sourcemeter® instrument reference manual 5-12 2657a-901-01 rev. B/december 2012 smu localnode.Linefreq (on page 7-135) smux.Abort() (on page 7-176) smux.Buffer.Getstats() (on page 7-177) smux.Buffer.Recalculatestats() (on page 7-...

  • Page 241

    Model 2657a high power system sourcemeter® instrument reference manual section 5: introduction to tsp operation 2657a-901-01 rev. B/december 2012 5-13 smux.Trigger.Measure.Action (on page 7-235) smux.Trigger.Measure.Set() (on page 7-235) smux.Trigger.Measure.Stimulus (on page 7-236) smux.Trigger.Mea...

  • Page 242

    Section 5: introduction to tsp operation model 2657a high power system sourcemeter® instrument reference manual 5-14 2657a-901-01 rev. B/december 2012 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 a...

  • Page 243

    Model 2657a high power system sourcemeter® instrument reference manual section 5: introduction to tsp operation 2657a-901-01 rev. B/december 2012 5-15 time buffervar.Basetimestamp (on page 7-16) buffervar.Collecttimestamps (on page 7-21) buffervar.Timestampresolution (on page 7-31) delay() (on page ...

  • Page 244

    Section 5: introduction to tsp operation model 2657a high power system sourcemeter® instrument reference manual 5-16 2657a-901-01 rev. B/december 2012 smux.Trigger.Source.Action (on page 7-240) smux.Trigger.Source.Limity (on page 7-241) smux.Trigger.Source.Lineary() (on page 7-242) smux.Trigger.Sour...

  • Page 245

    Model 2657a high power system sourcemeter® instrument reference manual section 5: introduction to tsp operation 2657a-901-01 rev. B/december 2012 5-17 tsp-link these functions and attributes allow you to set up and work with a system that is connected by a tsp-link ® network. Tsplink.Group (on page ...

  • Page 246: Factory Scripts

    Section 5: introduction to tsp operation model 2657a high power system sourcemeter® instrument reference manual 5-18 2657a-901-01 rev. B/december 2012 factory scripts introduction the keithley instruments model 2657a high power system sourcemeter ® instrument is shipped with one or more factory scri...

  • Page 247

    Model 2657a high power system sourcemeter® instrument reference manual section 5: introduction to tsp operation 2657a-901-01 rev. B/december 2012 5-19 running a factory script function from the model 2657a front panel controls 1. Press the load key. 2. Select factory . 3. Select the function to run ...

  • Page 248

    Section 5: introduction to tsp operation model 2657a high power system sourcemeter® instrument reference manual 5-20 2657a-901-01 rev. B/december 2012 kipulse factory script the kipulse factory script provides examples of how to generate pulses and to provide a simple pulsing interface. Pulses can b...

  • Page 249

    Model 2657a high power system sourcemeter® instrument reference manual section 5: introduction to tsp operation 2657a-901-01 rev. B/december 2012 5-21 advanced features for kipulse tag parameter pulse functions variable off time between pulses in a pulse train the kipulse “configure” functions will ...

  • Page 250: Instrument Programming

    In this section: fundamentals of scripting for tsp ........................................... 6-1 fundamentals of programming for tsp ................................. 6-10 test script builder (tsb) ....................................................... 6-29 password management ......................

  • Page 251

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-2 2657a-901-01 rev. B/december 2012 what is a script? A script is a collection of instrument control commands and programming statements. Scripts that you create are referred to as user scripts...

  • Page 252

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-3 commands that cannot be used in scripts though an instrument accepts the following commands, you cannot use these commands in scripts. Commands that cannot b...

  • Page 253

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-4 2657a-901-01 rev. B/december 2012 named scripts a named script is a script with a unique name. You can have as many named scripts as needed in the instrument (within the limits of the memory ...

  • Page 254

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-5 to load a named script by sending commands: 1. Send the command loadscript scriptname , where scriptname is the name of the script. The name must be a legal ...

  • Page 255

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-6 2657a-901-01 rev. B/december 2012 run a named script you can run any named script that is in the run-time environment using one of the following commands: • scriptvar () • scriptvar .Run() wh...

  • Page 256

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-7 example: set a script to run automatically test5.Autorun = "yes" test5.Save() assume a script named test5 is in the run-time environment. The next time the i...

  • Page 257

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-8 2657a-901-01 rev. B/december 2012 save a user script you can save scripts to nonvolatile memory using commands or tsb embedded. Only named scripts can be saved to nonvolatile memory. The anon...

  • Page 258

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-9 delete user scripts these steps remove a script from nonvolatile memory. To completely remove a script from the instrument, there are additional steps you mu...

  • Page 259

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-10 2657a-901-01 rev. B/december 2012 -- clear the display. Display.Clear() -- prompt user for digital i/o line on which to output trigger. Mydigioline = display.Menu("select digio line", "1 2 3...

  • Page 260

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-11 what is lua? Lua is a programming language that can be used with tsp-enabled instruments. Lua is an efficient language with simple syntax that is easy to le...

  • Page 261

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-12 2657a-901-01 rev. B/december 2012 function and variable name restrictions you cannot use factory script names, functions created by factory scripts, lua reserved words and top level command ...

  • Page 262

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-13 do not create variable names that are the same as the top level command names of model 2657a remote commands. Doing so will result in the loss of use of tho...

  • Page 263

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-14 2657a-901-01 rev. B/december 2012 example: string and number x = "123" print(x, type(x)) x = x + 7 print(x, type(x)) 123 string adding a number to x forces its type to number. 1.30000e+02 nu...

  • Page 264

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-15 where: • myfunction : the name of the function. • parameterx : parameter names. To use multiple parameters, separate the names with commas. • functionbody i...

  • Page 265

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-16 2657a-901-01 rev. B/december 2012 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 acti...

  • Page 266

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-17 example: user script user script created in test script builder or tsb embedded user script created in user's own program function mydisplay(name) display.C...

  • Page 267

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-18 2657a-901-01 rev. B/december 2012 example print(10 or errorqueue.Next()) print(nil or "a") print(nil and 10) print(false and errorqueue.Next()) print(false and nil) print(false or nil) print...

  • Page 268

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-19 you can use parentheses to change the precedences in an expression. The concatenation (" .. ") and exponentiation (" ^ ") operators are right associative. A...

  • Page 269

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-20 2657a-901-01 rev. B/december 2012 example: if and else x = 2 if not x then print("this is from the if block") else print("this is from the else block") end output: this is from the else bloc...

  • Page 270

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-21 while loops to use conditional expressions to determine whether to execute or end a loop, you use while loops. These loops are similar to conditional branch...

  • Page 271

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-22 2657a-901-01 rev. B/december 2012 for loops there are two variations of for statements supported in lua: numeric and generic. In a for loop, the loop expressions are evaluated once, before t...

  • Page 272

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-23 break the break statement can be used to terminate the execution of a while , repeat , or for loop, skipping to the next statement after the loop. A break e...

  • Page 273

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-24 2657a-901-01 rev. B/december 2012 example: break with infinite loop a, b = 0, 1 while true do print(a, b) a, b = b, a + b if a > 500 then break end end this example uses a break statement th...

  • Page 274

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-25 standard libraries in addition to the standard programming constructs described in this document, lua includes standard libraries that contain useful functi...

  • Page 275

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-26 2657a-901-01 rev. B/december 2012 lua memory management lua automatically manages memory, which means you do not have to allocate memory for new objects and free it when the objects are no l...

  • Page 276

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-27 string library functions function description string.Lower( s ) receives a string and returns a copy of this string with all uppercase letters changed to lo...

  • Page 277

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-28 2657a-901-01 rev. B/december 2012 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 fu...

  • Page 278: Test Script Builder (Tsb)

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-29 programming example: script with a for loop the following script puts a message on the front panel display slowly — one character at a time. The intent of t...

  • Page 279

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-30 2657a-901-01 rev. B/december 2012 installing the tsb add-in when you install the test script builder software suite, all available updates for tsb add-in software are also installed. This in...

  • Page 280

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-31 the following figure shows an example of the test script builder. As shown, the workspace is divided into these areas: • project navigator • script editor •...

  • Page 281

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-32 2657a-901-01 rev. B/december 2012 script editor the script editor is where scripts are written, modified, and debugged. To open and display a script file, double-click the file name in the p...

  • Page 282: Password Management

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-33 the outline tab is visible by default in the tsp perspective. Icon name examples global function variable function gfunction() end local function variable l...

  • Page 283

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-34 2657a-901-01 rev. B/december 2012 password overview passwords can contain up to 255 characters. If the password feature is enabled, a password is required to view and modify the following we...

  • Page 284

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-35 unlocking the remote interface if the remote interface is locked, you must enter the password before the model 2657a responds to any command issued over a r...

  • Page 285: Working With Tsb Embedded

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-36 2657a-901-01 rev. B/december 2012 working with tsb embedded tsb embedded is an alternative to the full version of the test script builder (tsb) suite. The capabilities of tsb embedded are si...

  • Page 286

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-37 sending instrument commands with tsb embedded the response from the instrument appears in the instrument output area. To send commands from the command line...

  • Page 287: Advanced Scripting For Tsp

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-38 2657a-901-01 rev. B/december 2012 advanced scripting for tsp the following topics describe advanced information that can help you understand how the test script processor (tsp ® ) scripting ...

  • Page 288

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-39 figure 95: global variables and scripts in the runtime environment create a script using the script.New() command use the script.New() function to copy an e...

  • Page 289

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-40 2657a-901-01 rev. B/december 2012 for example, to set up a two-second beep, you can send the command: beeptwosec = script.New("beeper.Enable = 1 beeper.Beep(2, 2400)", "beeptwosec") to run t...

  • Page 290

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-41 figure 97: create an unnamed script a script will become unnamed if you create a new script with the same name. In this circumstance, the name of the script...

  • Page 291

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-42 2657a-901-01 rev. B/december 2012 figure 98: create a new script with the name of an existing script rename a script you can rename a script. You might want to rename a script if you need to...

  • Page 292

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-43 if the new name is the same as a name that is already used for a script, the name of the existing script is removed and that script becomes unnamed. This re...

  • Page 293

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-44 2657a-901-01 rev. B/december 2012 retrieve a user script there are several ways to retrieve the source code of a user script: • one line at a time: use scriptvar .List() to retrieve the sour...

  • Page 294

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-45 retrieve a script as a single string to retrieve the entire user script source code as a single string, use the scriptvar. Source attribute. The loadscript ...

  • Page 295

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-46 2657a-901-01 rev. B/december 2012 example: retrieve the content of a script with scriptvar.List() test.List() request a listing of the source of test . An example of the possible instrument ...

  • Page 296

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-47 restore a script to the run-time environment you can retrieve a script that was removed from the run-time environment but is still saved in nonvolatile memo...

  • Page 297

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-48 2657a-901-01 rev. B/december 2012 note that the dedicated reading buffers do not consume memory that is needed by the run-time environment; do not include them in your memory consumption cal...

  • Page 298

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-49 tsp-link system expansion interface overview the tsp-link ® expansion interface allows the model 2657a instrument to communicate with other test script proc...

  • Page 299

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-50 2657a-901-01 rev. B/december 2012 tsp-link system you can use the tsp-link ® expansion interface to expand your test system to include up to 32 addressable tsp ® enabled instruments that use...

  • Page 300

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-51 figure 100: model 2657a tsp-link connections initialization before a tsp-link ® system can be used, it must be initialized. For initialization to succeed, e...

  • Page 301

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-52 2657a-901-01 rev. B/december 2012 to assign a node number using a remote command: set the tsplink.Node attribute of the instrument: tsplink.Node = n where : n = 1 to 64 to determine the node...

  • Page 302

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-53 the programming example below illustrates a tsp-link reset operation and displays its state: tsplink.Reset() print(tsplink.State) if the reset operation is ...

  • Page 303

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-54 2657a-901-01 rev. B/december 2012 using the reset() command most tsp-link ® system operations target a single node in the system, but the reset() command affects the system as a whole by res...

  • Page 304

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-55 there are two methods you can use to run test scripts simultaneously: • create multiple tsp-link networks • use a single tsp-link network with groups the fo...

  • Page 305

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-56 2657a-901-01 rev. B/december 2012 another method you can use to run simultaneous test scripts is to use groups with a single tsp-link network. Each group on the tsp-link network can run a te...

  • Page 306

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-57 the following table shows an example of the functions of a single tsp-link network. Each group in this example runs a different test script than the other g...

  • Page 307

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-58 2657a-901-01 rev. B/december 2012 group leader overview each group has a dynamic group leader. The last node in a group that performs any operation initiated by the master node is the group ...

  • Page 308

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-59 coordinating overlapped operations in remote groups all overlapped operations on all nodes in a group must have completed before the master node can send a ...

  • Page 309

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-60 2657a-901-01 rev. B/december 2012 copying test scripts across the tsp-link network to run a large script on a remote node, copy the test script to the remote node to increase the speed of te...

  • Page 310: Tsp-Net

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-61 tsp-net overview the tsp-net ® library allows the model 2657a to control lan-enabled devices directly through its lan port. This enables the model 2657a to ...

  • Page 311

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-62 2657a-901-01 rev. B/december 2012 using tsp-net with any ethernet-enabled device refer to tsp command reference (on page 7-1) for details about the commands presented in this section. The mo...

  • Page 312

    Model 2657a high power system sourcemeter® instrument reference manual section 6: instrument programming 2657a-901-01 rev. B/december 2012 6-63 example script the following example demonstrates how to connect to a remote device that is not tsp ® enabled, and send and receive data from this device: -...

  • Page 313

    Section 6: instrument programming model 2657a high power system sourcemeter® instrument reference manual 6-64 2657a-901-01 rev. B/december 2012 tsp-net instrument commands: tsp-enabled device control the following instrument commands provide tsp-enabled device control: tspnet.Tsp.Abort() (on page 7-...

  • Page 314: Tsp Command Reference

    In this section: tsp command programming notes .......................................... 7-1 using the tsp command reference ......................................... 7-4 tsp commands ........................................................................ 7-8 tsp command programming notes this sec...

  • Page 315

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-2 2657a-901-01 rev. B/december 2012 for example, to use smu a to take voltage measurements and store them in buffer vbuffername , you would send: smua.Trigger.Measure.V(vbuffername) syntax rules...

  • Page 316

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-3 time and date values time and date values are represented as the number of seconds since some base. Representing time as a number of seconds is referred to as...

  • Page 317

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-4 2657a-901-01 rev. B/december 2012 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 instrume...

  • Page 318

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-5 command name and summary table each instrument command description starts with the command name, followed by a table with relevant information for each comman...

  • Page 319

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-6 2657a-901-01 rev. B/december 2012 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 variat...

  • Page 320

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-7 figure 107: code examples in command listings 1. Actual example code that you can copy from this table and paste into your own programming application. 2. Des...

  • Page 321: Tsp Commands

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-8 2657a-901-01 rev. B/december 2012 tsp commands beeper.Beep() this command generates an audible tone. Type tsp-link accessible affected by where saved default value function yes usage beeper.Be...

  • Page 322: Bit.Bitand()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-9 example beeper.Enable = beeper.On beeper.Beep(2, 2400) enables the beeper and generates a two-second, 2400 hz tone. Also see beeper.Beep() (on page 7-8) bit.B...

  • Page 323: Bit.Bitxor()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-10 2657a-901-01 rev. B/december 2012 details any fractional parts of value1 and value2 are truncated to make them integers. The returned result is also an integer. Example testresult = bit.Bitor...

  • Page 324: Bit.Clear()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-11 bit.Clear() this function clears a bit at a specified index position. Type tsp-link accessible affected by where saved default value function no usage result...

  • Page 325: Bit.Getfield()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-12 2657a-901-01 rev. B/december 2012 details this function returns the value of the bit in value at index . This is the same as returning value with all other bits set to zero (0). The least sig...

  • Page 326: Bit.Set()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-13 also see bit manipulation and logic operations (on page 5-3) bit.Get() (on page 7-11) bit.Set() (on page 7-13) bit.Setfield() (on page 7-13) bit.Set() this f...

  • Page 327: Bit.Test()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-14 2657a-901-01 rev. B/december 2012 usage result = bit.Setfield( value , index , width , fieldvalue ) result result of the bit manipulation value specified number index one-based bit position i...

  • Page 328: Bit.Toggle()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-15 details this function returns result , which is the result of the tested bit. The least significant bit of value is at index position 1; the most significant...

  • Page 329: Buffervar.Appendmode

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-16 2657a-901-01 rev. B/december 2012 also see bit manipulation and logic operations (on page 5-3) bit.Clear() (on page 7-11) bit.Get() (on page 7-11) bit.Set() (on page 7-13) bit.Test() (on page...

  • Page 330: Buffervar.Cachemode

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-17 usage basetime = buffervar .Basetimestamp basetime the timestamp of the first stored reading buffervar the reading buffer; can be a dynamically allocated buf...

  • Page 331: Buffervar.Capacity

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-18 2657a-901-01 rev. B/december 2012 details assigning a value to this attribute enables or disables the reading buffer cache. When enabled, the reading buffer cache improves access speed to rea...

  • Page 332: Buffervar.Clear()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-19 also see reading buffers (on page 3-6) smux.Makebuffer() (on page 7-193) smux.Measure.Overlappedy() (on page 7-204) smux.Measure.Y() (on page 7-208) smux.Nvb...

  • Page 333

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-20 2657a-901-01 rev. B/december 2012 details this function clears all readings from the specified cache. If you run successive operations that overwrite reading buffer data, the reading buffer m...

  • Page 334: Buffervar.Collecttimestamps

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-21 example smua.Nvbuffer1.Collectsourcevalues = 1 include source values with readings for dedicated reading buffer 1. Also see buffervar.Clear() (on page 7-19) ...

  • Page 335: Buffervar.Fillcount

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-22 2657a-901-01 rev. B/december 2012 buffervar.Fillcount this attribute sets the reading buffer fill count. Type tsp-link accessible affected by where saved default value attribute (rw) yes not ...

  • Page 336: Buffervar.Measurefunctions

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-23 details when this attribute is set to smu x .Fill_once , the reading buffer will not overwrite readings. If the buffer fills up, new readings will be discard...

  • Page 337: Buffervar.Measureranges

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-24 2657a-901-01 rev. B/december 2012 example 1 measurefunction = smua.Nvbuffer1.Measurefunctions[5] store the measure function used to make reading number 5. Example 2 printbuffer(1, 5, smua.Nvb...

  • Page 338: Buffervar.N

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-25 example measurerange = smua.Nvbuffer1.Measureranges[1] store the measure range that was used to make reading number 1. Printbuffer(1, 10, smua.Nvbuffer1.Meas...

  • Page 339: Buffervar.Readings

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-26 2657a-901-01 rev. B/december 2012 also see buffervar.Measurefunctions (on page 7-23) buffervar.Measureranges (on page 7-24) buffervar.Readings (on page 7-26) buffervar.Sourcefunctions (on pag...

  • Page 340: Buffervar.Sourcefunctions

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-27 buffervar.Sourcefunctions this attribute contains the source function that was being used when the readings were stored in a specified reading buffer. Type t...

  • Page 341: Buffervar.Sourceoutputstates

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-28 2657a-901-01 rev. B/december 2012 buffervar.Sourceoutputstates this attribute indicates the state of the source output for readings that are stored in a specified buffer. Type tsp-link access...

  • Page 342: Buffervar.Sourcevalues

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-29 usage sourcerange = buffervar .Sourceranges[ n ] sourcerange the source range used to acquire reading number n in the specified buffer buffervar the reading ...

  • Page 343: Buffervar.Statuses

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-30 2657a-901-01 rev. B/december 2012 usage sourcevalue = buffervar .Sourcevalues[ n ] sourcevalue the source's output value when reading n of the specified buffer was acquired buffervar the read...

  • Page 344

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-31 usage statusinformation = buffervar .Statuses[ n ] statusinformation the status value when reading n of the specified buffer was acquired buffervar the readi...

  • Page 345: Buffervar.Timestamps

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-32 2657a-901-01 rev. B/december 2012 details assigning a value to this attribute sets the resolution for the timestamps. Reading this attribute returns the timestamp resolution value. This value...

  • Page 346: Configpulseimeasurev()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-33 example timestamp = smua.Nvbuffer1.Timestamps[1] get the timestamp of the first reading stored in dedicated reading buffer 1. Also see buffervar.Clear() (on ...

  • Page 347

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-34 2657a-901-01 rev. B/december 2012 buffer reading buffer where pulsed measurements will be stored; if this is nil when the function is called, no measurements will be made when the pulse train...

  • Page 348

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-35 configpulseimeasurevsweeplin() this kipulse factory script function configures a linear pulsed current sweep with a voltage measurement at each point. Type t...

  • Page 349

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-36 2657a-901-01 rev. B/december 2012 details data for pulsed voltage measurements are stored in the reading buffer specified by the buffer input parameter. This function configures a linear puls...

  • Page 350

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-37 configpulseimeasurevsweeplog() this kipulse factory script function configures a voltage pulse train with a current measurement at each point. Type tsp-link ...

  • Page 351

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-38 2657a-901-01 rev. B/december 2012 details data for pulsed voltage measurements are stored in the reading buffer specified by the buffer input parameter. This function configures a logarithmic...

  • Page 352: Configpulsevmeasurei()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-39 configpulsevmeasurei() this kipulse factory script function configures a voltage pulse train with a current measurement at each point. Type tsp-link accessib...

  • Page 353

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-40 2657a-901-01 rev. B/december 2012 figure 112: configpulsevmeasurei() example 1 configpulsevmeasurei(smua, 0, 400, 100e-6, 5e-3, 10e-3, 10, smua.Nvbuffer1, 2) set up a pulse train that uses sy...

  • Page 354

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-41 configpulsevmeasureisweeplin() this kipulse factory script function configures a voltage pulse train with a current measurement at each point. Type tsp-link ...

  • Page 355

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-42 2657a-901-01 rev. B/december 2012 this function does not cause the specified smu to output a pulse train. It does check to see if all the pulse dimensions can be achieved, and if they can, as...

  • Page 356

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-43 usage f , msg = configpulsevmeasureisweeplog( smu, bias, start, stop, limit, ton, toff, points, buffer, tag, sync_in, sync_out, sync_in_timeout, sync_in_abor...

  • Page 357

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-44 2657a-901-01 rev. B/december 2012 details data for pulsed current measurements are stored in the reading buffer specified by the buffer input parameter. This function configures a logarithmic...

  • Page 358: Dataqueue.Add()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-45 dataqueue.Add() this function adds an entry to the data queue. Type tsp-link accessible affected by where saved default value function yes usage result = dat...

  • Page 359: Dataqueue.Clear()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-46 2657a-901-01 rev. B/december 2012 usage count = dataqueue.Capacity count the variable assigned the value of dataqueue.Capacity details this constant always returns the maximum number of entri...

  • Page 360: Dataqueue.Count

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-47 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) y...

  • Page 361: Delay()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-48 2657a-901-01 rev. B/december 2012 details if the data queue is empty, the function waits up to the timeout value. If data is not available in the data queue before the timeout expires, the re...

  • Page 362: Digio.Readbit()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-49 example 1 beeper.Beep(0.5, 2400) delay(0.250) beeper.Beep(0.5, 2400) emit a double-beep at 2400 hz. The sequence is 0.5 s on, 0.25 s off, 0.5 s on. Example 2...

  • Page 363: Digio.Readport()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-50 2657a-901-01 rev. B/december 2012 digio.Readport() this function reads the digital i/o port. Type tsp-link accessible affected by where saved default value function yes usage data = digio.Rea...

  • Page 364: Digio.Trigger[N].Clear()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-51 also see digio.Trigger[n].Pulsewidth (on page 7-54) digio.Trigger[n].Clear() this function clears the trigger event on a digital i/o line. Type tsp-link acce...

  • Page 365: Digio.Trigger[N].Mode

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-52 2657a-901-01 rev. B/december 2012 example 2 smua.Trigger.Arm.Stimulus = digio.Trigger[3].Event_id uses a trigger event on digital i/o trigger line 3 to be the trigger stimulus for the smu. Al...

  • Page 366: Digio.Trigger[N].Overrun

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-53 when programmed to any mode except digio.Trig_bypass , the output state of the i/o line is controlled by the trigger logic, and the user-specified output sta...

  • Page 367: Digio.Trigger[N].Pulsewidth

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-54 2657a-901-01 rev. B/december 2012 digio.Trigger[n].Pulsewidth this attribute describes the length of time that the trigger line is asserted for output triggers. Type tsp-link accessible affec...

  • Page 368: Digio.Trigger[N].Reset()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-55 digio.Trigger[n].Reset() this function resets trigger values to their factory defaults. Type tsp-link accessible affected by where saved default value functi...

  • Page 369

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-56 2657a-901-01 rev. B/december 2012 usage triggerstimulus = digio.Trigger[ n ].Stimulus digio.Trigger[ n ].Stimulus = triggerstimulus triggerstimulus the event identifier for the triggering eve...

  • Page 370: Digio.Trigger[N].Wait()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-57 example 2 digio.Trigger[3].Stimulus = smua.Trigger.Source_complete_event_id set the trigger stimulus of digital i/o line 3 to be the source complete event. A...

  • Page 371: Digio.Writebit()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-58 2657a-901-01 rev. B/december 2012 digio.Writebit() this function sets a digital i/o line high or low. Type tsp-link accessible affected by where saved default value function yes usage digio.W...

  • Page 372: Digio.Writeprotect

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-59 details the binary representation of data indicates the output pattern to be written to the i/o port. For example, a data value of 170 has a binary equivalen...

  • Page 373: Display.Clear()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-60 2657a-901-01 rev. B/december 2012 display.Clear() this function clears all lines of the display. Type tsp-link accessible affected by where saved default value function yes usage display.Clea...

  • Page 374

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-61 details this function returns a bitmasked value showing which indicators are turned on. The 16-bit binary equivalent of the returned value is the bitmask. Th...

  • Page 375: Display.Getcursor()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-62 2657a-901-01 rev. B/december 2012 display.Getcursor() this function reads the present position of the cursor on the front panel display. Type tsp-link accessible affected by where saved defau...

  • Page 376: Display.Getlastkey()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-63 display.Getlastkey() this function retrieves the key code for the last pressed key. Type tsp-link accessible affected by where saved default value function y...

  • Page 377: Display.Gettext()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-64 2657a-901-01 rev. B/december 2012 example key = display.Getlastkey() print(key) on the front panel, press the menu key and then send the code shown here. This retrieves the key code for the l...

  • Page 378: Display.Inputvalue()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-65 example 1 display.Clear() display.Setcursor(1, 1) display.Settext("abcdefghij$dklmnopqrst") display.Setcursor(2, 1) display.Settext("abcdefghijklm$bnopqrstuv...

  • Page 379

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-66 2657a-901-01 rev. B/december 2012 details the format parameter uses zeros (0), the decimal point, polarity sign, and exponents to define how the input field is formatted. The format parameter...

  • Page 380: Display.Loadmenu.Add()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-67 display.Loadmenu.Add() this function adds an entry to the user tests menu, which can be accessed by pressing the load key on the instrument front panel. Type...

  • Page 381: Display.Loadmenu.Catalog()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-68 2657a-901-01 rev. B/december 2012 example 2 display.Loadmenu.Add( "test", "dut1() beeper.Beep(2, 500)", display.Save) assume a script with a function named “dut1” has already been loaded into...

  • Page 382: Display.Loadmenu.Delete()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-69 example for displayname, code in display.Loadmenu.Catalog() do print(displayname, code) end output: test dut1() beeper.Beep(2, 500) part1 testpart([[part1]],...

  • Page 383: Display.Menu()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-70 2657a-901-01 rev. B/december 2012 details set display.Locallockout to display.Lock to prevent the user from interrupting remote operation by pressing the exit (local) key. Set this attribute ...

  • Page 384: Display.Numpad

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-71 display.Numpad this attribute controls whether the front panel keys act as a numeric keypad during value entry. Type tsp-link accessible affected by where sa...

  • Page 385

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-72 2657a-901-01 rev. B/december 2012 details this function creates an editable input field at the present cursor position, and an input prompt message on the bottom line. Example of a displayed ...

  • Page 386: Display.Screen

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-73 display.Screen this attribute contains the selected display screen. Type tsp-link accessible affected by where saved default value attribute (rw) yes instrum...

  • Page 387: Display.Setcursor()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-74 2657a-901-01 rev. B/december 2012 details this command simulates the pressing of a front panel key or navigation wheel, or the turning the navigation wheel one click to the left or right. Key...

  • Page 388: Display.Settext()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-75 details sending this command selects the user screen and then moves the cursor to the given location. The display.Clear() , display.Setcursor() , and display...

  • Page 389: Display.Smux.Digits

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-76 2657a-901-01 rev. B/december 2012 the character codes described in the following table can be also be included in the text string. Display character codes character code description $n newlin...

  • Page 390: Display.Smux.Limit.Func

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-77 also see display resolution (on page 3-69) display.Smux.Limit.Func this attribute specifies the type of limit value setting displayed. Type tsp-link accessib...

  • Page 391: Display.Trigger.Clear()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-78 2657a-901-01 rev. B/december 2012 usage func = display.Smu x .Measure.Func display.Smu x .Measure.Func = func func one of the following values: • 0 or display.Measure_dcamps : selects current...

  • Page 392: Display.Trigger.Event_Id

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-79 display.Trigger.Event_id this constant is the event id of the event generated when the front-panel trig key is pressed. Type tsp-link accessible affected by ...

  • Page 393: Display.Trigger.Wait()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-80 2657a-901-01 rev. B/december 2012 display.Trigger.Wait() this function waits for the trig key on the front panel to be pressed. Type tsp-link accessible affected by where saved default value ...

  • Page 394

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-81 details after you send this function, script execution pauses until a front-panel action (for example, pressing a key or the navigation wheel , or turning th...

  • Page 395: Errorqueue.Clear()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-82 2657a-901-01 rev. B/december 2012 errorqueue.Clear() this function clears all entries out of the error queue. Type tsp-link accessible affected by where saved default value function yes usage...

  • Page 396

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-83 usage errorcode , message , severity , errornode = errorqueue.Next() errorcode the error code number for the entry message the message that describes the err...

  • Page 397: Eventlog.All()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-84 2657a-901-01 rev. B/december 2012 eventlog.All() this function returns all entries from the event log as a single string and removes them from the event log. Type tsp-link accessible affected...

  • Page 398: Eventlog.Count

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-85 also see eventlog.All() (on page 7-84) eventlog.Count (on page 7-85) eventlog.Enable (on page 7-85) eventlog.Next() (on page 7-86) eventlog.Overwritemethod (...

  • Page 399: Eventlog.Next()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-86 2657a-901-01 rev. B/december 2012 example print(eventlog.Enable) eventlog.Enable = eventlog.Disable print(eventlog.Enable) displays the present status of the model 2657a event log. Output: 1....

  • Page 400: Eventlog.Overwritemethod

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-87 eventlog.Overwritemethod this attribute controls how the event log processes events if the event log is full. Type tsp-link accessible affected by where save...

  • Page 401: Filevar:close()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-88 2657a-901-01 rev. B/december 2012 filevar:close() this function closes the file that is represented by the filevar variable. Type tsp-link accessible affected by where saved default value fun...

  • Page 402: Filevar:read()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-89 filevar:read() this function reads data from a file. Type tsp-link accessible affected by where saved default value function no usage data1 = filevar :read()...

  • Page 403: Filevar:seek()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-90 2657a-901-01 rev. B/december 2012 filevar:seek() this function sets and gets a file's current position. Type tsp-link accessible affected by where saved default value function no usage positi...

  • Page 404: Format.Asciiprecision

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-91 details this function may buffer data until a flush ( filevar :flush() or io.Flush() ) or close ( filevar :close() or io.Close() ) operation is performed. Al...

  • Page 405: Format.Byteorder

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-92 2657a-901-01 rev. B/december 2012 format.Byteorder this attribute sets the binary byte order for the data that is printed using the printnumber() and printbuffer() functions. Type tsp-link ac...

  • Page 406: Format.Data

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-93 format.Data this attribute sets the data format for data that is printed using the printnumber() and printbuffer() functions. Type tsp-link accessible affect...

  • Page 407: Fs.Chdir()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-94 2657a-901-01 rev. B/december 2012 fs.Chdir() this function sets the current working directory. Type tsp-link accessible affected by where saved default value function yes usage workingdirecto...

  • Page 408: Fs.Is_File()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-95 usage status = fs.Is_dir( path ) status whether or not the given path is a directory ( true or false ) path the path of the file system entry to test details...

  • Page 409: Fs.Readdir()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-96 2657a-901-01 rev. B/december 2012 fs.Readdir() this function returns a list of the file system entries in the directory. Type tsp-link accessible affected by where saved default value functio...

  • Page 410: Gettimezone()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-97 gettimezone() this function retrieves the local time zone. Type tsp-link accessible affected by where saved default value function yes usage timezone = getti...

  • Page 411: Gm_Vsweep()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-98 2657a-901-01 rev. B/december 2012 details output data includes transconductance values, reading buffer with measured voltages, reading buffer with measured voltages and currents. If all param...

  • Page 412: Gpib.Address

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-99 example gm_array = gm_vsweep(smua, 0, 10, 5) gm_array, ibuf = gm_vsweep(smua, 0, 10, 5) gm_array, ibuf, vbuf = gm_vsweep(smua, 0, 10, 5) smu a returns gm val...

  • Page 413: I_Leakage_Measure()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-100 2657a-901-01 rev. B/december 2012 i_leakage_measure() this kihighc factory script function performs a current leakage measurement after stepping the output voltage. Type tsp-link accessible ...

  • Page 414: I_Leakage_Threshold()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-101 i_leakage_threshold() this kihighc factory script function measures the current and compares it to a threshold. Type tsp-link accessible affected by where s...

  • Page 415: Initiatepulsetest()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-102 2657a-901-01 rev. B/december 2012 example smua.Source.Highc = smua.Enable smua.Source.Levelv = 500 smua.Source.Output = smua.Output_on delay(1) pass = i_leakage_threshold(smua, 0, 20e-3, 500...

  • Page 416: Io.Close()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-103 details this function only initiates configured pulse trains assigned to a valid tag . Configure the pulse before initiating it using one of the configurepu...

  • Page 417: Io.Flush()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-104 2657a-901-01 rev. B/december 2012 details if a file is not specified, the default output file closes. Only io.Close() , used without specifying a parameter, can be accessed from a remote nod...

  • Page 418: Io.Open()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-105 usage filevar = io.Input() filevar = io.Input( newfile ) filevar the descriptor of the input file or an error message (if the function fails) newfile a stri...

  • Page 419: Io.Output()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-106 2657a-901-01 rev. B/december 2012 io.Output() this function assigns a previously opened file or opens a new file as the default output file. Type tsp-link accessible affected by where saved ...

  • Page 420: Io.Type()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-107 details the format parameters may be any of the following: format parameter description "*n" returns a number "*a" returns the whole file, starting at the p...

  • Page 421: Lan.Applysettings()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-108 2657a-901-01 rev. B/december 2012 usage io.Write() io.Write( data1 ) io.Write( data1, data2 ) io.Write( data1, ..., datan ) data1 the data to be written data2 the data to be written datan th...

  • Page 422: Lan.Autoconnect

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-109 lan.Autoconnect this attribute is used to enable or disable link monitoring. Type tsp-link accessible affected by where saved default value attribute (rw) y...

  • Page 423: Lan.Config.Dns.Domain

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-110 2657a-901-01 rev. B/december 2012 example dnsaddress = "164.109.48.173" lan.Config.Dns.Address[1] = dnsaddress configure dns address 1 to "164.109.48.173" also see lan.Config.Dns.Domain (on ...

  • Page 424: Lan.Config.Dns.Hostname

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-111 usage state = lan.Config.Dns.Dynamic lan.Config.Dns.Dynamic = state state the dynamic dns registration state. It may be one of the following values: 1 or la...

  • Page 425: Lan.Config.Dns.Verify

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-112 2657a-901-01 rev. B/december 2012 example print(lan.Config.Dns.Hostname) outputs the present dynamic dns host name. Also see lan.Config.Dns.Dynamic (on page 7-110) lan.Restoredefaults() (on ...

  • Page 426: Lan.Config.Gateway

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-113 details this attribute does not indicate the actual setting currently in effect. Use the lan.Status.Duplex attribute to determine the present operating stat...

  • Page 427: Lan.Config.Method

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-114 2657a-901-01 rev. B/december 2012 usage ipaddress = lan.Config.Ipaddress lan.Config.Ipaddress = ipaddress ipaddress lan ip address; must be a string specifying the ip address in dotted decim...

  • Page 428: Lan.Config.Speed

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-115 lan.Config.Speed this attribute contains the lan speed used when restarting in manual configuration mode. Type tsp-link accessible affected by where saved d...

  • Page 429: Lan.Linktimeout

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-116 2657a-901-01 rev. B/december 2012 also see lan.Restoredefaults() (on page 7-118) lan.Status.Subnetmask (on page 7-124) lan.Linktimeout this attribute contains the lan link timeout period. Ty...

  • Page 430: Lan.Lxidomain

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-117 lan.Lxidomain this attribute contains the lxi domain. Type tsp-link accessible affected by where saved default value attribute (rw) yes lan restore defaults...

  • Page 431: Lan.Reset()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-118 2657a-901-01 rev. B/december 2012 lan.Reset() this function resets the lan interface. Type tsp-link accessible affected by where saved default value function yes usage lan.Reset() details th...

  • Page 432: Lan.Status.Dns.Address[N]

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-119 this command is run when lan.Reset() is sent. Example lan.Restoredefaults() restores the lan defaults. Also see lan.Reset() (on page 7-118) localnode.Passwo...

  • Page 433: Lan.Status.Duplex

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-120 2657a-901-01 rev. B/december 2012 details a fully qualified domain name (fqdn), sometimes referred to as an absolute domain name, is a domain name that specifies its exact location in the tr...

  • Page 434: Lan.Status.Ipaddress

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-121 example print(lan.Status.Gateway) outputs the gateway address, such as: 192.168.0.1 also see lan.Config.Gateway (on page 7-113) lan.Status.Ipaddress this at...

  • Page 435: Lan.Status.Port.Dst

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-122 2657a-901-01 rev. B/december 2012 also see none lan.Status.Port.Dst this attribute contains the lan dead socket termination port number. Type tsp-link accessible affected by where saved defa...

  • Page 436: Lan.Status.Port.Telnet

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-123 lan.Status.Port.Telnet this attribute contains the lan telnet connection port number. Type tsp-link accessible affected by where saved default value attribu...

  • Page 437: Lan.Status.Speed

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-124 2657a-901-01 rev. B/december 2012 lan.Status.Speed this attribute contains the lan speed. Type tsp-link accessible affected by where saved default value attribute (r) yes not applicable not ...

  • Page 438: Lan.Timedwait

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-125 lan.Timedwait this attribute contains the lan timed-wait state interval. Type tsp-link accessible affected by where saved default value attribute (rw) yes l...

  • Page 439: Lan.Trigger[N].Clear()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-126 2657a-901-01 rev. B/december 2012 also see lan.Lxidomain (on page 7-117) lan.Trigger[n].Clear() (on page 7-126) lan.Trigger[n].Mode (on page 7-130) lan.Trigger[n].Overrun (on page 7-131) lan...

  • Page 440: Lan.Trigger[N].Connect()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-127 lan.Trigger[n].Connect() this function prepares the event generator for outgoing trigger events. Type tsp-link accessible affected by where saved default va...

  • Page 441: Lan.Trigger[N].Disconnect()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-128 2657a-901-01 rev. B/december 2012 details this read-only attribute is set to true when the lan trigger is connected and ready to send trigger events following a successful lan.Trigger[ n ].C...

  • Page 442: Lan.Trigger[N].Ipaddress

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-129 details set the stimulus of any trigger event detector to the value of this constant to have it respond to incoming lan trigger packets. Example digio.Trigg...

  • Page 443: Lan.Trigger[N].Mode

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-130 2657a-901-01 rev. B/december 2012 lan.Trigger[n].Mode this attribute sets the trigger operation and detection mode. Type tsp-link accessible affected by where saved default value attribute (...

  • Page 444: Lan.Trigger[N].Overrun

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-131 lan.Trigger[n].Overrun this attribute contains the event detector's overrun status. Type tsp-link accessible affected by where saved default value attribute...

  • Page 445: Lan.Trigger[N].Pseudostate

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-132 2657a-901-01 rev. B/december 2012 details the lan trigger listens for trigger messages on all supported protocols, but uses the designated protocol for sending outgoing messages. After chang...

  • Page 446

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-133 usage triggerstimulus = lan.Trigger[ n ].Stimulus lan.Trigger[ n ].Stimulus = triggerstimulus triggerstimulus the lan event identifier used to trigger the e...

  • Page 447: Lan.Trigger[N].Wait()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-134 2657a-901-01 rev. B/december 2012 also see lan.Trigger[n].Assert() (on page 7-125) lan.Trigger[n].Clear() (on page 7-126) lan.Trigger[n].Connect() (on page 7-127) lan.Trigger[n].Overrun (on ...

  • Page 448: Localnode.Linefreq

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-135 details this attribute stores a string that contains a description of the instrument. This value appears on instrument's lxi welcome page. The value of this...

  • Page 449: Localnode.Model

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-136 2657a-901-01 rev. B/december 2012 localnode.Model this attribute stores the model number. Type tsp-link accessible affected by where saved default value attribute (r) yes not applicable not ...

  • Page 450: Localnode.Passwordmode

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-137 example localnode.Password = "n3wpa55w0rd" changes the remote interface password to n3wpa55w0rd. Also see lan.Reset() (on page 7-118) localnode.Passwordmode...

  • Page 451: Localnode.Prompts4882

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-138 2657a-901-01 rev. B/december 2012 details the command messages do not generate prompts. The instrument generates prompts in response to command messages. When the prompting mode is enabled (...

  • Page 452: Localnode.Reset()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-139 details when set to 1 , the ieee std 488.2 common commands generate prompts if prompting is enabled with the localnode.Prompts attribute. If set to 1 , limi...

  • Page 453: Localnode.Serialno

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-140 2657a-901-01 rev. B/december 2012 usage revision = localnode.Revision revision firmware revision level details this attribute indicates the revision number of the firmware that is presently ...

  • Page 454: Localnode.Showerrors

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-141 localnode.Showerrors this attribute sets whether or not the instrument automatically sends generated errors. Type tsp-link accessible affected by where save...

  • Page 455: Makesetter()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-142 2657a-901-01 rev. B/december 2012 details this function is useful for aliasing attributes to improve execution speed. Calling the function created with makegetter() executes faster than acce...

  • Page 456: Meminfo()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-143 meminfo() this function returns the present amount of available memory and the total amount of memory in the instrument. Type tsp-link accessible affected b...

  • Page 457: Node[N].Execute()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-144 2657a-901-01 rev. B/december 2012 node[n].Execute() this function starts test scripts from a remote node. Type tsp-link accessible affected by where saved default value function yes (see det...

  • Page 458: Node[N].Setglobal()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-145 details this function retrieves the value of a global variable from the run-time environment of this node. Do not use this command to retrieve the value of ...

  • Page 459: Opc()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-146 2657a-901-01 rev. B/december 2012 opc() this function sets the operation complete status bit when all overlapped commands are completed. Type tsp-link accessible affected by where saved defa...

  • Page 460: Os.Rename()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-147 os.Rename() this function renames an existing file or directory. Type tsp-link accessible affected by where saved default value function yes usage success ,...

  • Page 461: Print()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-148 2657a-901-01 rev. B/december 2012 details the timespec is a table using the fields listed in the table below: year the year (1970 or later) month the month (1 to 12) day the day (1 to 31) ho...

  • Page 462: Printbuffer()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-149 example 1 x = 10 print(x) example of an output response message: 1.00000e+01 note that your output might be different if you set your ascii precision settin...

  • Page 463: Printnumber()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-150 2657a-901-01 rev. B/december 2012 example format.Data = format.Ascii format.Asciiprecision = 6 printbuffer(1, rb1.N, rb1) this assumes that rb1 is a valid reading buffer in the run-time envi...

  • Page 464: Pulseimeasurev()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-151 example format.Asciiprecision = 10 x = 2.54 printnumber(x) format.Asciiprecision = 3 printnumber(x, 2.54321, 3.1) configure the ascii precision to 10 and se...

  • Page 465: Pulsevmeasurei()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-152 2657a-901-01 rev. B/december 2012 figure 115: pulseimeasurev example pulseimeasurev(smua, 0.001, 0.01, 20e-3, 40e-3, 10) smu a outputs 1 ma and dwells for 40 ms, outputs 10 ma and dwells for...

  • Page 466: Querypulseconfig()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-153 details if any parameters are omitted or nil , the operator is prompted to enter them using the front panel. Data for pulsed current measurements, voltage l...

  • Page 467

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-154 2657a-901-01 rev. B/december 2012 details once a pulse train has been configured and assigned to a tag , it is often desirable to inspect the settings of this preconfigured pulse train. The ...

  • Page 468: Reset()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-155 example smua.Reset() smua.Source.Rangev = 500 smua.Source.Rangei = 0.1 smua.Source.Levelv = 0 smua.Measure.Rangev = 500 smua.Measure.Rangei = 0.1 smua.Measu...

  • Page 469: Savebuffer()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-156 2657a-901-01 rev. B/december 2012 details the reset() command in its simplest form resets the entire tsp-enabled system, including the controlling node and all subordinate nodes. If you want...

  • Page 470: Script.Anonymous

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-157 script.Anonymous this is a reference to the anonymous script. Type tsp-link accessible affected by where saved default value attribute (r) no see details se...

  • Page 471: Script.Delete()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-158 2657a-901-01 rev. B/december 2012 script.Delete() this function deletes a script from nonvolatile memory. Type tsp-link accessible affected by where saved default value function no usage scr...

  • Page 472: Script.Load()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-159 script.Load() this function creates a script from a specified file. Type tsp-link accessible affected by where saved default value function no usage scriptv...

  • Page 473: Script.New()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-160 2657a-901-01 rev. B/december 2012 script.New() this function creates a script. Type tsp-link accessible affected by where saved default value function no usage scriptvar = script.New( code )...

  • Page 474: Script.Newautorun()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-161 script.Newautorun() this function is identical to the script.New() function, but it creates a script with the autorun attribute set to "yes" . Type tsp-link...

  • Page 475: Script.Run()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-162 2657a-901-01 rev. B/december 2012 details this command copies the script from nonvolatile memory into the run-time environment. It also creates a global variable with the same name as the na...

  • Page 476: Script.User.Catalog()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-163 script.User.Catalog() this function returns an iterator that can be used in a for loop to iterate over all the scripts stored in nonvolatile memory. Type ts...

  • Page 477: Scriptvar.List()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-164 2657a-901-01 rev. B/december 2012 make sure to save the script in nonvolatile memory after setting the autorun attribute so that the instrument will retain the setting. Example test5.Autorun...

  • Page 478: Scriptvar.Name

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-165 scriptvar.Name this attribute contains the name of a script in the run-time environment. Type tsp-link accessible affected by where saved default value attr...

  • Page 479: Scriptvar.Run()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-166 2657a-901-01 rev. B/december 2012 scriptvar.Run() this function runs a script. Type tsp-link accessible affected by where saved default value function no usage scriptvar .Run() scriptvar () ...

  • Page 480: Scriptvar.Save()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-167 scriptvar.Save() this function saves the script to nonvolatile memory or to a usb flash drive. Type tsp-link accessible affected by where saved default valu...

  • Page 481: Serial.Baud

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-168 2657a-901-01 rev. B/december 2012 details the loadscript or loadandrunscript and endscript keywords are not included in the source code. The body of the script is a single string with lines ...

  • Page 482: Serial.Databits

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-169 serial.Databits this attribute configures character width (data bits) for the rs-232 port. Type tsp-link accessible affected by where saved default value at...

  • Page 483: Serial.Parity

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-170 2657a-901-01 rev. B/december 2012 details a new flow control setting takes effect when the command to change it is processed. Allow ample time for the command to be processed before attempti...

  • Page 484: Serial.Read()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-171 also see rs-232 interface operation (on page 2-88) serial.Baud (on page 7-168) serial.Databits (on page 7-169) serial.Flowcontrol (on page 7-169) serial.Rea...

  • Page 485: Settime()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-172 2657a-901-01 rev. B/december 2012 details this function writes the specified string to the serial port, where it can be read by connected equipment (for example, a component handler). No ter...

  • Page 486: Settimezone()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-173 settimezone() this function sets the local time zone. Type tsp-link accessible affected by where saved default value function no usage settimezone( offset )...

  • Page 487: Setup.Poweron

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-174 2657a-901-01 rev. B/december 2012 example settimezone("8", "1", "3.3.0/02", "11.2.0/02") settimezone(offset) sets offset to equal +8 hours, +1 hour for dst, starts on mar 14 at 2:00 a.M, end...

  • Page 488: Setup.Recall()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-175 setup.Recall() this function recalls settings from a saved setup. Type tsp-link accessible affected by where saved default value function yes usage setup.Re...

  • Page 489: Smux.Abort()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-176 2657a-901-01 rev. B/december 2012 details when the id parameter is an integer ( n ), it is interpreted as the setup number to save to the instrument's nonvolatile memory. When you save to a ...

  • Page 490: Smux.Buffer.Getstats()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-177 smux.Buffer.Getstats() this function returns a specified reading buffer's statistics. Type tsp-link accessible affected by where saved default value functio...

  • Page 491: Smux.Cal.Adjustdate

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-178 2657a-901-01 rev. B/december 2012 also see smux.Buffer.Recalculatestats() (on page 7-178) smux.Buffer.Recalculatestats() this function recalculates the specified reading buffer's statistics....

  • Page 492: Smux.Cal.Date

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-179 details this attribute stores the adjustment date associated with the active calibration set. The adjustment date can be read at any time, but can only be a...

  • Page 493: Smux.Cal.Due

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-180 2657a-901-01 rev. B/december 2012 details this attribute stores the calibration date that is associated with the active calibration set. The calibration date can be read at any time but can ...

  • Page 494: Smux.Cal.Fastadc()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-181 example smua.Cal.Due = os.Time() + 365 * 24 * 60 * 60 sets the smu channel a calibration due date equal to one year from the current time set on the instrum...

  • Page 495: Smux.Cal.Ovp()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-182 2657a-901-01 rev. B/december 2012 details this function disables functions that can change calibration settings. Before you can lock calibration, the calibration constants must be written to...

  • Page 496: Smux.Cal.Polarity

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-183 usage smu x .Cal.Password = newpassword x smu channel (for example, smua.Cal.Password applies to smu channel a) newpassword the new password (string) detail...

  • Page 497: Smux.Cal.Restore()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-184 2657a-901-01 rev. B/december 2012 example smua.Cal.Polarity = smua.Cal_positive selects positive calibration constants for all subsequent measurements on smu channel a. Also see adjustment (...

  • Page 498: Smux.Cal.Save()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-185 smux.Cal.Save() this function stores the active calibration constants to nonvolatile memory. Type tsp-link accessible affected by where saved default value ...

  • Page 499: Smux.Cal.Unlock()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-186 2657a-901-01 rev. B/december 2012 usage calstate = smu x .Cal.State calstate the present calibration state; when reading this attribute, calstate has one of the following values: 0 or smu x ...

  • Page 500: Smux.Contact.Calibratehi()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-187 also see adjustment (on page b-14) smux.Cal.Lock() (on page 7-181) smux.Cal.Password (on page 7-182) smux.Cal.State (on page 7-185) smux.Contact.Calibratehi...

  • Page 501: Smux.Contact.Calibratelo()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-188 2657a-901-01 rev. B/december 2012 also see adjustment (on page b-14) smux.Cal.Restore() (on page 7-184) smux.Cal.Save() (on page 7-185) smux.Cal.Unlock() (on page 7-186) smux.Contact.Calibra...

  • Page 502: Smux.Contact.Check()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-189 example -- short sense lo and lo terminals -- short sense hi and hi terminals -- allow readings to settle, then get measurements r0_hi, r0_lo = smua.Contact...

  • Page 503: Smux.Contact.R()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-190 2657a-901-01 rev. B/december 2012 details this function returns true if the contact resistance is below the threshold; this function returns false if it is above the threshold. The threshold...

  • Page 504: Smux.Contact.Speed

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-191 details if you attempt to perform a contact resistance measurement when any of the following conditions exist, an error will be generated. When the output i...

  • Page 505: Smux.Contact.Threshold

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-192 2657a-901-01 rev. B/december 2012 details this setting controls the aperture of measurements made for contact check. It does not affect the smu x .Measure.Nplc aperture setting. The speed se...

  • Page 506: Smux.Makebuffer()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-193 smux.Makebuffer() this function creates a reading buffer. Type tsp-link accessible affected by where saved default value function yes usage buffervar = smu ...

  • Page 507: Smux.Measure.Autorangey

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-194 2657a-901-01 rev. B/december 2012 details when making measurements, the smu uses one of two types of analog-to-digital converters. This attribute controls which analog to converter is used. ...

  • Page 508: Smux.Measure.Autozero

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-195 also see autoranging (on page 2-73) range (on page 2-72) reset() (on page 7-155) setup.Recall() (on page 7-175) smux.Measure.Rangey (on page 7-204) smux.Res...

  • Page 509: Smux.Measure.Calibratey()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-196 2657a-901-01 rev. B/december 2012 remember that disabling automatic reference measurements may allow the instrument to gradually drift out of specification. To minimize the drift, a referenc...

  • Page 510: Smux.Measure.Count

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-197 details this function generates and activates new calibration constants for the given range. The positive and negative polarities of the instrument must be ...

  • Page 511: Smux.Measure.Delay

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-198 2657a-901-01 rev. B/december 2012 details this attribute controls the number of measurements taken any time a measurement is requested. When using a reading buffer with a measure command, th...

  • Page 512: Smux.Measure.Delayfactor

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-199 also see measure auto delay (on page 2-73) reset() (on page 7-155) smux.Measure.Count (on page 7-197) smux.Measure.Delayfactor (on page 7-199) smux.Source.D...

  • Page 513: Smux.Measure.Filter.Enable

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-200 2657a-901-01 rev. B/december 2012 usage filtercount = smu x .Measure.Filter.Count smu x .Measure.Filter.Count = filtercount filtercount the number of readings required for each filtered meas...

  • Page 514: Smux.Measure.Filter.Type

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-201 also see filters (on page 3-2) reset() (on page 7-155) setup.Recall() (on page 7-175) smux.Measure.Filter.Count (on page 7-199) smux.Measure.Filter.Type (on...

  • Page 515: Smux.Measure.Interval

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-202 2657a-901-01 rev. B/december 2012 smux.Measure.Interval this attribute sets the interval between multiple measurements. Type tsp-link accessible affected by where saved default value attribu...

  • Page 516: Smux.Measure.Nplc

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-203 details this attribute is used with autoranging to put a lower bound on the range used. Since lower ranges generally require greater settling times, setting...

  • Page 517: Smux.Measure.Overlappedy()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-204 2657a-901-01 rev. B/december 2012 smux.Measure.Overlappedy() this function starts an asynchronous (background) measurement. Type tsp-link accessible affected by where saved default value fun...

  • Page 518: Smux.Measure.Rel.Enabley

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-205 usage rangevalue = smu x .Measure.Range y smu x .Measure.Range y = rangevalue rangevalue set to the maximum expected voltage or current to be measured x sou...

  • Page 519

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-206 2657a-901-01 rev. B/december 2012 usage relenable = smu x .Measure.Rel.Enable y smu x .Measure.Rel.Enable y = relenable relenable relative measurement control. Set relenable to one of the fo...

  • Page 520: Smux.Measure.Rel.Levely

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-207 smux.Measure.Rel.Levely this attribute sets the offset value for relative measurements. Type tsp-link accessible affected by where saved default value attri...

  • Page 521: Smux.Measure.Y()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-208 2657a-901-01 rev. B/december 2012 smux.Measure.Y() this function makes one or more measurements. Type tsp-link accessible affected by where saved default value function yes usage reading = s...

  • Page 522: Smux.Measureyandstep()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-209 also see reading buffers (on page 3-6) smux.Measure.Count (on page 7-197) smux.Measure.Overlappedy() (on page 7-204) smux.Nvbuffery (on page 7-210) smux.Mea...

  • Page 523: Smux.Nvbuffery

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-210 2657a-901-01 rev. B/december 2012 also see smux.Measure.Autorangey (on page 7-194) smux.Measure.Y() (on page 7-208) smux.Source.Autorangey (on page 7-212) smux.Trigger.Source.Limity (on page...

  • Page 524: Smux.Reset()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-211 smux.Reset() this function turns off the output and resets the smu to the default settings. Type tsp-link accessible affected by where saved default value f...

  • Page 525: Smux.Sense

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-212 2657a-901-01 rev. B/december 2012 smux.Sense this attribute contains the state of the sense mode. Type tsp-link accessible affected by where saved default value attribute (rw) yes smu reset ...

  • Page 526: Smux.Source.Calibratey()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-213 usage sourceautorange = smu x .Source.Autorange y smu x .Source.Autorange y = sourceautorange sourceautorange the state of the source autorange control. Set...

  • Page 527: Smux.Source.Compliance

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-214 2657a-901-01 rev. B/december 2012 details this function generates and activates new calibration constants for the given range. The positive and negative polarities of the source must be cali...

  • Page 528: Smux.Source.Delay

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-215 details this read-only attribute contains the source compliance state ( true or false ). • true indicates that the limit function is in control of the sourc...

  • Page 529: Smux.Source.Func

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-216 2657a-901-01 rev. B/december 2012 example smua.Source.Delay = smua.Delay_auto sets the delay for smu channel a to automatic (a range-dependent delay is inserted whenever the source is change...

  • Page 530: Smux.Source.Levely

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-217 usage highc = smu x .Source.Highc smu x .Source.Highc = highc highc the state of the high-capacitance mode; set to one of the following values: 0 or smu x ....

  • Page 531: Smux.Source.Limity

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-218 2657a-901-01 rev. B/december 2012 details this attribute configures the output level of the voltage or current source. If the source is configured as a voltage source and the output is on, t...

  • Page 532: Smux.Source.Lowrangey

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-219 details use the smu x .Source.Limiti attribute to limit the current output of the voltage source. Use smu x .Source.Limitv to limit the voltage output of th...

  • Page 533: Smux.Source.Offfunc

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-220 2657a-901-01 rev. B/december 2012 also see smux.Source.Autorangey (on page 7-212) smux.Source.Offfunc this attribute sets the source function that is used (source 0 a or 0 v) when the output...

  • Page 534: Smux.Source.Offmode

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-221 usage sourcelimit = smu x .Source.Offlimit y smu x .Source.Offlimit y = sourcelimit sourcelimit set to the limit to be used when the smu is in normal output...

  • Page 535: Smux.Source.Output

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-222 2657a-901-01 rev. B/december 2012 details reading this attribute gives the output-off mode of the source. Setting this attribute configures the smu output- off mode. The default sourceoffmod...

  • Page 536: Smux.Source.Protectv

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-223 example smua.Source.Output = smua.Output_on turns on smu channel a source output. Also see dut test connections (on page 2-41) smux.Source.Func (on page 7-2...

  • Page 537: Smux.Source.Rangey

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-224 2657a-901-01 rev. B/december 2012 smux.Source.Rangey this attribute contains the source range. Type tsp-link accessible affected by where saved default value attribute (rw) yes smu reset ins...

  • Page 538: Smux.Source.Sink

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-225 usage settleoption = smu x .Source.Settling smu x .Source.Settling = settleoption settleoption set to the source settling mode. Set to one of the following ...

  • Page 539: Smux.Trigger.Arm.Count

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-226 2657a-901-01 rev. B/december 2012 example smua.Source.Sink = smua.Enable enables sink mode for smu channel a. Also see source or sink (on page 4-4) smux.Trigger.Arm.Count this attribute sets...

  • Page 540: Smux.Trigger.Arm.Stimulus

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-227 details the smu will automatically clear all the event detectors when the smu x .Trigger.Initiate() function is executed. This function should be called aft...

  • Page 541: Smux.Trigger.Armed_Event_Id

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-228 2657a-901-01 rev. B/december 2012 details set this attribute to the event id of any trigger event generator to wait for that event. Set this attribute to zero to bypass waiting for events at...

  • Page 542: Smux.Trigger.Autoclear

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-229 usage eventid = smu x .Trigger.Armed_event_id eventid the armed event number x source-measure unit (smu) channel (for example, smua.Trigger.Armed_event_id a...

  • Page 543: Smux.Trigger.Count

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-230 2657a-901-01 rev. B/december 2012 smux.Trigger.Count this attribute sets the trigger count in the trigger model. Type tsp-link accessible affected by where saved default value attribute (rw)...

  • Page 544: Smux.Trigger.Endpulse.Set()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-231 example smua.Trigger.Endpulse.Action = smua.Source_idle smua.Trigger.Endpulse.Stimulus = trigger.Timer[1].Event_id configure the end pulse action to achieve...

  • Page 545

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-232 2657a-901-01 rev. B/december 2012 details set this attribute to the event id of any trigger event generator to wait for that event. To bypass waiting for an event, set this attribute's value...

  • Page 546: Smux.Trigger.Endsweep.Action

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-233 smux.Trigger.Endsweep.Action this attribute sets the action of the source at the end of a sweep. Type tsp-link accessible affected by where saved default va...

  • Page 547: Smux.Trigger.Initiate()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-234 2657a-901-01 rev. B/december 2012 example trigger.Timer[1].Stimulus = smua.Trigger.Idle_event_id trigger timer 1 when the smu returns to the idle layer. Also see triggering (on page 3-31) sm...

  • Page 548: Smux.Trigger.Measure.Action

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-235 smux.Trigger.Measure.Action this attribute controls measurement actions during a sweep. Type tsp-link accessible affected by where saved default value attri...

  • Page 549

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-236 2657a-901-01 rev. B/december 2012 details this function is useful whenever you want the smu to continue operation without waiting for a programmed trigger event. When called, this function i...

  • Page 550

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-237 details set this attribute to the event id of any trigger event generator to wait for that event. When set, the smu waits for the event at the measurement e...

  • Page 551: Smux.Trigger.Measure.Y()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-238 2657a-901-01 rev. B/december 2012 smux.Trigger.Measure.Y() this function configures the measurements that are to be made in a subsequent sweep. Type tsp-link accessible affected by where sav...

  • Page 552

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-239 usage eventid = smu x .Trigger.Measure_complete_event_id eventid the measurement complete event number x source-measure unit (smu) channel (for example, smu...

  • Page 553: Smux.Trigger.Source.Action

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-240 2657a-901-01 rev. B/december 2012 smux.Trigger.Source.Action this attribute enables or disables sweeping the source (on or off). Type tsp-link accessible affected by where saved default valu...

  • Page 554: Smux.Trigger.Source.Limity

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-241 smux.Trigger.Source.Limity this attribute sets the sweep source limit. Type tsp-link accessible affected by where saved default value attribute (rw) yes smu...

  • Page 555

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-242 2657a-901-01 rev. B/december 2012 smux.Trigger.Source.Lineary() this function configures a linear source sweep. Type tsp-link accessible affected by where saved default value function yes us...

  • Page 556: Smux.Trigger.Source.Listy()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-243 smux.Trigger.Source.Listy() this function configures an array-based source sweep. Type tsp-link accessible affected by where saved default value function ye...

  • Page 557: Smux.Trigger.Source.Logy()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-244 2657a-901-01 rev. B/december 2012 smux.Trigger.Source.Logy() this function configures an exponential (geometric) source sweep. Type tsp-link accessible affected by where saved default value ...

  • Page 558: Smux.Trigger.Source.Set()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-245 also see smux.Trigger.Source.Action (on page 7-240) smux.Trigger.Source.Lineary() (on page 7-242) smux.Trigger.Source.Listy() (on page 7-243) sweep operatio...

  • Page 559

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-246 2657a-901-01 rev. B/december 2012 details set this attribute to the event id of any trigger event generator to wait for that event. When set, the smu waits for the event at the source event ...

  • Page 560

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-247 usage eventid = smu x .Trigger.Source_complete_event_id eventid the source action complete event number x source-measure unit (smu) channel (for example, sm...

  • Page 561: Status.Condition

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-248 2657a-901-01 rev. B/december 2012 also see triggering (on page 3-31) status.Condition this attribute stores the status byte condition register. Type tsp-link accessible affected by where sav...

  • Page 562

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-249 the individual bits of this register have the following meanings: bit value description b0 status.Measurement_summary_bit status.Msb set summary bit indicat...

  • Page 563: Status.Measurement.*

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-250 2657a-901-01 rev. B/december 2012 also see status byte and service request (srq) (on page e-15) status.Measurement.* this attribute contains the measurement event register set. Type tsp-link...

  • Page 564

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-251 bit value description b0 status.Measurement.Voltage_limit status.Measurement.Vlmt set bit is a summary of the status.Measurement.Voltage_limit register. Bit...

  • Page 565

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-252 2657a-901-01 rev. B/december 2012 status.Measurement.Buffer_available.* this attribute contains the measurement event buffer available summary register set. Type tsp-link accessible affected...

  • Page 566

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-253 also see measurement event registers (on page e-8) status.Measurement.Current_limit.* this attribute contains the measurement event current limit summary re...

  • Page 567

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-254 2657a-901-01 rev. B/december 2012 example status.Measurement.Current_limit.Enable = status.Measurement.Current_limit.Smua sets the smua bit of the measurement event current limit summary ena...

  • Page 568

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-255 bit value description b0 not used not applicable. B1 status.Measurement.Instrument.Smua set bit indicates one or more enabled bits of the measurement event ...

  • Page 569

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-256 2657a-901-01 rev. B/december 2012 details these attributes are used to read or write to the measurement event smu x summary registers. Reading a status register returns a value. The binary e...

  • Page 570

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-257 bit b7 b6 b5 b4 b3 b2 b1 b0 binary value 0/1 0/1 0/1 0/1 0/1 0/1 0/1 0/1 decimal 128 64 32 16 8 4 2 1 weights (2 7 ) (2 6 ) (2 5 ) (2 4 ) (2 3 ) (2 2 ) (2 1...

  • Page 571

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-258 2657a-901-01 rev. B/december 2012 usage measurementregister = status.Measurement.Overvoltage.Condition measurementregister = status.Measurement.Overvoltage.Enable measurementregister = statu...

  • Page 572

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-259 status.Measurement.Reading_overflow.* this attribute contains the measurement event reading overflow summary register set. Type tsp-link accessible affected...

  • Page 573

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-260 2657a-901-01 rev. B/december 2012 also see measurement event registers (on page e-8) status.Measurement.Sink_limit.* this attribute contains the measurement sink limit summary register set. ...

  • Page 574

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-261 example status.Measurement.Sink_limit.Enable = status.Measurement.Sink_limit.Smua sets the smu a bit of the measurement sink limit summary enable register u...

  • Page 575: Status.Node_Enable

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-262 2657a-901-01 rev. B/december 2012 bit value description b0 not used not applicable. B1 status.Measurement.Voltage_limit.Smua set bit indicates that the voltage limit was exceeded. Bit b1 dec...

  • Page 576

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-263 for information about .Condition, .Enable, .Event, .Ntr, and .Ptr registers, refer to status register set contents (on page e-1) and enable and transition r...

  • Page 577: Status.Node_Event

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-264 2657a-901-01 rev. B/december 2012 status.Node_event this attribute stores the status node event register. Type tsp-link accessible affected by where saved default value attribute (r) yes not...

  • Page 578: Status.Operation.*

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-265 in addition to the above constants, nodeeventregister can be set to the decimal equivalent of the bits set. When more than one bit of the register is set, n...

  • Page 579

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-266 2657a-901-01 rev. B/december 2012 details these attributes read or write the operation status registers. Reading a status register returns a value. The binary equivalent of the returned valu...

  • Page 580

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-267 bit b7 b6 b5 b4 b3 b2 b1 b0 binary value 0/1 0/1 0/1 0/1 0/1 0/1 0/1 0/1 decimal 128 64 32 16 8 4 2 1 weights (2 7 ) (2 6 ) (2 5 ) (2 4 ) (2 3 ) (2 2 ) (2 1...

  • Page 581

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-268 2657a-901-01 rev. B/december 2012 details these attributes are used to read or write to the operation status calibration summary registers. Reading a status register returns a value. The bin...

  • Page 582

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-269 details these attributes are used to read or write to the operation status instrument summary registers. Reading a status register returns a value. The bina...

  • Page 583

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-270 2657a-901-01 rev. B/december 2012 bit b7 b6 b5 b4 b3 b2 b1 b0 binary value 0/1 0/1 0/1 0/1 0/1 0/1 0/1 0/1 decimal 128 64 32 16 8 4 2 1 weights (2 7 ) (2 6 ) (2 5 ) (2 4 ) (2 3 ) (2 2 ) (2 1...

  • Page 584

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-271 usage operationregister = status.Operation.Instrument.Digio.Condition operationregister = status.Operation.Instrument.Digio.Enable operationregister = statu...

  • Page 585

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-272 2657a-901-01 rev. B/december 2012 status.Operation.Instrument.Digio.Trigger_overrun.* this attribute contains the operation status digital i/o overrun register set. Type tsp-link accessible ...

  • Page 586

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-273 a set bit indicates that the specified digital i/o line generated an action overrun when it was triggered to generate an output trigger. For information abo...

  • Page 587

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-274 2657a-901-01 rev. B/december 2012 status.Operation.Instrument.Lan.* this attribute contains the operation status lan summary register set. Type tsp-link accessible affected by where saved de...

  • Page 588

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-275 for information about .Condition, .Enable, .Event, .Ntr, and .Ptr registers, refer to status register set contents (on page e-1) and enable and transition r...

  • Page 589

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-276 2657a-901-01 rev. B/december 2012 status.Operation.Instrument.Lan.Trigger_overrun.* this attribute contains the operation status lan trigger overrun register set. Type tsp-link accessible af...

  • Page 590

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-277 a set bit indicates that the specified lan trigger generated an action overrun when triggered to generate a trigger packet. For information about .Condition...

  • Page 591

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-278 2657a-901-01 rev. B/december 2012 status.Operation.Instrument.Smux.* this attribute contains the operation status smu x summary register set. Type tsp-link accessible affected by where saved...

  • Page 592

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-279 bit value description b0 status.Operation.Instrument.Smu x .Calibrating status.Operation.Instrument.Smu x .Cal set bit indicates that smu x is unlocked for ...

  • Page 593

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-280 2657a-901-01 rev. B/december 2012 status.Operation.Instrument.Smux.Trigger_overrrun.* this attribute contains the operation status smu x trigger overrun register set. Type tsp-link accessibl...

  • Page 594

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-281 bit value description b0 not used not applicable. B1 status.Operation.Instrument.Smu x .Trigger_overrun.Arm set bit indicates that the arm event detector of...

  • Page 595

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-282 2657a-901-01 rev. B/december 2012 status.Operation.Instrument.Trigger_blender.* this attribute contains the operation status trigger blender summary register set. Type tsp-link accessible af...

  • Page 596

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-283 in addition to the above constants, operationregister can be set to the numeric equivalent of the bit to set. For example, to set bit b10, set operationregi...

  • Page 597

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-284 2657a-901-01 rev. B/december 2012 details these attributes are used to read or write to the operation status trigger blender overrun registers. Reading a status register returns a value. The...

  • Page 598

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-285 bit b15 b14 b13 b12 b11 b10 b9 b8 binary value 0/1 0/1 0/1 0/1 0/1 0/1 0/1 0/1 decimal 32,768 16,384 8,192 4,096 2,048 1,024 512 256 weights (2 15 ) (2 14 )...

  • Page 599

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-286 2657a-901-01 rev. B/december 2012 bit value description b0-b9 not used not applicable b10 status.Operation.Instrument.Trigger_timer.Trigger_overrun status.Operation.Instrument.Trigger_timer....

  • Page 600

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-287 status.Operation.Instrument.Trigger_timer.Trigger_overrun.* this attribute contains the operation status trigger timer overrun register set. Type tsp-link a...

  • Page 601

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-288 2657a-901-01 rev. B/december 2012 a set bit indicates the specified timer generated an action overrun because it was still processing a delay from a previous trigger when a new trigger was r...

  • Page 602

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-289 also see operation status registers (on page e-9) status.Operation.Instrument.Trigger_timer.* (on page 7-285) status.Operation.Instrument.Tsplink.* this att...

  • Page 603

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-290 2657a-901-01 rev. B/december 2012 in addition to the above constants, operationregister can be set to the numeric equivalent of the bit to set. For example, to set bit b10, set operationregi...

  • Page 604

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-291 a set bit indicates that the specified line generated an action overrun when triggered to generate an output trigger. For information about .Condition, .Ena...

  • Page 605: Status.Operation.Measuring.*

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-292 2657a-901-01 rev. B/december 2012 status.Operation.Measuring.* this attribute contains the operation status measuring summary register set. Type tsp-link accessible affected by where saved d...

  • Page 606: Status.Operation.Remote.*

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-293 status.Operation.Remote.* this attribute contains the operation status remote summary register set. Type tsp-link accessible affected by where saved default...

  • Page 607: Status.Operation.Sweeping.*

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-294 2657a-901-01 rev. B/december 2012 as an example, to set bit b1 of the operation status remote summary enable register, set status.Operation.Remote.Enable = status.Operation.Remote.Cav . In a...

  • Page 608

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-295 bit value description b0 not used not applicable. B1 status.Operation.Sweeping.Smua set bit indicates that smu a is sweeping. Bit b1 decimal value: 2 binary...

  • Page 609

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-296 2657a-901-01 rev. B/december 2012 b15 b14 b13 b12 b11 b10 b9 b8 b7 b6 b5 b4 b3 b2 b1 b0 ** > > > > > > > > > > > > > > * 0 0 0 0 0 1 0 0 0 0 0 0 0 0 1 0 * least significant bit ** most signi...

  • Page 610: Status.Operation.User.*

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-297 bit b7 b6 b5 b4 b3 b2 b1 b0 binary value 0/1 0/1 0/1 0/1 0/1 0/1 0/1 0/1 decimal 128 64 32 16 8 4 2 1 weights (2 7 ) (2 6 ) (2 5 ) (2 4 ) (2 3 ) (2 2 ) (2 1...

  • Page 611

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-298 2657a-901-01 rev. B/december 2012 details these attributes are used to read or write to the operation status user registers. Reading a status register returns a value. The binary equivalent ...

  • Page 612: Status.Questionable.*

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-299 bit b7 b6 b5 b4 b3 b2 b1 b0 binary value 0/1 0/1 0/1 0/1 0/1 0/1 0/1 0/1 decimal 128 64 32 16 8 4 2 1 weights (2 7 ) (2 6 ) (2 5 ) (2 4 ) (2 3 ) (2 2 ) (2 1...

  • Page 613

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-300 2657a-901-01 rev. B/december 2012 details these attributes are used to read or write to the questionable status registers. Reading a status register returns a value. In the binary equivalent...

  • Page 614

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-301 status.Questionable.Calibration.* this attribute contains the questionable status calibration summary register set. Type tsp-link accessible affected by whe...

  • Page 615

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-302 2657a-901-01 rev. B/december 2012 also see questionable status registers (on page e-13) status.Questionable.* (on page 7-299) status.Questionable.Instrument.* this attribute contains the que...

  • Page 616

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-303 also see questionable status registers (on page e-13) status.Questionable.* (on page 7-299) status.Questionable.Instrument.Smux.* this attribute contains th...

  • Page 617

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-304 2657a-901-01 rev. B/december 2012 for information about .Condition, .Enable, .Event, .Ntr, and .Ptr registers, refer to status register set contents (on page e-1) and enable and transition r...

  • Page 618

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-305 status.Questionable.Over_temperature.* this attribute contains the questionable status over temperature summary register set. Type tsp-link accessible affec...

  • Page 619

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-306 2657a-901-01 rev. B/december 2012 status.Questionable.Unstable_output.* this attribute contains the questionable status unstable output summary register set. Type tsp-link accessible affecte...

  • Page 620: Status.Request_Enable

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-307 also see questionable status registers (on page e-13) status.Questionable.* (on page 7-299) status.Request_enable this attribute stores the service request ...

  • Page 621

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-308 2657a-901-01 rev. B/december 2012 for information about .Condition, .Enable, .Event, .Ntr, and .Ptr registers, refer to status register set contents (on page e-1) and enable and transition r...

  • Page 622: Status.Request_Event

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-309 status.Request_event this attribute stores the service request (srq) event register. Type tsp-link accessible affected by where saved default value attribut...

  • Page 623

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-310 2657a-901-01 rev. B/december 2012 for information about .Condition, .Enable, .Event, .Ntr, and .Ptr registers, refer to status register set contents (on page e-1) and enable and transition r...

  • Page 624: Status.Reset()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-311 status.Reset() this function resets all bits in the status model. Type tsp-link accessible affected by where saved default value function yes usage status.R...

  • Page 625

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-312 2657a-901-01 rev. B/december 2012 details these attributes are used to read or write to the standard event status registers. Reading a status register returns a value. The binary equivalent ...

  • Page 626: Status.System.*

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-313 as an example, to set bit b0 of the standard event status enable register, set status.Standard.Enable = status.Standard.Opc . In addition to the above const...

  • Page 627

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-314 2657a-901-01 rev. B/december 2012 details in an expanded system (tsp-link), these attributes are used to read or write to the system summary registers. They are set using a constant or a num...

  • Page 628: Status.System2.*

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-315 bit b7 b6 b5 b4 b3 b2 b1 b0 binary value 0/1 0/1 0/1 0/1 0/1 0/1 0/1 0/1 decimal 128 64 32 16 8 4 2 1 weights (2 7 ) (2 6 ) (2 5 ) (2 4 ) (2 3 ) (2 2 ) (2 1...

  • Page 629

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-316 2657a-901-01 rev. B/december 2012 details in an expanded system (tsp-link), these attributes are used to read or write to the system summary registers. They are set using a constant or a num...

  • Page 630: Status.System3.*

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-317 bit b7 b6 b5 b4 b3 b2 b1 b0 binary value 0/1 0/1 0/1 0/1 0/1 0/1 0/1 0/1 decimal 128 64 32 16 8 4 2 1 weights (2 7 ) (2 6 ) (2 5 ) (2 4 ) (2 3 ) (2 2 ) (2 1...

  • Page 631

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-318 2657a-901-01 rev. B/december 2012 details in an expanded system (tsp-link), these attributes are used to read or write to the system summary registers. They are set using a constant or a num...

  • Page 632: Status.System4.*

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-319 bit b7 b6 b5 b4 b3 b2 b1 b0 binary value 0/1 0/1 0/1 0/1 0/1 0/1 0/1 0/1 decimal 128 64 32 16 8 4 2 1 weights (2 7 ) (2 6 ) (2 5 ) (2 4 ) (2 3 ) (2 2 ) (2 1...

  • Page 633

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-320 2657a-901-01 rev. B/december 2012 details in an expanded system (tsp-link), these attributes are used to read or write to the system summary registers. They are set using a constant or a num...

  • Page 634: Status.System5.*

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-321 bit b7 b6 b5 b4 b3 b2 b1 b0 binary value 0/1 0/1 0/1 0/1 0/1 0/1 0/1 0/1 decimal 128 64 32 16 8 4 2 1 weights (2 7 ) (2 6 ) (2 5 ) (2 4 ) (2 3 ) (2 2 ) (2 1...

  • Page 635

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-322 2657a-901-01 rev. B/december 2012 details in an expanded system (tsp-link), these attributes are used to read or write to the system summary registers. They are set using a constant or a num...

  • Page 636: Sweepilinmeasurev()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-323 example 2 -- decimal 18 = binary 0000 0000 0001 0010 enableregister = 18 status.System5.Enable = enableregister uses a decimal value to set bits b1 and b4 o...

  • Page 637: Sweepilistmeasurev()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-324 2657a-901-01 rev. B/december 2012 example sweepilinmeasurev(smua, -1e-3, 1e-3, 0, 100) this function performs a 100-point linear current sweep starting at − 1 ma and stopping at + 1 ma. Volt...

  • Page 638: Sweepilogmeasurev()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-325 sweepilogmeasurev() this kisweep factory script function performs a logarithmic current sweep with voltage measured at every step (point). Type tsp-link acc...

  • Page 639: Sweepvlinmeasurei()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-326 2657a-901-01 rev. B/december 2012 example sweepilogmeasurev(smua, 0.01, 0.1, 0.001, 5) this function performs a five-point linear current sweep starting at 10 ma and stopping at 100 ma. Volt...

  • Page 640: Sweepvlistmeasurei()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-327 figure 119: sweepvlinmeasurei() example sweepvlinmeasurei(smua, 500, 3000, 15e-3, 26) this function performs a 26-point linear voltage sweep starting at 500...

  • Page 641: Sweepvlogmeasurei()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-328 2657a-901-01 rev. B/december 2012 example myvlist = {-100, 100, -200, 200, -400, 400, -800, 800, -1600, 1600} sweepvlistmeasurei(smua, myvlist, 500e-3, 10) this function performs a 10-point ...

  • Page 642: Timer.Measure.T()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-329 figure 120: sweepvlogmeasurei() example sweepvlogmeasurei(smua, 100, 1000, 0.02, 5) this function performs a five-point logarithmic voltage sweep starting a...

  • Page 643: Timer.Reset()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-330 2657a-901-01 rev. B/december 2012 example 2 beeper.Beep(0.5, 2400) print("reset timer") timer.Reset() delay(0.5) dt = timer.Measure.T() print("timer after delay:", dt) beeper.Beep(0.5, 2400)...

  • Page 644: Trigger.Blender[N].Event_Id

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-331 example trigger.Blender[2].Clear() clears the event detector for blender 2. Also see none trigger.Blender[n].Event_id this constant contains the trigger ble...

  • Page 645: Trigger.Blender[N].Overrun

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-332 2657a-901-01 rev. B/december 2012 details this command selects whether the blender waits for any one event (the “or” mode) or waits for all selected events (the “and” mode) before signaling ...

  • Page 646: Trigger.Blender[N].Reset()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-333 trigger.Blender[n].Reset() this function resets some of the trigger blender settings to their factory defaults. Type tsp-link accessible affected by where s...

  • Page 647

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-334 2657a-901-01 rev. B/december 2012 the eventid parameter may be one of the existing trigger event ids shown in the following table. Trigger event ids* event id event description smua.Trigger....

  • Page 648: Trigger.Blender[N].Wait()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-335 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 ...

  • Page 649: Trigger.Clear()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-336 2657a-901-01 rev. B/december 2012 trigger.Clear() this function clears the command interface trigger event detector. Type tsp-link accessible affected by where saved default value function n...

  • Page 650: Trigger.Timer[N].Clear()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-337 trigger.Timer[n].Clear() this function clears the timer event detector and overrun indicator for the specified trigger timer number. Type tsp-link accessibl...

  • Page 651: Trigger.Timer[N].Delay

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-338 2657a-901-01 rev. B/december 2012 trigger.Timer[n].Delay this attribute sets and reads the timer delay. Type tsp-link accessible affected by where saved default value attribute (rw) yes inst...

  • Page 652: Trigger.Timer[N].Event_Id

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-339 example trigger.Timer[3].Delaylist = {50e-6, 100e-6, 150e-6} delaylist = trigger.Timer[3].Delaylist for x = 1, table.Getn(delaylist) do print(delaylist[x]) ...

  • Page 653: Trigger.Timer[N].Passthrough

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-340 2657a-901-01 rev. B/december 2012 usage overrun = trigger.Timer[ n ].Overrun overrun trigger overrun state n trigger timer number (1 to 8) details this attribute indicates if an event was ig...

  • Page 654: Trigger.Timer[N].Reset()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-341 trigger.Timer[n].Reset() this function resets some of the trigger timer settings to their factory defaults. Type tsp-link accessible affected by where saved...

  • Page 655

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-342 2657a-901-01 rev. B/december 2012 details the eventid parameter may be one of the trigger event ids shown in the following table. Trigger event ids* event id event description smua.Trigger.S...

  • Page 656: Trigger.Timer[N].Wait()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-343 trigger.Timer[n].Wait() this function waits for a trigger. Type tsp-link accessible affected by where saved default value function yes usage triggered = tri...

  • Page 657: Tsplink.Group

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-344 2657a-901-01 rev. B/december 2012 details this function waits up to timeout seconds for a trigger on the active command interface. A command interface trigger occurs when: • a gpib get comma...

  • Page 658: Tsplink.Master

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-345 tsplink.Master this attribute reads the node number assigned to the master node. Type tsp-link accessible affected by where saved default value attribute (r...

  • Page 659: Tsplink.Readbit()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-346 2657a-901-01 rev. B/december 2012 tsplink.Readbit() this function reads the state of a tsp-link synchronization line. Type tsp-link accessible affected by where saved default value function ...

  • Page 660: Tsplink.Reset()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-347 also see tsp-link synchronization lines (on page 3-86) tsplink.Readbit() (on page 7-346) tsplink.Writebit() (on page 7-356) tsplink.Writeport() (on page 7-3...

  • Page 661: Tsplink.Trigger[N].Assert()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-348 2657a-901-01 rev. B/december 2012 usage state = tsplink.State state tsp-link state (online or offline) details when the instrument power is first turned on, the state is "offline" . After ts...

  • Page 662: Tsplink.Trigger[N].Clear()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-349 tsplink.Trigger[n].Clear() this function clears the event detector for a trigger. Type tsp-link accessible affected by where saved default value function ye...

  • Page 663: Tsplink.Trigger[N].Mode

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-350 2657a-901-01 rev. B/december 2012 details this number is used by the tsp-link trigger line when it detects an input trigger. Set the stimulus of any trigger object to the value of this const...

  • Page 664

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-351 the setting for mode can be one of the following values: mode number value description tsplink.Trig_bypass 0 allows direct control of the line as a digital ...

  • Page 665: Tsplink.Trigger[N].Overrun

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-352 2657a-901-01 rev. B/december 2012 also see digio.Writebit() (on page 7-58) digio.Writeport() (on page 7-58) tsplink.Trigger[n].Assert() (on page 7-348) tsplink.Trigger[n].Clear() (on page 7-...

  • Page 666: Tsplink.Trigger[N].Release()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-353 tsplink.Trigger[n].Pulsewidth this attribute sets the length of time that the trigger line is asserted for output triggers. Type tsp-link accessible affecte...

  • Page 667: Tsplink.Trigger[N].Reset()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-354 2657a-901-01 rev. B/december 2012 tsplink.Trigger[n].Reset() this function resets some of the tsp-link trigger attributes to their factory defaults. Type tsp-link accessible affected by wher...

  • Page 668

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-355 usage eventid = tsplink.Trigger[ n ].Stimulus tsplink.Trigger[ n ].Stimulus = eventid eventid the event identifier for the triggering event n the trigger li...

  • Page 669: Tsplink.Trigger[N].Wait()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-356 2657a-901-01 rev. B/december 2012 tsplink.Trigger[n].Wait() this function waits for a trigger. Type tsp-link accessible affected by where saved default value function yes usage triggered = t...

  • Page 670: Tsplink.Writeport()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-357 details use tsplink.Writebit() and tsplink.Writeport() to control the output state of the trigger line when trigger operation is set to tsplink.Trig_bypass ...

  • Page 671: Tsplink.Writeprotect

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-358 2657a-901-01 rev. B/december 2012 tsplink.Writeprotect this attribute contains the write-protect mask that protects bits from changes by the tsplink.Writebit() and tsplink.Writeport() functi...

  • Page 672: Tspnet.Connect()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-359 example tspnet.Write(testdevice, "print([[hello]])") print(tspnet.Readavailable(testdevice)) tspnet.Clear(testdevice) print(tspnet.Readavailable(testdevice)...

  • Page 673: Tspnet.Disconnect()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-360 2657a-901-01 rev. B/december 2012 example 1 instrumentid = tspnet.Connect("192.0.2.1") if instrumentid then -- use instrumentid as needed here tspnet.Disconnect(instrumentid) end connect to ...

  • Page 674: Tspnet.Execute()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-361 tspnet.Execute() this function sends a command string to the remote device. Type tsp-link accessible affected by where saved default value function yes usag...

  • Page 675: Tspnet.Idn()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-362 2657a-901-01 rev. B/december 2012 tspnet.Idn() this function retrieves the response of the remote device to *idn? . Type tsp-link accessible affected by where saved default value function ye...

  • Page 676: Tspnet.Readavailable()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-363 details this command reads available data from the remote instrument and returns responses for the specified number of arguments. The format string can cont...

  • Page 677: Tspnet.Reset()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-364 2657a-901-01 rev. B/december 2012 example id = tspnet.Connect("192.0.2.1") tspnet.Write(id, "*idn?\r") repeat bytes = tspnet.Readavailable(id) until bytes > 0 print(tspnet.Read(id)) tspnet...

  • Page 678: Tspnet.Timeout

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-365 details this function sets and gets the termination character sequence that is used to indicate the end of a line for a tsp-net connection. Using the termse...

  • Page 679: Tspnet.Tsp.Abort()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-366 2657a-901-01 rev. B/december 2012 tspnet.Tsp.Abort() this function causes the tsp-enabled instrument to stop executing any of the commands that were previously sent to it. Type tsp-link acce...

  • Page 680: Tspnet.Tsp.Rbtablecopy()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-367 details this setting determines if the instrument sends an abort message when it attempts to connect to a tsp-enabled instrument using the tspnet.Connect() ...

  • Page 681: Tspnet.Tsp.Runscript()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-368 2657a-901-01 rev. B/december 2012 also see none tspnet.Tsp.Runscript() this function loads and runs a script on a remote tsp-enabled instrument. Type tsp-link accessible affected by where sa...

  • Page 682: Userstring.Add()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-369 details the tspnet.Write() function sends inputstring to the remote instrument. It does not wait for command completion on the remote instrument. The model ...

  • Page 683: Userstring.Catalog()

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-370 2657a-901-01 rev. B/december 2012 userstring.Catalog() this function creates an iterator for the user string catalog. Type tsp-link accessible affected by where saved default value function ...

  • Page 684: Userstring.Get()

    Model 2657a high power system sourcemeter® instrument reference manual section 7: tsp command reference 2657a-901-01 rev. B/december 2012 7-371 details this function deletes the string that is associated with name from nonvolatile memory. Example userstring.Delete("assetnumber") userstring.Delete("p...

  • Page 685

    Section 7: tsp command reference model 2657a high power system sourcemeter® instrument reference manual 7-372 2657a-901-01 rev. B/december 2012 usage waitcomplete() waitcomplete( group ) group specifies which tsp-link group on which to wait details this function will wait for all previously started ...

  • Page 686: Introduction

    In this section: introduction .............................................................................. 8-1 error levels ............................................................................... 8-1 error effects on scripts ............................................................. 8-2...

  • Page 687: Error Effects On Scripts

    Section 8: troubleshooting guide model 2657a high power system sourcemeter® instrument reference manual 8-2 2657a-901-01 rev. B/december 2012 error effects on scripts most errors will not abort a running script. The only time a script is aborted is when a lua run-time error (error code -286, "tsp ru...

  • Page 688: Error Summary List

    Model 2657a high power system sourcemeter® instrument reference manual section 8: troubleshooting guide 2657a-901-01 rev. B/december 2012 8-3 error summary list error summary error number error level error message -430 recoverable query deadlocked -420 recoverable query unterminated -410 recoverable...

  • Page 689

    Section 8: troubleshooting guide model 2657a high power system sourcemeter® instrument reference manual 8-4 2657a-901-01 rev. B/december 2012 error summary error number error level error message 1200 recoverable tsp-link initialization failed 1202 recoverable tsp-link initialization failed 1203 reco...

  • Page 690

    Model 2657a high power system sourcemeter® instrument reference manual section 8: troubleshooting guide 2657a-901-01 rev. B/december 2012 8-5 error summary error number error level error message 1500 recoverable invalid baud rate setting 1501 recoverable invalid parity setting 1503 recoverable inval...

  • Page 691

    Section 8: troubleshooting guide model 2657a high power system sourcemeter® instrument reference manual 8-6 2657a-901-01 rev. B/december 2012 error summary error number error level error message 2410 recoverable tspnet max connections reached 2411 recoverable tspnet connection failed 2412 recoverabl...

  • Page 692

    Model 2657a high power system sourcemeter® instrument reference manual section 8: troubleshooting guide 2657a-901-01 rev. B/december 2012 8-7 error summary error number error level error message 5044 recoverable cannot perform requested operation while current measure autorange is enabled 5045 recov...

  • Page 693

    Section 8: troubleshooting guide model 2657a high power system sourcemeter® instrument reference manual 8-8 2657a-901-01 rev. B/december 2012 lan troubleshooting suggestions if you are unable to connect to the instrument's web interface, check the following items: • verify that the network cable is ...

  • Page 694

    In this section: how do i display the instrument's serial number? .................... 9-1 how do i optimize performance? .............................................. 9-2 how do i upgrade the firmware? .............................................. 9-2 how do i use the digital i/o port? .............

  • Page 695

    Section 9: frequently asked questions (faqs) model 2657a high power system sourcemeter® instrument reference manual 9-2 2657a-901-01 rev. B/december 2012 how do i optimize performance? The primary factors that affect measurement accuracy and speed are: • warm-up: for rated measurement accuracy, allo...

  • Page 696

    Model 2657a high power system sourcemeter® instrument reference manual section 9: frequently asked questions (faqs) 2657a-901-01 rev. B/december 2012 9-3 how do i trigger other instruments? Triggering a scanner a typical test scenario might call for using the model 2657a with a scanner to test a num...

  • Page 697

    Section 9: frequently asked questions (faqs) model 2657a high power system sourcemeter® instrument reference manual 9-4 2657a-901-01 rev. B/december 2012 how do i generate a gpib service request? For detailed information about this topic, see the status model (on page e-1) section of this manual. Se...

  • Page 698

    Model 2657a high power system sourcemeter® instrument reference manual section 9: frequently asked questions (faqs) 2657a-901-01 rev. B/december 2012 9-5 to save the reading buffer data: 1. From the front panel, press the store key, and then select save . 2. Select internal to save to internal nonvo...

  • Page 699

    Section 9: frequently asked questions (faqs) model 2657a high power system sourcemeter® instrument reference manual 9-6 2657a-901-01 rev. B/december 2012 how do i make low-current measurements? Low-current connections low-current measurements ( resistances in the signal path. Model 2657a instruments...

  • Page 700

    Model 2657a high power system sourcemeter® instrument reference manual section 9: frequently asked questions (faqs) 2657a-901-01 rev. B/december 2012 9-7 figure 122: typical low-current connections metal noise shield line r ating 100-240 vac 50, 60 hz 350 va max. Line fuse slowblow 5.0 a, 250 v no i...

  • Page 701

    Section 9: frequently asked questions (faqs) model 2657a high power system sourcemeter® instrument reference manual 9-8 2657a-901-01 rev. B/december 2012 (1) protective earth (safety ground). Keithley instruments model ca-568-120 is a protective earth cable assembly. See keithley instruments website...

  • Page 702

    Model 2657a high power system sourcemeter® instrument reference manual section 9: frequently asked questions (faqs) 2657a-901-01 rev. B/december 2012 9-9 where can i get the labview driver? The latest ni tm labview tm driver is available from the keithley instruments support website ( http://www.Kei...

  • Page 703

    Section 9: frequently asked questions (faqs) model 2657a high power system sourcemeter® instrument reference manual 9-10 2657a-901-01 rev. B/december 2012 why is the reading value 9.91e37? This value indicates that there is a measurement overflow error. This error occurs when: • a measurement perfor...

  • Page 704: Next Steps

    In this section: additional model 2657a information ....................................... 10-1 additional model 2657a information for additional information about the model 2657a, refer to: • the product information cd-rom (which ships with the product). Contains software tools, drivers, and produ...

  • Page 705: Introduction

    In this appendix: introduction ............................................................................... A-1 line fuse replacement .............................................................. A-1 front panel tests ....................................................................... A-2 up...

  • Page 706: Front Panel Tests

    Appendix a: maintenance model 2657a high power system sourcemeter® instrument reference manual a-2 2657a-901-01 rev. B/december 2012 to prevent injury, death, or instrument damage, use only the correct fuse type (see table). Perform the following steps to replace the line fuse: 1. Power off the inst...

  • Page 707

    Model 2657a high power system sourcemeter® instrument reference manual appendix a: maintenance 2657a-901-01 rev. B/december 2012 a-3 keys test this test lets you check the functionality of each front panel key. Perform the following steps to run the keys test: 1. If the model 2657a is in remote mode...

  • Page 708: Upgrading The Firmware

    Appendix a: maintenance model 2657a high power system sourcemeter® instrument reference manual a-4 2657a-901-01 rev. B/december 2012 upgrading the firmware upgrade files are available on the keithley instruments website ( http://www.Keithley.Com ). To locate the upgrade files on the keithley website...

  • Page 709

    Model 2657a high power system sourcemeter® instrument reference manual appendix a: maintenance 2657a-901-01 rev. B/december 2012 a-5 using tsb for upgrading the firmware after downloading the new flash file from the keithley instruments website, you can use test script builder (tsb) to upgrade the f...

  • Page 710: Verification

    In this appendix: verification ................................................................................ B-1 adjustment ............................................................................. B-14 verification the information in this topic is intended only for qualified service personne...

  • Page 711

    Appendix b: calibration model 2657a high power system sourcemeter® instrument reference manual b-2 2657a-901-01 rev. B/december 2012 verification test requirements be sure that you perform the verification tests: • under the proper environmental conditions. • after the specified warm-up period. • us...

  • Page 712

    Model 2657a high power system sourcemeter® instrument reference manual appendix b: calibration 2657a-901-01 rev. B/december 2012 b-3 recommended verification equipment the following table summarizes recommended maximum allowable test equipment uncertainty for verification points. Total test equipmen...

  • Page 713

    Appendix b: calibration model 2657a high power system sourcemeter® instrument reference manual b-4 2657a-901-01 rev. B/december 2012 source limit calculations as an example of how to calculate source verification limits, assume you are testing the model 2657a 200 v dc output range using a 180 v outp...

  • Page 714

    Model 2657a high power system sourcemeter® instrument reference manual appendix b: calibration 2657a-901-01 rev. B/december 2012 b-5 if the model 2657a high power system sourcemeter ® instrument is not within specifications and not under warranty, see the procedures in adjustment (on page b-14) for ...

  • Page 715

    Appendix b: calibration model 2657a high power system sourcemeter® instrument reference manual b-6 2657a-901-01 rev. B/december 2012 setting the measurement range when simultaneously sourcing and measuring either voltage or current, the measure range is coupled to the source range, and you cannot in...

  • Page 716

    Model 2657a high power system sourcemeter® instrument reference manual appendix b: calibration 2657a-901-01 rev. B/december 2012 b-7 1. With the power off, connect the digital multimeter to the model 2657a as shown in the figure titled "connections for current verification." 2. Select the multimeter...

  • Page 717

    Appendix b: calibration model 2657a high power system sourcemeter® instrument reference manual b-8 2657a-901-01 rev. B/december 2012 current measurement accuracy follow the steps below to verify that model 2657a current measurement accuracy is within specified limits. The procedure involves applying...

  • Page 718

    Model 2657a high power system sourcemeter® instrument reference manual appendix b: calibration 2657a-901-01 rev. B/december 2012 b-9 5. Repeat the procedure for negative calibrator currents with the same magnitudes as those listed. 6. Verify current accuracy for high-speed adc current measurements a...

  • Page 719

    Appendix b: calibration model 2657a high power system sourcemeter® instrument reference manual b-10 2657a-901-01 rev. B/december 2012 1. With the power off, connect the digital multimeter (dmm) to the model 2657a output terminals using 4-wire connections, as shown below. Use the direct connection sc...

  • Page 720

    Model 2657a high power system sourcemeter® instrument reference manual appendix b: calibration 2657a-901-01 rev. B/december 2012 b-11 figure 128: alternate connections for voltage verification (sample voltage divider shown) 10 m Ω 200 k Ω hi sense hi sense lo lo 10 m Ω 10 m Ω 10 m Ω 10 m Ω 10 m Ω li...

  • Page 721

    Appendix b: calibration model 2657a high power system sourcemeter® instrument reference manual b-12 2657a-901-01 rev. B/december 2012 2. Set the multimeter measuring function to dc volts. 3. Press the src key to source voltage and make sure the source output is turned on. 4. Enable the model 2657a 4...

  • Page 722

    Model 2657a high power system sourcemeter® instrument reference manual appendix b: calibration 2657a-901-01 rev. B/december 2012 b-13 5. Make sure the source output is turned on (if off, press the output on/off control). 6. Verify voltage measurement accuracy for each of the voltages listed in the t...

  • Page 723: Adjustment

    Appendix b: calibration model 2657a high power system sourcemeter® instrument reference manual b-14 2657a-901-01 rev. B/december 2012 adjustment the information in this topic is intended only for qualified service personnel. Some of the procedures may expose you to hazardous voltages that could resu...

  • Page 724

    Model 2657a high power system sourcemeter® instrument reference manual appendix b: calibration 2657a-901-01 rev. B/december 2012 b-15 adjustment considerations when performing the adjustment procedures: • make sure that the test equipment is properly warmed up and connected to the correct model 2657...

  • Page 725

    Appendix b: calibration model 2657a high power system sourcemeter® instrument reference manual b-16 2657a-901-01 rev. B/december 2012 recommended calibration adjustment equipment the table below contains the recommended equipment for the calibration adjustment procedures. You can use alternate equip...

  • Page 726

    Model 2657a high power system sourcemeter® instrument reference manual appendix b: calibration 2657a-901-01 rev. B/december 2012 b-17 step sequence adjustment steps must be performed in a specific sequence. See the table titled "model 2657a calibration adjustment steps." note that all steps are perf...

  • Page 727

    Appendix b: calibration model 2657a high power system sourcemeter® instrument reference manual b-18 2657a-901-01 rev. B/december 2012 model 2657a calibration adjustment steps function 1 adjustment steps 2 adjustment points 3 sense mode 4 voltage source and measure see step 2. Voltage calibration adj...

  • Page 728

    Model 2657a high power system sourcemeter® instrument reference manual appendix b: calibration 2657a-901-01 rev. B/december 2012 b-19 calibration commands quick reference the following table summarizes remote calibration commands. For a more complete description of these commands, refer to the tsp c...

  • Page 729

    Appendix b: calibration model 2657a high power system sourcemeter® instrument reference manual b-20 2657a-901-01 rev. B/december 2012 calibration commands command description smua.Source.Calibratev( range , cp1expected , cp1reference , cp2expected , cp2reference ) adjust voltage source range calibra...

  • Page 730

    Model 2657a high power system sourcemeter® instrument reference manual appendix b: calibration 2657a-901-01 rev. B/december 2012 b-21 figure 129: connections for voltage calibration 10 m Ω 200 k Ω hi sense hi sense lo lo 10 m Ω 10 m Ω 10 m Ω 10 m Ω 10 m Ω line rating 100-240 vac 50, 60 hz 350 va max...

  • Page 731

    Appendix b: calibration model 2657a high power system sourcemeter® instrument reference manual b-22 2657a-901-01 rev. B/december 2012 figure 130: connections for voltage calibration (direct connection) line rating 100-240 vac 50, 60 hz 350 va max. Line fuse slowblow 5.0 a, 250 v no internal operator...

  • Page 732

    Model 2657a high power system sourcemeter® instrument reference manual appendix b: calibration 2657a-901-01 rev. B/december 2012 b-23 b. Send the following commands in order to initialize voltage calibration: smua.Cal.Unlock("ki0026xx") smua.Reset() smua.Source.Func = smua.Output_dcvolts it is not n...

  • Page 733

    Appendix b: calibration model 2657a high power system sourcemeter® instrument reference manual b-24 2657a-901-01 rev. B/december 2012 smua.Source.Calibratev(200, 1e-30, 1e-5, 180, 179.8) 12. If this step is not on the cala sense mode, send the measure calibration command using the multimeter and mod...

  • Page 734

    Model 2657a high power system sourcemeter® instrument reference manual appendix b: calibration 2657a-901-01 rev. B/december 2012 b-25 where: -range = the negative of the present calibration range z_rdg = the -zero model 2657a measurement dmm_z_rdg = the -zero dmm measurement fs_rdg = the -fs model 2...

  • Page 735

    Appendix b: calibration model 2657a high power system sourcemeter® instrument reference manual b-26 2657a-901-01 rev. B/december 2012 it is not necessary to set the measure range when following this procedure for calibration because the measure range is locked to the source range when measuring the ...

  • Page 736

    Model 2657a high power system sourcemeter® instrument reference manual appendix b: calibration 2657a-901-01 rev. B/december 2012 b-27 typical values for the 120 ma range: smua.Source.Calibratei(120e-3, 1e-30, 1e-5, 108e-3, 107.98e-3) 12. If this step is not on the cala sense mode, send the measure c...

  • Page 737

    Appendix b: calibration model 2657a high power system sourcemeter® instrument reference manual b-28 2657a-901-01 rev. B/december 2012 where: -range = the negative of the present calibration range src_z = the -zero model 2657a programmed source output value dmm_z_rdg = the -zero dmm measurement src_f...

  • Page 738

    Model 2657a high power system sourcemeter® instrument reference manual appendix b: calibration 2657a-901-01 rev. B/december 2012 b-29 step 5. Contact check calibration adjustment a. As illustrated in the following figure: • short the model 2657a sense lo and lo terminals together. • short the sense ...

  • Page 739

    Appendix b: calibration model 2657a high power system sourcemeter® instrument reference manual b-30 2657a-901-01 rev. B/december 2012 e. Allow the readings to settle, then get the model 2657a readings: r50_hi, r50_lo = smua.Contact.R() f. Send the contact check low calibration adjustment command: sm...

  • Page 740

    Model 2657a high power system sourcemeter® instrument reference manual appendix b: calibration 2657a-901-01 rev. B/december 2012 b-31 step 7. Save calibration constants calibration adjustment is now complete, so you can store the calibration constants in nonvolatile memory by sending the following c...

  • Page 741: Overview

    In this appendix: overview ................................................................................. C-1 establishing a point-to-point connection .................................. C-1 connecting to the lan .......................................................... C-10 lan speeds .............

  • Page 742

    Appendix c: lan concepts and settings model 2657a high power system sourcemeter® instrument reference manual c-2 2657a-901-01 rev. B/december 2012 contact your corporate information technology (it) department for permission before you connect the model 2657a to a corporate network. If you have probl...

  • Page 743

    Model 2657a high power system sourcemeter® instrument reference manual appendix c: lan concepts and settings 2657a-901-01 rev. B/december 2012 c-3 figure 134: computer ip configuration using the command prompt if the information for the ethernet adapter displays " media disconnected ," close the com...

  • Page 744

    Appendix c: lan concepts and settings model 2657a high power system sourcemeter® instrument reference manual c-4 2657a-901-01 rev. B/december 2012 step 2: disable dhcp to use the computer's existing ip address do not change the ip address at any time without talking to your system administrator. Ent...

  • Page 745

    Model 2657a high power system sourcemeter® instrument reference manual appendix c: lan concepts and settings 2657a-901-01 rev. B/december 2012 c-5 5. Select use the following ip address . The option for "use the following dns server addresses" is automatically selected. 6. Set the ip address. If the...

  • Page 746

    Appendix c: lan concepts and settings model 2657a high power system sourcemeter® instrument reference manual c-6 2657a-901-01 rev. B/december 2012 5. Select use the following ip address . The option for "use the following dns server addresses" is automatically selected. 6. Set the ip address. If the...

  • Page 747

    Model 2657a high power system sourcemeter® instrument reference manual appendix c: lan concepts and settings 2657a-901-01 rev. B/december 2012 c-7 8. Select use the following ip address . The option for "use the following dns server addresses" is automatically selected. 9. Set the ip address. If the...

  • Page 748

    Appendix c: lan concepts and settings model 2657a high power system sourcemeter® instrument reference manual c-8 2657a-901-01 rev. B/december 2012 5. Select use the following ip address . The option for "use the following dns server addresses" is automatically selected. 6. Set the ip address. If the...

  • Page 749

    Model 2657a high power system sourcemeter® instrument reference manual appendix c: lan concepts and settings 2657a-901-01 rev. B/december 2012 c-9 5. Change the subnet mask from the lan config menu: a. Select config > subnetmask , and then press the enter key. The subnetmask menu item is to the righ...

  • Page 750: Connecting to The Lan

    Appendix c: lan concepts and settings model 2657a high power system sourcemeter® instrument reference manual c-10 2657a-901-01 rev. B/december 2012 if the web page does not open in the browser, see lan troubleshooting suggestions (on page 8-8). Connecting to the lan each device on the lan (corporate...

  • Page 751

    Model 2657a high power system sourcemeter® instrument reference manual appendix c: lan concepts and settings 2657a-901-01 rev. B/december 2012 c-11 setting the ip address contact your corporate information technology (it) department to secure a valid ip address for the instrument when placing the in...

  • Page 752: Lan Speeds

    Appendix c: lan concepts and settings model 2657a high power system sourcemeter® instrument reference manual c-12 2657a-901-01 rev. B/december 2012 configuring the domain name system (dns) the domain name system (dns) lets you type a domain name in the address bar to connect to the instrument. If yo...

  • Page 753: Duplex Mode

    Model 2657a high power system sourcemeter® instrument reference manual appendix c: lan concepts and settings 2657a-901-01 rev. B/december 2012 c-13 to set the lan speed: 1. From the front panel, press the menu key and select lan > config > speed . 2. Turn the navigation wheel to select either 10 mbp...

  • Page 754: Viewing The Network Settings

    Appendix c: lan concepts and settings model 2657a high power system sourcemeter® instrument reference manual c-14 2657a-901-01 rev. B/december 2012 searching for dns server(s) starting dlla configuration dlla failed dlla configuration started on xxx.Xxx.Xxx.Xxx starting manual configuration manual c...

  • Page 755

    Model 2657a high power system sourcemeter® instrument reference manual appendix c: lan concepts and settings 2657a-901-01 rev. B/december 2012 c-15 confirming port numbers to view the port number assigned to each remote interface protocol: 1. From the front panel, press the menu key, and then select...

  • Page 756

    Appendix c: lan concepts and settings model 2657a high power system sourcemeter® instrument reference manual c-16 2657a-901-01 rev. B/december 2012 raw socket connection all keithley instruments that have lan connections support raw socket communication. This means that you can connect to the tcp/ip...

  • Page 757

    Model 2657a high power system sourcemeter® instrument reference manual appendix c: lan concepts and settings 2657a-901-01 rev. B/december 2012 c-17 2. Type a name to identify the connection (for example, my instrument ), and then click ok . 3. In the connect to dialog box, click the connect using li...

  • Page 758

    Appendix c: lan concepts and settings model 2657a high power system sourcemeter® instrument reference manual c-18 2657a-901-01 rev. B/december 2012 figure 143: properties dialog box 8. Click ascii setup . The ascii setup dialog box is displayed. 9. From the ascii setup dialog box, select the followi...

  • Page 759

    Model 2657a high power system sourcemeter® instrument reference manual appendix c: lan concepts and settings 2657a-901-01 rev. B/december 2012 c-19 10. Click ok in the ascii setup dialog box. The properties dialog box is displayed. 11. Click ok in the properties dialog box. 12. Use the hyperterminal...

  • Page 760

    Appendix c: lan concepts and settings model 2657a high power system sourcemeter® instrument reference manual c-20 2657a-901-01 rev. B/december 2012 the timestamp, event identifier, ip address, and the domain name identify the incoming and outgoing lxi trigger packets. The following table provides de...

  • Page 761

    Model 2657a high power system sourcemeter® instrument reference manual appendix c: lan concepts and settings 2657a-901-01 rev. B/december 2012 c-21 this command outputs one or more strings similar to the following: 14:14:02.000 17 jun 2008, lan0, 10.80.64.191, lxi, 0, 1213712000, not available, 0, 0...

  • Page 762: Command Summary

    In this appendix: command summary ................................................................ D-1 script command equivalents ................................................... D-3 command reference ................................................................ D-3 command summary the ieee st...

  • Page 763

    Appendix d: common commands model 2657a high power system sourcemeter® instrument reference manual d-2 2657a-901-01 rev. B/december 2012 unlike other commands, like those listed in tsp commands (on page 7-8), each common command must be sent in a separate message. The common commands cannot be used ...

  • Page 764: Script Command Equivalents

    Model 2657a high power system sourcemeter® instrument reference manual appendix d: common commands 2657a-901-01 rev. B/december 2012 d-3 script command equivalents the commands that can be included in scripts that are equivalent to the common commands are defined in the table below. Common command s...

  • Page 765

    Appendix d: common commands model 2657a high power system sourcemeter® instrument reference manual d-4 2657a-901-01 rev. B/december 2012 operation complete and query: *opc and *opc? Wait for pending overlapped commands to complete. *opc operation complete command that sets the opc bit *opc? Operatio...

  • Page 766

    Model 2657a high power system sourcemeter® instrument reference manual appendix d: common commands 2657a-901-01 rev. B/december 2012 d-5 wait-to-continue: *wai suspends the execution of subsequent commands until all previous overlapped commands are finished. *wai this pauses until overlapped command...

  • Page 767: Overview

    In this appendix: overview .................................................................................. E-1 clearing registers ................................................................... E-13 programming and reading registers ....................................... E-14 status byte and...

  • Page 768

    Appendix e: status model model 2657a high power system sourcemeter® instrument reference manual e-2 2657a-901-01 rev. B/december 2012 an event is represented by a condition register bit changing from a 1 to 0 or 0 to 1. When an event occurs and the appropriate ntr or ptr bit is set, the correspondin...

  • Page 769

    Model 2657a high power system sourcemeter® instrument reference manual appendix e: status model 2657a-901-01 rev. B/december 2012 e-3 error queue the error queue holds error and status messages. As programming errors and status messages occur, a message that defines the error or status is placed in ...

  • Page 770

    Appendix e: status model model 2657a high power system sourcemeter® instrument reference manual e-4 2657a-901-01 rev. B/december 2012 status function summary the following functions and attributes control and read the various registers. Additional information for the various register sets is include...

  • Page 771

    Model 2657a high power system sourcemeter® instrument reference manual appendix e: status model 2657a-901-01 rev. B/december 2012 e-5 status model diagrams the following figures graphically describe the status model: • status byte and service request enable registers (on page e-6) • measurement even...

  • Page 772

    Appendix e: status model model 2657a high power system sourcemeter® instrument reference manual e-6 2657a-901-01 rev. B/december 2012 figure 147: status byte and service request enable registers + to node x in system summary register (system), system summary register 2 (system2), system summary regi...

  • Page 773

    Model 2657a high power system sourcemeter® instrument reference manual appendix e: status model 2657a-901-01 rev. B/december 2012 e-7 figure 148: system summary and standard event registers 0 6 5 3 4 2 1 7 14 13 12 11 10 9 8 15 system summary register 2 (system2) + 0 6 5 3 4 2 1 7 14 13 12 11 10 9 8...

  • Page 774

    Appendix e: status model model 2657a high power system sourcemeter® instrument reference manual e-8 2657a-901-01 rev. B/december 2012 figure 149: measurement event registers 0 6 5 3 4 2 1 7 14 13 12 11 10 9 8 15 measurement event register (measurement) + 0 6 5 3 4 2 1 7 14 13 12 11 10 9 8 15 measure...

  • Page 775

    Model 2657a high power system sourcemeter® instrument reference manual appendix e: status model 2657a-901-01 rev. B/december 2012 e-9 figure 150: operation status registers bit 0 6 5 3 4 2 1 7 14 13 12 11 10 9 8 15 operation status register (operation/osr) + 0 6 5 3 4 2 1 7 14 13 12 11 10 9 8 15 ope...

  • Page 776

    Appendix e: status model model 2657a high power system sourcemeter® instrument reference manual e-10 2657a-901-01 rev. B/december 2012 figure 151: operation status trigger overrun registers 0 6 5 3 4 2 1 7 14 13 12 11 10 9 8 15 operation status lan summary register + status.Operation.Instrument.Lan ...

  • Page 777

    Model 2657a high power system sourcemeter® instrument reference manual appendix e: status model 2657a-901-01 rev. B/december 2012 e-11 figure 152: operation status trigger timer, trigger blender, and remote registers 0 6 5 3 4 2 1 7 14 13 12 11 10 9 8 15 operation status remote summary register + st...

  • Page 778

    Appendix e: status model model 2657a high power system sourcemeter® instrument reference manual e-12 2657a-901-01 rev. B/december 2012 figure 153: operation status digital i/o and tsp-link registers 0 6 5 3 4 2 1 7 14 13 12 11 10 9 8 15 operation status digital i/o summary register + status.Operatio...

  • Page 779: Clearing Registers

    Model 2657a high power system sourcemeter® instrument reference manual appendix e: status model 2657a-901-01 rev. B/december 2012 e-13 figure 154: questionable status registers clearing registers commands to reset the status registers are listed in the table below. In addition to these commands, you...

  • Page 780

    Appendix e: status model model 2657a high power system sourcemeter® instrument reference manual e-14 2657a-901-01 rev. B/december 2012 programming and reading registers programming enable and transition registers the only registers that you can program are the enable and transition registers. All ot...

  • Page 781

    Model 2657a high power system sourcemeter® instrument reference manual appendix e: status model 2657a-901-01 rev. B/december 2012 e-15 reading registers any register in the status structure can be read either by sending the common command query (where applicable), or by including the script command ...

  • Page 782

    Appendix e: status model model 2657a high power system sourcemeter® instrument reference manual e-16 2657a-901-01 rev. B/december 2012 figure 156: status byte and service request (srq) service request enable register status summary message read by serial poll read by *stb? Or print(status.Condition)...

  • Page 783

    Model 2657a high power system sourcemeter® instrument reference manual appendix e: status model 2657a-901-01 rev. B/december 2012 e-17 the bits of the status byte register are described as follows: • bit b0, measurement summary bit (msb): set summary bit indicates that an enabled measurement event h...

  • Page 784

    Appendix e: status model model 2657a high power system sourcemeter® instrument reference manual e-18 2657a-901-01 rev. B/december 2012 serial polling and srq any enabled event summary bit that goes from 0 to 1 sets bit b6 and generates a service request (srq). In your test program, you can periodica...

  • Page 785: Status Register Sets

    Model 2657a high power system sourcemeter® instrument reference manual appendix e: status model 2657a-901-01 rev. B/december 2012 e-19 enable and transition registers in general, there are three types of user-writable registers that are used to configure which bits feed the register summary bit and ...

  • Page 786

    Appendix e: status model model 2657a high power system sourcemeter® instrument reference manual e-20 2657a-901-01 rev. B/december 2012 for example, either of the following commands will set the ext enable bit: status.System.Enable = status.System.Ext status.System.Enable = 1 when reading a register,...

  • Page 787

    Model 2657a high power system sourcemeter® instrument reference manual appendix e: status model 2657a-901-01 rev. B/december 2012 e-21 commands to program and read the register are summarized below and also in the status function summary (on page e-4) table. Figure 157: standard event register stand...

  • Page 788

    Appendix e: status model model 2657a high power system sourcemeter® instrument reference manual e-22 2657a-901-01 rev. B/december 2012 operation status registers as shown in the status model's operation status registers (on page e-9) diagram, there are 22 register sets associated with operation stat...

  • Page 789

    Model 2657a high power system sourcemeter® instrument reference manual appendix e: status model 2657a-901-01 rev. B/december 2012 e-23 questionable status registers this register set feeds to bit b3 (qsb) of the status byte. The bits used in the questionable status register set are described as foll...

  • Page 790

    Appendix e: status model model 2657a high power system sourcemeter® instrument reference manual e-24 2657a-901-01 rev. B/december 2012 measurement event registers as shown in the status model's measurement event registers (on page e-8), there are eight register sets associated with measurement event...

  • Page 791

    Model 2657a high power system sourcemeter® instrument reference manual appendix e: status model 2657a-901-01 rev. B/december 2012 e-25 register programming example the command sequence below programs the instrument to generate a service request (srq) and set the system summary bit in all tsp-link no...

  • Page 792: Tsp-Link System Status

    Appendix e: status model model 2657a high power system sourcemeter® instrument reference manual e-26 2657a-901-01 rev. B/december 2012 tsp-link system status the tsp-link ® expansion interface allows instruments to communicate with each other. The test system can be expanded to include up to 32 tsp-...

  • Page 793

    Model 2657a high power system sourcemeter® instrument reference manual appendix e: status model 2657a-901-01 rev. B/december 2012 e-27 status configuration (enable) commands the following commands (sent from the master node) enable the appropriate register bits for the above example: node 15 status ...

  • Page 794

    Appendix e: status model model 2657a high power system sourcemeter® instrument reference manual e-28 2657a-901-01 rev. B/december 2012 master node service request: the following command enables the service request for the measurement event: status.Request_enable = 1 the affected status register for ...

  • Page 795: Display Character Codes

    In this appendix: model 2657a display character codes ...................................... F-1 model 2657a display character codes the following tables contain the display character codes (decimal values) and their corresponding display. Display character codes (decimal 0 to 39) decimal display de...

  • Page 796

    Appendix f: display character codes model 2657a high power system sourcemeter® instrument reference manual f-2 2657a-901-01 rev. B/december 2012 display character codes (decimal 40 to 102) decimal display decimal display decimal display 040 ( 061 = 082 r 041 ) 062 > 083 s 042 * 063 ? 084 t 043 + 064...

  • Page 798

    Appendix f: display character codes model 2657a high power system sourcemeter® instrument reference manual f-4 2657a-901-01 rev. B/december 2012 display character codes (decimal 166 to 228) decimal display decimal display decimal display 166 6 187 Φ 208 æ 167 7 188 ∩ 209 Æ 168 8 189 ∪ 210 â 169 9 19...

  • Page 799

    Model 2657a high power system sourcemeter® instrument reference manual appendix f: display character codes 2657a-901-01 rev. B/december 2012 f-5 display character codes (decimal 229 to 255 ) decimal display decimal display decimal display 229 ó 238 ñ 247 230 ò 239 Ñ 248 231 240 ÿ 249 232 Ö 241 250 2...

  • Page 800: Index

    I-1 2657a-901-01 rev. B/december 2012 a analog-to-digital converter • 2-22, 2-78, 4-1 anonymous script • 6-5 arrays • 6-24 attribute • 5-2 assigning a value to • 5-2 reading • 5-2 autoexec script • 6-7 autorun scripts • 6-6 autozero • 2-22 front panel • 2-23 nplc caching • 2-24 b base library functi...

  • Page 801

    2657a-901-01 rev. B/december 2012 i-2 e environmental conditions • b-2 error messages effects on scripts • 8-2 interlock • 9-9 retrieving • 8-2 summary • 8-1 examples contact check • 2-38 digital i/o programming • 3-84 filter programming • 3-5 interactive triggering • 3-54 ohms programming • 2-31 po...

  • Page 802

    I-3 2657a-901-01 rev. B/december 2012 low range limits • 2-74 lua reference • 6-11 m mac address • 7-122, c-14 maintenance • a-1 line fuse replacement • a-1 manuals • 1-2, 1-3 master and subordinates • 6-48 node reset • 7-155 node, tsp-link • 6-56 math library functions • 6-28 measure v or i • 4-20 ...

  • Page 803

    2657a-901-01 rev. B/december 2012 i-4 readings maximum • 2-72 recalling • 3-9 recommended test equipment • b-3, b-16 registers enable and transition • e-19 measurement event • e-24 operation status • e-22 programming example • e-25 questionable status • e-23 reading • e-15 serial polling and srq • e...

  • Page 804

    I- 5 2657a-901-01 rev. B/december 2012 test considerations • b-5, b-15 test fixture • 2-62 test script builder • 6-30 tests front panel • a-2 time • 7-172 timestamp • 3-9 trigger mode syntax rules • 7-3 triggering • 3-31 configuring attributes • 2-26 digital i/o port and tsp-link synchronization lin...

  • Page 805

    12/06 specifications are subject to change without notice. All keithley trademarks and trade names are the property of keithley instruments, inc. All other trademarks and trade names are the property of their respective companies. A g r e a t e r m e a s u r e o f c o n f i d e n c e keithley instru...