Tektronix 4200A-SCS User manual

Download

Model 4200A-SCS KXCI

Remote Control Programming

4200A-KXCI-907-01 Rev. C June 2022

tek.com/keithley

*P4200A-KXCI-907-01C*

4200A-KXCI-907-01C

KXCI Remote Control

Model 4200A-SCS

Programming

Cleveland, Ohio, U.S.A.

Any unauthorized reproduction, photocopy, or use of the information herein, in whole or in part,

without the prior written approval of Keithley Instruments is strictly prohibited.

All Keithley Instruments product names are trademarks or registered trademarks of Keithley

Instruments, LLC. Other brand names are trademarks or registered trademarks of their r espective

holders.

Actuate

All Rights R eserved.

Microsoft, Visual C++, Excel, and Windows are either registered trademarks or trademarks of

Microsoft Corporation in the United States and/or other countries.

Document number: 4200A-KXCI-907-01 Rev. C June 2022

Safety precaut ions

The following safety precautio ns should be observed before using this product and any associated ins tr um enta tion . Alt ho ugh some instruments and accessories would normally be used with nonhazardous voltages, there are situations where hazardous conditions may be present.

This product is intended for use by personnel who recognize shock hazards and are familiar with the safety precautions required to avoid possible injury. Read and follow all installation, operation, and maintenance information carefully before using the product. Refer to the user documentation for complete product specifications.

If the product is used in a manner not specified, the protection provided by the product warranty may be impaired. The types of product users are: Responsible body is the individual or group responsible for the use and maintenance of equipment, for ensuring that the

equipment is operated within its specifications and operating limits, and for ensuring that operators are adequately trained. Operators use the product for its intended function. They must be trained in electrical safety procedures and proper use of the

instrument. They must be protected from electric shock and contact with hazardous live circuits. Maintenance personnel perform routine procedures on the product to keep it operating properly, for example, setting the line

voltage or replacing consumable materials. Maintenance procedures are described in the user documentation. The procedures explicitly state if the operator may perform them. Otherwise, they should be performed only by service personnel.

Service personnel are trained to work on live circuits, perform safe installations, and repair products. Only properly trained service personnel may perform installation and service procedures.

Keithley products are designed for use with electrical signals that are measurement, control, and data I/O connections, with low transient overvoltages, and must not be directly connected to mains voltage or to voltage sources with high transient overvoltages. Measurement Category II (as referenced in IEC 60664) connections require protection for high transient overvoltages often associate d with local AC mains connections. Certain Keithley measuring instruments may be connected to mains. These instruments will be marked as category II or higher.

Unless explicitly allowed in the specifications, operating manual, and instrument labels, do not connect any instrument to mains. Exercise extreme caution when a shock hazard is present. Lethal voltage may be present on cable connector jacks or test

fixtures. The American National Standards Institute (ANSI) states that a shock hazard exists when voltage levels greater than 30 V RMS, 42.4 V peak, or 60 VDC are present. A good safety practice is to expect that hazardous voltage is present in any unknown circuit before measuring.

Operators of this product must be protected from electric shock at all times. The responsible body must ensure that operators are prevented access and/or insulated from every connection point. In some cases, connections must be exposed to potential human contact. Product operators in these circumstances must be trained to protect themselves from the risk of electric shock. If the circuit is capable of operating at or above 1000 V, no conductive part of the circuit may be exposed.

Do not connect switching cards directly to unlimited power circuits. They are intended to be used with impedance-limited sources. NEVER connect switching cards directly to AC mains. When connecting sources to switching cards, install protective devices to limit fault current and voltage to the card.

Before operating an instrument, ensure that the line cord is connected to a properly-grounded power receptacle. Inspect the connecting cables, test leads, and jumpers for possible wear, cracks, or breaks before each use.

When installing equipment where access to the main power cord is restricted, such as rack mounting, a separate main input power disconnect device must be provided in close proximity to the equipment and within easy reach of the operator.

For maximum safety, do not touch the product, test cables, or any other instruments while power is applied to the circuit under test. ALWAYS remove power from the entire test system and discharge any capacitors before: connecting or disconnecting cables or jumpers, installing or removing switching cards, or making internal changes, such as installing or removing jumpers.

Do not touch any object that could provide a current path to the common side of the circuit under test or power line (earth) ground. Always make measurements with dry hands while standing on a dry, insulated surface capable of withstanding the voltage being measured.

For safety, instruments and accessories must be used in accordance with the operating instructions. If the instruments or accessories are used in a manner not specified in the operating instructions, the protection provided by the equipment may be impaired.

Do not exceed the maximum signal levels of the instruments and accessories. Maximum signal levels are defined in the specifications and operating information and shown on the instrument panels, test fixture panels, and switching cards.

When fuses are used in a product, replace with the same type and rating for continued protection against fire hazard. Chassis connections must only be used as shield connections for measuring circuits, NOT as protective earth (safety ground)

connections. If you are using a test fixture, keep the lid closed while power is applied to the device under test. Safe operation requires the use

of a lid interlock.

If a screw is present, connect it to protective earth (safety ground) using the wire recommended in the user docume ntat io n.

The symbol on an instrument means caution, risk of hazard. The user must refer to the operating instructions located in the user documentation in all cases where the symbol is mark ed on the instr u ment .

The symbol on an instrument means warning, risk of electric shock. Use standard safety precautions to avoid personal contact with these voltages.

The symbol on an instrument shows that the surface may be hot. Avoid personal contact to prevent burns.

The symbol indicates a connection terminal to the equipment frame.

If this symbol is on a product, it indicates that mercury is present in the display lamp. Please note that the lamp must be properly disposed of according to federal, state, and local laws.

The WARNING heading in the user documentation explains hazards that might result in personal injury or death. Always read the associated information very carefully before performing the indicated procedure.

The CAUTION heading in the user documentation explains h azard s that coul d dama ge the instrument. Such damage may invalidate the warranty.

The CAUTION heading with the symbol in the user documentation explains hazards that could result in moderate or minor injury or damage the instrument. Always read the as soc iate d infor mation very carefully before performing the indicated procedure. Damage to the instrument may invalidate the warranty.

Instrumentation and accessories shall not be connected to humans. Before performing any maintenance, disconnect the line cord and all test cables. To maintain protection from electric shock and fire, replacement components in mains circuits — including the power

transformer, test leads, and input jacks — must be purchased from Keithley. Standard fuses with applicable national safety approvals may be used if the rating and type are the same. The detachable mains power cord provided with the instrument may only be replaced with a similarly rated power cord. Other components that are not safety-related may be purchased from other suppliers as long as they are equivalent to the original component (note that selected parts should be purchased only through Keithley to maintain accuracy and functionality of the product). If you are unsure about the applicability of a replacement component, call a Keithley office for information.

Unless otherwise noted in product-specific literature, Keithley instruments are designed to operate indoors only, in the following environment: Altitude at or below 2,000 m (6,562 ft); temperature 0 °C to 50 °C (32 °F to 122 °F); and pollution degree 1 or 2.

To clean an instrument, use a cloth dampened with deionized water or mild, water-based cleaner. Clean the exterior of the instrument only. Do not apply cleaner directly to the instrument or allow liquids to enter or spill on the instrument. Products that consist of a circuit board with no case or chassis (e.g., a data acquisition board for installation into a computer) should never require cleaning if handled according to instructions. If the board becomes contaminated and operation is affected, the board should be returned to the factory for proper cleaning/servicing.

Safety precaution revision as of June 2018.

Introduction ............................................................................................................... 1-1

Introduction .......................................................................................................................... 1-1

KXCI communication connections .......................................................................... 2-1

KXCI communications connections ..................................................................................... 2-1

GPIB connections ................................................................................................................ 2-2

Ethernet connections ........................................................................................................... 2-2

Using KCon to configure KXCI ............................................................................................. 2-3

Set up KXCI for GPIB control .................................................................................................... 2-3

Set up KXCI for ethernet control ............................................................................................... 2-5

Setting up KXCI as a 4145B emulator ....................................................................................... 2-6

GPIB communications .......................................................................................................... 2-8

GPIB status indicators (GPIB communications only) ................................................................ 2-9

Graph display ............................................................................................................................ 2-9

Error messages ......................................................................................................................... 2-9

Ethernet communications................................................................................................... 2-10

KXCI ethernet client driver ...................................................................................................... 2-10

Driver functions ....................................................................................................................... 2-11

Example write and read with ethernet ..................................................................................... 2-11

Using KXCI ................................................................................................................ 3-1

Using KXCI ........................................................................................................................... 3-1

Output data formats ............................................................................................................. 3-1

Data format for system mode readings ..................................................................................... 3-2

Data format for user mode readings .......................................................................................... 3-2

Status byte and serial polling ............................................................................................... 3-4

Status byte ................................................................................................................................ 3-4

Bit B0, Data Ready .................................................................................................................... 3-4

Bit B1, Syntax Error ................................................................................................................... 3-4

Bit B4, Busy............................................................................................................................... 3-4

Bit B6, RQS (request for service) .............................................................................................. 3-5

Serial polling .............................................................................................................................. 3-5

Waiting for SRQ ........................................................................................................................ 3-5

Sample programs ................................................................................................................. 3-6

Program 1: VAR1 and VAR2 sweep (system mode) ................................................................. 3-6

Program 2: Basic source-measure (user mode) ........................................................................ 3-7

Program 3: Retrieving saved data (system mode) .................................................................... 3-7

Program 4: VAR1 sweep with real-time data retrieval ............................................................... 3-8

Logging commands, errors, and test results ........................................................................ 3-9

Logging commands ................................................................................................................. 3-10

Logging errors ......................................................................................................................... 3-10

Logging test results ................................................................................................................. 3-11

Understanding the log file ....................................................................................................... 3-11

Graphing the test results ......................................................................................................... 3-12

Table of contents

Programming

Model 4200A-SCS KXCI Remote Control

KXCI common commands ........................................................................................ 4-1

Commands common to system and user modes ................................................................ 4-1

AC ............................................................................................................................................. 4-2

BC ............................................................................................................................................. 4-2

DO ............................................................................................................................................. 4-3

DR ............................................................................................................................................. 4-4

EC ............................................................................................................................................. 4-4

EM ............................................................................................................................................. 4-5

ID .............................................................................................................................................. 4-5

*IDN? ........................................................................................................................................ 4-6

IT ............................................................................................................................................... 4-6

RD ............................................................................................................................................. 4-7

RG ............................................................................................................................................. 4-8

RI .............................................................................................................................................. 4-9

RS ............................................................................................................................................. 4-9

*RST ....................................................................................................................................... 4-10

SP ........................................................................................................................................... 4-10

Calling KULT user libraries remote ly ................................................................................. 4-11

Summary of commands for remote calls ................................................................................. 4-11

AB ........................................................................................................................................... 4-11

EX ........................................................................................................................................... 4-12

GD ........................................................................................................................................... 4-13

GN ........................................................................................................................................... 4-14

GP ........................................................................................................................................... 4-15

UL ........................................................................................................................................... 4-16

SystemUtil User Library .......................................................................................................... 4-16

instrumentinfo .......................................................................................................................... 4-17

remotemoduleinfo ................................................................................................................... 4-18

systeminfo ............................................................................................................................... 4-19

4200A command set only commands ................................................................................ 4-20

*OPT? ..................................................................................................................................... 4-20

KXCI SMU commands .............................................................................................. 5-1

KXCI SMU commands ......................................................................................................... 5-1

SMU default settings ............................................................................................................ 5-2

System mode SMU default settings ..................................................................................... 5-3

Control commands ............................................................................................................... 5-4

Page commands ....................................................................................................................... 5-4

System mode commands .......................................................................................................... 5-5

User mode commands .............................................................................................................. 5-6

Commands common to system and user modes ...................................................................... 5-7

4200A command set only .......................................................................................................... 5-7

Command reference ............................................................................................................ 5-8

System mode commands .......................................................................................................... 5-8

CH ............................................................................................................................................. 5-9

VM ........................................................................................................................................... 5-10

VS ........................................................................................................................................... 5-11

DT ........................................................................................................................................... 5-12

FS ........................................................................................................................................... 5-13

HT ........................................................................................................................................... 5-14

RT ........................................................................................................................................... 5-14

Model 4200A

of contents

-SCS KXCI Remote Control Programming Table

SC ........................................................................................................................................... 5-16

ST ........................................................................................................................................... 5-16

VC and IC................................................................................................................................ 5-17

VL and IL ................................................................................................................................. 5-18

VP and IP ................................................................................................................................ 5-19

VR and IR................................................................................................................................ 5-21

DM .......................................................................................................................................... 5-24

IN ............................................................................................................................................ 5-24

LI ............................................................................................................................................. 5-25

NR ........................................................................................................................................... 5-26

WT .......................................................................................................................................... 5-26

XN ........................................................................................................................................... 5-27

XT ........................................................................................................................................... 5-27

YA ........................................................................................................................................... 5-28

YB ........................................................................................................................................... 5-29

ME ........................................................................................................................................... 5-30

GT ........................................................................................................................................... 5-31

SV ........................................................................................................................................... 5-32

MP ........................................................................................................................................... 5-33

SR ........................................................................................................................................... 5-34

User mode commands (US) .................................................................................................... 5-35

DI ............................................................................................................................................ 5-35

DS ........................................................................................................................................... 5-36

DV ........................................................................................................................................... 5-37

TI ............................................................................................................................................. 5-38

TV ........................................................................................................................................... 5-39

KXCI CVU commands ............................................................................................... 6-1

KXCI CVU commands .......................................................................................................... 6-1

Summary of KXCI CVU commands ..................................................................................... 6-2

User mode commands ......................................................................................................... 6-3

:CVU:CABLE:COMP:LOAD ...................................................................................................... 6-4

:CVU:CABLE:COMP:MEASCUSTOM ...................................................................................... 6-5

:CVU:CABLE:COMP:OPEN ...................................................................................................... 6-5

:CVU:CABLE:COMP:SHORT .................................................................................................... 6-6

:CVU:MEASZ? .......................................................................................................................... 6-7

System mode commands..................................................................................................... 6-7

:CVU:BIAS:DCV:SAMPLE ........................................................................................................ 6-7

:CVU:DATA:FREQ? .................................................................................................................. 6-7

:CVU:DATA:STATUS? .............................................................................................................. 6-8

:CVU:DATA:TSTAMP? ............................................................................................................. 6-8

:CVU:DATA:VOLT? ................................................................................................................... 6-8

:CVU:DATA:Z? .......................................................................................................................... 6-8

:CVU:DELAY:STEP .................................................................................................................. 6-9

:CVU:DELAY:SWEEP ............................................................................................................... 6-9

:CVU:FSTEPSIZE ................................................................................................................... 6-10

:CVU:SAMPLE:HOLDT ........................................................................................................... 6-10

:CVU:SAMPLE:INTERVAL...................................................................................................... 6-10

:CVU:SOAK:DCV .................................................................................................................... 6-11

:CVU:STANDBY ...................................................................................................................... 6-11

:CVU:STEP:FREQ .................................................................................................................. 6-11

:CVU:SWEEP:ACV ................................................................................................................. 6-12

:CVU:SWEEP:DCV ................................................................................................................. 6-12

:CVU:SWEEP:FREQ ............................................................................................................... 6-13

:CVU:SWEEP:LISTDCV ......................................................................................................... 6-14

:CVU:TEST:ABORT ................................................................................................................ 6-14

Table of contents

Programming

Model 4200A-SCS KXCI Remote Control

:CVU:TEST:RUN ..................................................................................................................... 6-14

Modeless commands ......................................................................................................... 6-15

:CVU:ACV ............................................................................................................................... 6-15

:CVU:ACZ:RANGE .................................................................................................................. 6-15

:CVU:CHANNEL ..................................................................................................................... 6-16

:CVU:CONFIG:ACVHI ............................................................................................................. 6-16

:CVU:CONFIG:DCVHI ............................................................................................................ 6-16

:CVU:CORRECT ..................................................................................................................... 6-17

:CVU:DCV ............................................................................................................................... 6-17

:CVU:DCV:OFFSET ................................................................................................................ 6-18

:CVU:FREQ ............................................................................................................................. 6-18

:CVU:LENGTH ........................................................................................................................ 6-19

:CVU:MODE ............................................................................................................................ 6-19

:CVU:MODEL .......................................................................................................................... 6-20

:CVU:OUTPUT ........................................................................................................................ 6-20

:CVU:RESET ........................................................................................................................... 6-21

:CVU:SPEED .......................................................................................................................... 6-21

:CVU:TEST:COMPLETE? ....................................................................................................... 6-24

Code examples .................................................................................................................. 6-24

Example 1 ............................................................................................................................... 6-24

Example 2 ............................................................................................................................... 6-26

KXCI pulse generator commands ............................................................................ 7-1

KXCI pulse generator commands ........................................................................................ 7-1

Summary of KXCI PGU commands ..................................................................................... 7-2

PA ............................................................................................................................................. 7-2

PD ............................................................................................................................................. 7-3

PE ............................................................................................................................................. 7-3

PG ............................................................................................................................................. 7-4

PH ............................................................................................................................................. 7-5

PN ............................................................................................................................................. 7-5

PO ............................................................................................................................................. 7-6

PS ............................................................................................................................................. 7-7

PT ............................................................................................................................................. 7-7

PV ............................................................................................................................................. 7-9

RP ........................................................................................................................................... 7-10

TO ........................................................................................................................................... 7-11

TS ........................................................................................................................................... 7-12

VF ........................................................................................................................................... 7-13

Introduction ...............................................................................1-1

In this section:

Introduction

With Keithley External Control Interface (KXCI), you can use an external computer to control the source-measure units (SMUs), capacitance-voltage units (CVUs), and pulse generator units (PMU) in the 4200A-SCS directly. KXCI also provides you with indirect control of pulse measure units (PMUs), using user test modules (UTMs) through GPIB or ethernet connections.

Section 1

Introduction

For the SMUs, the KXCI command set includes an HP 4145 compatibility mode, allowing many programs already developed for the HP4145 to be used on the 4200A-SCS instead.

This document contains:

• KXCI communication connections: Describes the hardware and software set up for GPIB and

ethernet communications.

• KXCI user interface: Describes how to use the KXCI user interface, which is used to control

GPIB operation.

• KXCI common commands: Descriptions of common commands, such as ID commands,

reading commands, and reset commands.

• KXCI SMU commands: Descriptions of the commands used to set up and control SMUs in user

mode and system mode.

• KXCI CVU commands: Descriptions of the commands used to control the CVU using KXCI in

both user mode and system mode.

• KXCI pulse generator commands: Descriptions of the commands used to control pulse

generators.

Ethernet communications........................................................2-10

KXCI communication connections

In this section:

KXCI communications connect ions ...........................................2-1

GPIB connections .....................................................................2-2

Ethernet connections ................................................................2-2

Using KCon to configure KXCI ..................................................2-3

GPIB communications ..............................................................2-8

KXCI communications connections

You can communicate with the 4200A-SCS using GPIB or ethernet connections. The connections for each are described in the following topics.

Section 2

The locations of the connections are shown in the following figure.

Figure 1: GPIB and ethernet connectors on the 4200A-SCS

Section

Programming

2: KXCI communication connections Model 4200A-SCS KXCI Remote Control

GPIB connections

The GPIB cable is the IEEE-488 instrumentation data bus with hardware and programming standards originally adopted by the Institute of Electrical and Electronic Engineers (IEEE) in 1975. The 4200ASCS conforms to these standards:

• IEEE-488.1-1987

• IEEE-488.2-1992

To connect the 4200A-SCS, use a GPIB cable equipped with standard GPIB connectors, as shown in the figure below. Either end of this cable mates to the GPIB connector on the rear panel of the 4200A-SCS. Connect the other end of the cable to the GPIB connector on the computer.

The connectors on the cable are stackable to allow GPIB connection to other instruments. However, to avoid damage, do not stack more than three connectors on any one unit.

To minimize interference caused by electromagnetic radiation, use shielded GPIB cables.

Ethernet connections

Use a standard cable (CAT-5, RJ-45 terminated) to connect to the 4200A-SCS, as shown in the figure in Communications connections (on page 2-1).

Figure 2: Standard IEEE-488 connectors

The ethernet cable must be connected to the network, not directly to a computer.

2-2 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

KXCI communication connections

-SCS KXCI Remote Control Programming Section 2:

Using KCon to configure KXCI

You use the Keithley Configuration Utility (KCon) to configure KXCI communications. If you need to set up the 4200A-SCS as a subordinate on a GPIB or ethernet system, you do the

initial setup through the KCon KXCI Settings. This allows you to use an external computer to remotely control the 4200A-SCS over GPIB or ethernet.

You can also use KXCI to set up emulation for Keysight 4145B Semiconductor Parameter Analyzers. In many cases, test programs developed for use with a Keysight 4145B run without modification when they are used with a 4200A-SCS running KXCI.

For more information on KCon, refer to “Keithley Configuration Utility (KCon)” in Model 4200A-SCS Setup and Maintenance.

Before opening KCon to change the present KXCI configuration, you must close KXCI.

The presently selected communications interface (GPIB or ethernet) and its settings are displayed in the KXCI console. By default, the 4200A-SCS is set up for GPIB remote control. The command and message area below the KXCI settings displays sent commands, KXCI error messages, and numerical test results (refer to Using KXCI (on page 3-1

)).

Set up KXCI for GPIB control

To set up GPIB control:

1. Open KCon.

2. Select KXCI Settings. The KXCI Settings dialog box is displayed, as shown in the following figure.

Figure 3: KXCI Settings dialog box

4200A-SCS-907-01 Rev. C June 2022 2-3

Section

Programming

2: KXCI communication connections Model 4200A-SCS KXCI Remote Control

3. Set Communications to GPIB.

4. Set the GPIB Address. This is the primary address of the 4200A-SCS when operating under KXCI control. If the selected GPIB address conflicts with the GPIB address of another system component, a red exclamation-point symbol (!) is displayed next to the selected address.

5. Set the Reading Delimiter to determine the output data delimiter characters that are added to the end of each KXCI output message:

 Select String Terminator to use a character.  Select Comma to terminate output data with a comma (,).

6. If you selected String Terminator, select the type of Character:

 None to use no character.  CR to use a carriage return.  LF to use a line feed.  CR/LF to use a carriage return and line feed character sequence.

7. If String Terminator is selected, select EOI ON or EOI OFF. The EOI setting determines if the 4200A-SCS asserts the GPIB End Or Identify (EOI) signal with the last byte of each output data message.

When KXCI starts, the status messages look similar to the following figure when GPIB is set up.

Figure 4: KXCI status when GPIB selected

8. Select OK.

2-4 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

KXCI communication connections

-SCS KXCI Remote Control Programming Section 2:

Set up KXCI for ethernet control

To set up ethernet control:

1. Open KCon.

2. Select KXCI Settings. The KXCI Settings dialog box is displayed.

3. Set Communications to Ethernet.

4. Set the Port Number (the default is 1225, which is acceptable for most installations). Make note of the port number for use in the code.

5. Select a Reading Delimiter. The delimiter determines if the delimiter for output data is a string terminator or a comma.

6. If you selected String Terminator, select the Character. The options are:  None to use no character. Recommended to avoid extra termination characters. The 4200A-

SCS automatically adds a null character as a terminator.

 CR to use a carriage return.  LF to use a line feed.  CR/LF to use a carriage return and line feed character sequence.

7. Select OK.

When KXCI starts, the status messages look similar to the following figure when ethernet is set up.

Figure 5: KXCI status when ethernet is selected

4200A-SCS-907-01 Rev. C June 2022 2-5

Section

Programming

String reported in response to ID query

KI4200A Vx.x.x (where

ID HP4145B 1.1,1.0

GPIB data resolution

7 digits

5 digits

Maximum number of sweep points

4096

1024

Possible instrument configurations

8 source-measure units (SMU), voltmeters (VM), or voltage-sources (VS)

Configuration query

*OPT? command

Not supported

Instrument self test

SMUs only

Not supported

Custom A/D control

IT4 command options

Not supported

200 V, 1 A capability

Supported

1.0 pA source/measure-range capabil it y

Supported Source measure units (SMUs)

2 to 9

4 (fixed)

Voltage meter (VM)

You can configure up to nine SMUs to function as

2 (fixed)

Voltage source (VS)

You can configure up to nine SMUs to function as

2 (fixed)

2: KXCI communication connections Model 4200A-SCS KXCI Remote Control

Setting up KXCI as a 4145B emulator

Although the KXCI command set is similar to the Keysight 4145B command set, the 4200A-SCS and Keysight 4145B hardware are different. To use existing 4145B code with the 4200A-SCS, you need to set up the 4200A-SCS SMUs to map to the 4145B instrument numbers. In many cases, test programs developed for use with a Keysight 4145B run without modification when they are used with a 4200A-SCS running KXCI. When a mode is selected, KXCI always starts in that mode.

The following table summarizes some differences and similarities between the modes.

Mode comparison

Mode

Characteristic

(with preamplifier on SMU)

4200A (Normal) 4145 Emulation

x.x.x is the version number)

The main difference between the two instruments is that the 4200A-SCS hardware is modular and the Keysight 4145B hardware is fixed, as shown in the following table.

Hardware comparisons Instrument type Keithley Instruments 4200A-SCS Keysight 4145B

voltage meters.

2-6 4200A-SCS-907-01 Rev. C June 2022

voltage sources.

Model 4200A

KXCI communication connections

VM1...VM8

Instructs the 4200-SMU, 4201-SMU, 4210-SMU, or 4211-SMU to emulate

VS1...VS8

Instructs the 4200-SMU, 420 1-SMU, 4210-SMU, or 4211-SMU to emulate

-SCS KXCI Remote Control Programming Section 2:

KCon manages these hardware differences by allowing you to assign source-measure unit (SMU), voltage meter, or voltage source functions to any 4200A-SCS SMU, as shown in the following table.

KXCI SMU function assignment Function selection Description

SMU

Instructs the 4200-SMU, 420 1-SMU, 4210-SMU, or 4211-SMU to emulate a Keysight 4145B Source Measure Unit.

(voltage meter)

a Keysight 4145B VM1 or VM2 and additional voltage meters (VMs). You can map up to eight VMs to SMUs. You can assign a VM any number from 1 to 8, regardless of the number of SMUs in the system. Each VM number

(voltage source)

must be unique.

the capabilities of a Keysight 4145B VS1 or VS2 and additional voltage sources (VSs). You can map up to eight VSs to SMUs. You can assign a VS any number from 1 to 8, regardless of the number of SMUs in the system. Each VS number must be unique.

To set up 4145B emulation:

1. Open KCon.

2. Select KXCI Settings. The KXCI Settings dialog box is displayed, as shown in the following figure.

3. In the Function column, select the 4145 function that the SMU will emulate.

4. In the Number column, select the number that is used for the device in your 4145B program.

Figure 6: KXCI Settings for 4145B emulation

4200A-SCS-907-01 Rev. C June 2022 2-7

Section

Programming

2: KXCI communication connections Model 4200A-SCS KXCI Remote Control

GPIB communications

You cannot run Clarius and KXCI at the same time. When Clarius is running, the 4200A-SCS is the controller and controls all internal and external instruments. When KXCI is running, the 4200A-SCS is a subordinate to a controlling computer.

To start KXCI:

1. Close Clarius.

2. Select the KXCI icon on the desktop.

The KXCI user interface opens.

The GPIB Status indicators only apply if communications is set to GPIB.

Figure 7: KXCI user interface

2-8 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

KXCI communication connections

-999

IEEE32.DLL GPIB driver is not loaded.

-998

Unable to initialize shared memory.

-997

Could not establish communication with console.

-996

GPIB address not sent as argv[1].

-995

GPIB address not in 0<= addr <= 31.

-994

Could not find configuration file.

-993

GPIB argument error.

-992

GPIB command error.

-991

Illegal setup error.

-990

Trigger Master card not found.

-989

Command not valid on this page.

-988

Instrument not mapped.

-987

Skipping instrument.

-986

Unsupported command received.

-985

Unsupported file format error.

-984

Could not open specified file.

-980

Command not valid during test execution.

-975

Command not valid in user mode.

-SCS KXCI Remote Control Programming Section 2:

GPIB status indicators (GPIB communications only)

After KXCI is started, indicators in the GPIB Status box report interface status. A green indicator signals the present status:

• SRQ: Turns on when an error or operating condition occurs.

• LTN: When on, instrument is in the listener active state.

• TLK: When on, instrument is in the talker active state.

• RMT: When on, instrument is in the remote state.

If KXCI is running as a subordinate in a GPIB system, you may see the warning, “Access to all GPIB

nstruments from the 4200 as controller are illegal.” This error occurs if you try to control other

i devices through user library modules. A subordinate node cannot control devices in the system.

Graph display

In response to optional graphics commands, the right side of the KXCI user interface displays a graph of the test results. To hide the graph, select Hide Graph, which provides a larger display area for commands, error messages, and test results.

Error messages

KXCI error messages and numbers are shown in the following table.

Error number Error message

4200A-SCS-907-01 Rev. C June 2022 2-9

Section

Programming

2: KXCI communication connections Model 4200A-SCS KXCI Remote Control

Ethernet communications

The 4200A-SCS is not LXI complia nt, so be aware of the following communications considerations when using ethernet communications:

• Commands must always be terminated with null. If not, KXCI will not read and echo them.

• Ethernet commands always return a response. Commands that do not normally return a

response respond with an acknowledge message and a null terminator (ACK\0).

• Commands that normally return a string or numerical data return that data terminated with the

character that was set in KCon and a null terminator.

If you do not receive data as expected, there may have been an error with the command. Check the KXCI console for error messages. The command may have been sent too soon or had a syntax error. Another potential problem is that there are responses waiting in the buffer that must be cleared before the data can be returned.

KXCI ethernet client driver

A KXCI client driver (32-bit or 64-bit) controls KXCI through the ethernet. You can copy this driver to your controlling computer. The DLL is stand-alone. It does not depend on any other DLLs, so it can be easily moved or copied.

The driver DLLs are named KXCIclient.dll (32-bit) and KXCIclient64.dll (64-bit) and are at the command path: C:\s4200\sys\bin

The KXCIclient.lib (32-bit) and KXCIclient64.lib (64-bit) files are at the command path: C:\s4200\sys\lib

For convenience, a C-language header file (KXCIclient.h) is included with the above paths. It is at the command path:

C:\s4200\sys\include

2-10 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

KXCI communication connections

*IDN?\0

KEITHLEY INSTRUMENTS,KI4200A,1442736,V1.8.1\r\0

CH1, 'VS', 'IS', 1, 3\0

ACK\0

ME\0

ACK\0

DO 'ID'\0

N 4.3555E-15,N 54.978E-15,…N 449.83E-15\r\0

-SCS KXCI Remote Control Programming Section 2:

Driver functions

The KXCIclient.dll driver has the following functions:

• int OpenKXCIConnection_C(char *IPAddrStr, int PortNum, int *err);

• IPAddrStr: IP address in string format nnn.nn.nn.nn (for example, 129.22.35.17)

• PortNum: IP Port assigned in the KXCI tab of KCon

• err: Socket error code returned by WSAGetLastError()

int SendKXCICommand_C(char *cmdstr, char *ReturnString, int *err);

• cmdstr: KXCI command string, for example, "DE;CH1;CH2"

• ReturnString: Data returned by command, if any. If input command results in data to be

returned, it is placed here

• err: Socket error code returned by WSAGetLastError()

int GetKXCISpollByte_C(unsigned short *spbyte, int *err);

• spbyte: KXCI serial poll byte (same as GPIB byte)

• err: Socket error code returned by WSAGetLastError()

void CloseKXCIConnection_C(void);

Example write and read with ethernet

The following commands and their responses were made with communications set to comma-separated data with the character set to carriage return (CR). These settings are made in KCon in the KXCI Settings option.

Written command Response

4200A-SCS-907-01 Rev. C June 2022 2-11

Logging commands, errors, and test results .............................3-9

In this section:

Using KXCI ...............................................................................3-1

Output data formats ..................................................................3-1

Status byte and serial polling ....................................................3-4

Sample programs ......................................................................3-6

Using KXCI

To start using KXCI:

Section 3

Using KXCI

1. Close Clarius and KCon.

2. Double-click the KXCI icon on the desktop.

The 4200A-SCS is ready to accept commands immediately after you start KXCI. For command information, refer to Control commands (on page 5-4), KXCI SMU commands (on page

5-1), KXCI CVU commands (on page 6-1), and KXCI pulse generator commands (on page 7-1).

Output data formats

The following topics describe the data formats for system mode and user mode readings. The hierarchy for data status is L, V, X, C, T, N:

• L: Interval too short

• V: Overflow reading (A/D converter saturated)

• X: Oscillation

• C: This channel in compliance

• T: Other channel in compliance

• N: Normal

Section

Programming

3: Using KXCI Model 4200A-SCS KXCI Remote Control

Data format for system mode readings

For system mode operation, use the DO command to get one or more triggered readings. After sending the DO command s tr ing and ad dres s ing the 42 00A-SCS to talk, the output data string is sent to the computer in the following format:

X±N.NNNNE±NN,X±N.NNNNE±NN,...X±N.NNNNE±NN

Where X is the data status and N is the reading.

Scientific notation for the reading exponent: E+00 = 0

-3

-6

-9

-12

(m) (μ) (n)

(p)

E-03 = 10 E-06 = 10 E-09 = 10 E-12 = 10

Data format for user mode readings

For user mode operation, use the TI or TV command string to trigger and make a reading. After sending the TI or TV command string and addressing the 4200A-SCS to talk, the output data string is sent to the computer in the following format:

XYZ ±N.NNNN E±NN

Where X is the data status, Y is the instrument, Z is the measure mode, and N is the measurement. Y and Z are defined in the following tables.

3-2 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

Using KXCI

Y =

SMU1

SMU2

SMU3

SMU4

VM1

VM2

SMU5

SMU6

SMU7

SMU8

VM3

VM4

VM5

VM6

VM7

VM8

Y =

SMU1

SMU2

SMU3

SMU4

SMU5

SMU6

SMU7

SMU8

Z = V

Voltage

Current

-SCS KXCI Remote Control Programming Section 3:

Voltage measure mode specified (Z = V; see following tables).

Current measure mode specified (Z = I; see below)

Measure mode

Reading (mantissa and exponent) ±N.NNNN E±NN

Scientific notation for the reading exponent: E

+00 = 0

-3

-6

-9

-12

(m) (μ) (n)

(p)

E-03 = 10 E-06 = 10 E-09 = 10 E-12 = 10

4200A-SCS-907-01 Rev. C June 2022 3-3

Section

Programming

—

RQS

—

Busy

— — Syntax error

Data ready

—

0/1 — 0/1 — —

0/1

—

64 — 16 — — 2 1

3: Using KXCI Model 4200A-SCS KXCI Remote Control

Status byte and serial polling

The status byte is an 8-bit register that provides status infor mat ion on ins trum ent o perati on. Wh en a particular operating condition occurs, one or more bits of the status byte sets.

You can use serial polling to read the status byte. The following sections describe the status byte and serial polling.

Status byte

The status byte is an 8-bit register that provides status infor mat ion on ins trum ent o perati on. Wh en an operating condition occurs, one or more bits of the status byte are set. The status byte register is shown in the following table.

Status byte register Bit B7 B6 B5 B4 B3 B2 B1 B0

Condition

Binary value Decimal weight

The bits of the status byte register that are used are described in the following topics.

Bit B0, Data Ready

This bit sets (1) when all measurements are completed and data is ready to be output on the GPIB. Any of the following actions clear (0) bit B0:

• Clears (0) when the data transfer starts.

• Clears (0) when the BC (buffer clear) command is sent to the 4200A-SCS.

• Clears (0) when the 4200A-SCS is serial polled.

Bit B1, Syntax Error

This bit sets (1) when an invalid command string is sent to the 4200A-SCS. Any of the following actions clear (0) bit B1:

• When the 4200A-SC S is ser ial polled.

• When a device clear command (DCL or SDC) is sent to the 4200A-SCS.

Bit B4, Busy

This bit is set (1) while a measurement is made. It clears (0) when the measurement is completed.

3-4 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

Using KXCI

-SCS KXCI Remote Control Programming Section 3:

Bit B6, RQS (request for service)

This bit sets (1) whenever bit B1 (syntax error) sets. If service request for data ready is enabled (DR1 asserted), bit B6 will set whenever bit B0 (data ready) sets. If service request for data ready is disabled (DR0 asserted), bit B6 will not be affected by bit B0.

Bit B6 remains set until one of the following actions occur:

• Clears (0) when the 4200A-SCS is serial polled.

• Clears (0) when a device clear command (DCL or SDC) is sent to the 4200A-SCS.

When bit B6 sets, the SRQ (service request) indicator on the KXCI user interface turns on. It turns off when B6 is cleared.

Serial polling

The serial poll enable (SPE) and serial poll disable (SPD) general bus command sequence is used to serial poll the 4200A-SCS. Serial polling reads the status byte. Generally, the controller uses the serial polling sequence to determine which of several instruments has requested service with the SRQ line. However, the status byte of the 4200A-SCS may be read to determin e when an oper a tin g condition has occurred.

If you try to get data before all the measurements in a test are completed, an error occurs. To prevent this, you can use serial polling in a program fragment to monitor the data ready bit (B0) of the status byte. When B0 sets, which indicates that data is ready, the program obtains the measurement data.

After the source-measure testing process is triggered to start (ME1 is sent to start a sweep), the following C-language programming statement serial polls the instrument:

spoll(addr, &poll, &status);

Waiting for SRQ

Instead of serial polling the 4200A-SCS to detect an SRQ, you can monitor the service request line. When an SRQ occurs, the SRQ line is asserted.

If you are using GPIB connections, you can use the following C-language programming routine stop program execution until an SRQ occurs .

send(addr, "DR1", &status); while(!srq());

The first statement enables service request for data ready. The second command holds up program execution until the SRQ (data ready) occurs.

For ethernet connections, you can use the SP command to monitor the service request line.

4200A-SCS-907-01 Rev. C June 2022 3-5

Section

Programming

3: Using KXCI Model 4200A-SCS KXCI Remote Control

Sample programs

Three sample programs (using the C language) are provided to demonstrate system control using an external computer communicating through GPIB. For these programs, configure KXCI as follows:

• GPIB address: 17

• Delimiter: Comma

• EOI: Off

Program 1: VAR1 and VAR2 sweep (system mode)

The following program demonstrates how to program the 4200A-SCS to perform a VAR1 and VAR2 sweep. It assumes that channels 1 through 4 of KXCI are configured for the SMU function.

MAXLEN = 2048; addr = 17;

// Initialize card: initialize(10, 0);

// Set speed to 0.01 PLC, clear buffer, and // enable service request for data ready: send(addr, "IT1 BC DR1",&status);

// Channel definition for SMU1; constant common: send(addr, "DE CH1,'VE','IE',3,3", &status);

// Define SMU2 for VAR2 I sweep: send(addr, "CH2,'VB','IB',2,2", &status);

// Define SMU3 for VAR1 V sweep: send(addr, "CH3,'VC','IC',1,1", &status);

// Define SMU 4 to be off: send(addr, "CH4", &status);

// Define V-sources and V-meters to be off: send(addr, "VS1;VS2;VM1;VM2", &status);

// Source setup; VAR1 linear sweep from 0 V to 1 V in 50 mV // steps, with I-compliance set to 50 mA: send(addr, "SS VR1,0,1,0.05,50E-3", &status);

// Source setup; VAR2 sweep from 0 uA to 40 uA in 10 uA steps: send(addr, "IP 10E-6,10E-6,4,3", &status);

// Select list display mode: send(addr, "SM DM2", &status);

// Trigger start of test: send(addr, "MD ME1", &status);

3-6 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

Using KXCI

-SCS KXCI Remote Control Programming Section 3:

// Wait for data ready: while(!srq());

// Save readings in a file named "PROG1": send(addr, "SV 'D PROG1'", &status);

Program 2: Basic source-measure (user mode)

The following program demonstrates how to program the 4200A-SCS to perform a basic sourcemeasure operation. It assumes that channels 1 and 2 of KXCI are configured for the SMU function. The measured current reading performed by SMU1 (channel 1) is output to the computer.

MAXLEN = 2048; addr = 17;

// Initialize card: initialize(10, 0);

// Select user mode: send(addr, "US", &status);

// Set speed to 0.01 PLC, clear buffer; // enable service request for data ready: send(addr, "IT1 BC DR1",&status);

// Set SMU1 to source 1.5 V on 20 V range; set compliance // to 1 mA: send(addr, "DV1,1, 1.5, 1E-3", &status);

// Set SMU2 to source 2 V on 20 V range; set compliance to 1 mA: send(addr, "DV2,1,2,1E-3", &status);

// Trigger test; measure current using SMU1: send(addr, "TI1", &status);

// Get reading: enter(recv, MAXLEN, &len, addr, &status);

// Stop SMU outputs: send(addr, "DV1;DV2", &status);

Program 3: Retrieving saved data (system mode)

The following program demonstrates how to retrieve readings that are saved in a data file. In Program 1, SMU3 performed 80 measurements. The 80 current readings were then saved in a data file named 'PROG1'.

The following program assumes that data file PROG1 al Program 1.

4200A-SCS-907-01 Rev. C June 2022 3-7

ready exists. This data file is created by

Section

Programming

3: Using KXCI Model 4200A-SCS KXCI Remote Control

MAXLEN = 2048; addr = 17;

// Initialize card: initialize(10, 0);

// Load data saved in file named "PROG1": send(addr, "GT 'D PROG1'", &status);

// Output data; 'IC' is the measure channel (SMU3) used by // Program 1: send(addr, "DO 'IC'", &status);

// Obtain data: enter(recv, MAXLEN, &len, addr, &status);

Program 4: VAR1 sweep with real-time data retrieval

The following program demonstrates how to program the 4200A-SCS to perform a VAR1 sweep and retrieve data in real time. It assumes that channels 1 and 2 of KXCI are configured for the SMU function.

MAXLEN = 2048; MAXTIMEOUT = 10000;

addr = 17;

// Initialize card: initialize(10, 0);

// Set speed to 0.01 PLC, clear buffer, and // enable service request for data ready: send(addr, "IT1 BC DR1",&status);

// Channel definition for SMU1; VAR1 V sweep: send(addr, "DE CH1,'V1','I1',1,1", &status);

// Channel definition for SMU2; constant common: send(addr, "DE CH1,'V2','I2',3,3", &status);

// Source setup // VAR1 linear sweep from -5V to 5V in 10 mV with 1mA compliance numPoints = 1001; send(addr, "SS VR1,-5,5,0.01,0.001", &status);

// Select list display mode (no graph): send(addr, "SM DM2", &status);

// Trigger start of test: send(addr, "MD ME1", &status);

3-8 4200A-SCS-907-01 Rev. C June 2022

Model 420

Using KXCI

0A-SCS KXCI Remote Control Programming Section 3:

// Get data at real time: curPoint = 1; timeoutCount = 0; while (curPoint <= numPoints && timeoutCount < MAXTIMEOUT) { Sleep(100); //Get timestamp for the present data point //It should be none zero for already completed reading sprintf(command, "RD'CH1T',%d", curPoint); send(addr, command, &status);

// Get reading: enter(recv, MAXLEN, &len, addr, &status); if (len > 0) { //0 character return means no readings are ready for this data point if (!(len == 1 && recv[0] == '0') { //Get voltage reading for curPoint sprintf(command, "RD'V1',%d", curPoint); send(addr, command, &status); enter(recv, MAXLEN, &len, addr, &status);

//Get current reading for curPoint sprintf(command, "RD'I1',%d", curPoint); send(addr, command, &status); enter(recv, MAXLEN, &len, addr, &status);

//Switch to next point curPoint++; } } timeoutCount++; }

Logging commands, errors, and test results

When you send commands, KXCI logs the commands, error messages, and test results as described in the following topics.

To stop operation, close KXCI by selecting Exit.

4200A-SCS-907-01 Rev. C June 2022 3-9

Section

Programming

3: Using KXCI Model 4200A-SCS KXCI Remote Control

Logging commands

When you send a command, the left side of the user interface (the command and message display area) displays each command as it is received, as shown in the figure below.

Figure 8: KXCI command and message display area

To remove existing messages, select Clear Messages. You can use Console Size to set the number of messages that are displayed. You can select 1, 100,

or 1000 lines. If Log Console Messages is selected, KXCI also logs each command into the KXCI log file

(C:\s4200\sys\KXCI\KXCILogfile.txt). If Timestamps is selected, KXCI logs a timestamp for each message.

Logging errors

The command and message display area displays error messages as they occur.

3-10 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

Using KXCI

-SCS KXCI Remote Control Programming Section 3:

Logging test results

The command and message display area also displays the numerical test results for both the 4200A and 4145 Emulation commands sets (refer to “Command Set” in Model 4200A-SCS Setup and Maintenance (4200A-908-01).

You can turn off the graph display to better display a long sequence of test results. Select Hide Graph in the upper right to hide the graph.

The test results are 0.0000 i

If the sent commands include the graphics commands, the graph display area graphs the test data. Refer to Graphing the test results (on page 3-12).

Understanding the log file

If Log Console Messages is selected, KXCI logs all commands to a file named KXCILogfile.txt. You can open the text file after KXCI is closed. Note that whenever you open KXCI, the log file clears.

The log file is in the directory: C:\s4200\sys\KXCI\

You can use any text editor to open the file. SMUs may return a line such as:

DATA:NAI 22.329E-09 The characters after DATA: represent:

• The operating condition: N for normal or C if the SMU is in compliance.

• The instrument number, converted to a letter: A for SMU1, B for SMU2 and so on to letter I.

f the interlock is disconnected.

• The measurement function: V for voltage or I for current.

4200A-SCS-907-01 Rev. C June 2022 3-11

Section

Programming

3: Using KXCI Model 4200A-SCS KXCI Remote Control

Graphing the test results

If you have sent the graphics commands (the DM1 command followed by the X-axis and Y-axis configuration commands), KXCI displays a graph of the generated data. See the example graph and graphics commands in the following figure.

Figure 9: KXCI data graph

KXCI plots all Y1 axis curves in red and all Y2 axis curves in blue. To hide the graph, select Hide Graph.

3-12 4200A-SCS-907-01 Rev. C June 2022

4200A command set only commands .....................................4-20

AC (on page 4-2)

Autocalibrates a SMU channel.

BC (on page 4-2)

Clears all readings from the buffer.

DO (on page 4-3)

Returns the timestamp data that was acquired with the voltage or current measurement, or both.

DR (on page 4-4)

Enables or disables service request for data ready when communications is set to GPIB.

EC (on page 4-4)

Sets the condition to exit the test if compliance is reached.

EM (on page 4-5)

Switches between 4145 Emulation and 4200A command sets.

ID (on page 4-5)

Places the ID of the 4200A-SCS in a particular buffer.

IT (on page 4-6)

Sets the integration time of a SMU.

RD (on page 4-7)

Requests real-time readings.

RG (on page 4-8)

Sets the lowest current range of the SMU to be used when measuring.

RI (on page 4-9)

Instructs a SMU to go to a specified range immediately without waiting until the initiation of a test.

*RST (on page 4-10)

Resets the instrument settings to default settings.

RS (on page 4-9)

Sets the measurement resolution for all channels of a SMU.

SP (on page 4-10)

Allows you to acquire the GPIB serial poll byte when ethernet communications is selected.

KXCI common commands

In this section:

Commands common to system and user modes ......................4-1

Calling KULT user libraries remotely .......................................4-11

Commands common to system and user modes

The command strings described in this section are valid in both the system and user operating modes. They are used for the following operations:

Section 4

Command Brief description

*IDN? (on page 4-6) Generates an identification query and reads identification information.

Section

ing

AC 1

This command string performs autocalibration on SMU channel number 1.

4: KXCI common commands Model 4200A-SCS KXCI Remote Control Programm

This command autocalibrates a SMU channel.

Usage

AC A

SMU number (1 to 9)

Details

When this command is sent, the selected SMU channel is calibrated automatically. The busy bit in the status register is set so that you can detect when autocalibration is finished. The 4200A-SCS will not respond to any commands while autocalibration is executing.

Example

Also see

None

This command clears all readings from the buffer.

Usage

Details

The GPIB data buffer can hold up to 4096 readings. This command string clears all readings from the buffer. It also clears bit B0 (Data Ready) of the

status byte.

Also see

None

4-2 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

KXCI common commands

AAAAAA

User-specified name of the channel that made the measurement, up to

T: Return timestamp data S

DO 'CH1'

This command string requests the reading string for SMU channel 1.

-SCS KXCI Remote Control Programming Section 4:

This command returns the timestamp data that was acquired with the voltage or current measurement, or both.

Usage

DO 'AAAAAA' DO 'AAAAAAB'

6 characters; cannot be changed through the CH or VS commands

: Return the SMU status

Details

After making measurements, use this command string to request the readings. After the 4200A-SCS is addressed to talk, the readings are sent.

Output data is sent to the computer in the format ±N.NNNN E±NN. Output data of 0 indicates this point is not measured yet.

Example

Also see

When you run a voltage sweep without measure commands, you can use DO to retrieve the voltage measurement. However, you cannot use DO to retrieve the current measurement from a voltage sweep. To retrieve the current measurement, use LI, XN, YA, YB, or DV.

DV and DI (on page 5-35) LI (on page 5-25) XN (on page 5-27) YA (on page 5-28) YB (on page 5-29)

4200A-SCS-907-01 Rev. C June 2022 4-3

Section

Programming

 Enable service request for data ready: 1

Action on compliance:

EC 1

This command enables exit on compliance.

4: KXCI common commands Model 4200A-SCS KXCI Remote Control

This command enables or disables service request for data ready when communications is set to GPIB.

Usage

DRA

Set service request for data ready:

 Disable service request for data ready: 0

Details

This command is not available for ethernet communications. Use SP for ethernet communications. This command can be used with SMUs and CVUs. Use a service request to wait until operations are complete before downloading data. GPIB provides a status byte register to monitor instrument operation. Two bits of this register are bit

B0 (Data Ready) and bit B6 (RQS). After all programmed measurements are completed, the data becomes ready for output and bit B0 (Data Ready) sets.

If the service request for data ready is enabled, bit B6 (RQS) is also set when data is ready for output. If the service request for data ready is disabled, bit B6 is not set when data is ready.

Also see

SP (on page 4-10)

This command sets the condition to exit the test if compliance is reached.

Usage

EC A

 Off (do n ot exit if compliance is reached): 0



On (exit if compliance is reached): 1

Example

Also see

4-4 4200A-SCS-907-01 Rev. C June 2022

None

Model 4200A

KXCI common commands

 4200A: 1

Which sessions:

EM 0,1

This selects the 4145 Emulation command set permanently.

-SCS KXCI Remote Control Programming Section 4:

This command switches between 4145 Emulation and 4200A command sets.

Usage

EM A,B

Mode:

 4145 Emulation: 0

 This session only: 0



This and all subsequent sessions (writes to KCon file): 1

Example

Also see

None

This command places the ID of the 4200A-SCS in a particular buffer.

Usage

Details

The instrument ID depends on whether you are in 4200A mode or whether you are in the 4145 Emulation mode.

If you are in 4200A mode, the return is KI4200A Vx.x.x (where x.x.x is the version number). If you are in 4145 Emulation mode, the return is ID HP4145B 1.1,1.0. For additional details about the differences between the 4200A mode and 4145 emulation mode, refer

Also see

to Setting up KXCI as a 4145B emulator (on pag e 2-6

None

4200A-SCS-907-01 Rev. C June 2022 4-5

Section

Programming

Integration time:

Delay factor for custom setting: 0.0 to 100

Filter factor for custom setting: 0.0 to 100

A/D converter integration time in number of PLCs for custom setting: 0.01 to 10.0

4: KXCI common commands Model 4200A-SCS KXCI Remote Control

*IDN?

This command generates an identification query and reads identification information.

Usage

*IDN?

Details

The identification code includes the manufacturer, model number, serial number, and firmware revision of the instrument. The string is formatted as:

KEITHLEY INSTRUMENTS,MODEL nnnn,xxxxxxx,yyyyy Where:

• nnnn = the model number

• xxxxxxx = the serial number

• yyyyy = the firmware revision level

This command must include * before the command.

Also see

None

This command sets the integration time of a SMU.

Usage

ITA IT4, X, Y, Z

 Short (0.1 PLC): 1  Medium (1.0 PLC): 2  Long (10 PLC): 3



Custom (4200A command set only): 4

4-6 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

KXCI common commands

IT2

This command string sets the integration time to 1.0 PLC.

IT4,2.5,0.6,1.3

This command string sets the delay factor to 2.5, the filter factor to 0.6, and the A/D converter integration time to 1.3 PLCs.

AAAAAA

User-specified name of the channel that made the measurement, up to 6 characters

T: Return timestamp data S: Return the SMU status

Index of the point to retrieve; valid range from 1 to the total number of readings

Details

-SCS KXCI Remote Control Programming Section 4:

The integration time is the time to convert a measurement. In general, a short integration time provides the fastest measurement speed at the expense of noise. Conversely, a long integration time provides stable readings at the expense of speed. Integration time is based on power line cycles (PLC). Assuming 60 Hz line power, the integration time for a 1 PLC setting is 16.67 ms (1/60).

The preconfigured integration time settings are equivalent to the Fast, Normal, and Quiet settings available in Clarius:

• Short: Equivalent to the Clarius Fast setting. Optimizes the SMU for speed at the expense of

noise performance. It is a good choice for measurements where noise and settling time are not concerns.

• Normal: Equivalent to the Clarius Medium setting. The default and most commonly used setting.

It provides a good combination of speed and low noise and is the best setting for most cases.

• Long: Equivalent to the Clarius Quiet setting. Optimizes the SMU for low-noise measurements at

the expense of speed. If speed is not a critical consideration, it is a good choice when you need the lowest noise and most accurate measurements.

The custom setting combines delay factor, filter factor, and A/D integration time, which is comparable to the individual Clarius Delay Factor, Filter Factor, and A/D converter integration time settings.

Example 1

Example 2

Also see

None

This command requests real-time readings.

Usage

RD 'AAAAAA', N RD 'AAAAAAB', N

4200A-SCS-907-01 Rev. C June 2022 4-7

Section

Programming

RD 'Volt', 1E

This command string requests the first reading for a SMU channel that is named Volt.

SMU number (1 to 9)

The lowest autoranged range in amps:

-1e-12

RG 2, 10E-12

This command string sets the lowest range of SMU2 with a preamplifier to 10 pA.

Details

4: KXCI common commands Model 4200A-SCS KXCI Remote Control

While making measurements, use this command string to request the real-time reading. This can be used in a loop while measuring.

Output data is sent to the computer in the format ±N.NNNN E±NN. Output data of 0 indicates this point is not measured yet. For an example that demonstrates how to use this command, refer to

Program 4: VAR1 sweep with

real-time data retrieval (on page 3-8).

Example

Also see

DO (on page 4-3)

This command sets the lowest current range of the SMU to be used when measuring.

Usage

RG A,B

 4200-SMU or 4201-SMU without a preamplifier: -100e-9 to 100e-3  4200-SMU or 4201-SMU with a preamplifier: -1e-12 to 100e-3  4210-SMU or 4211-SMUwithout a preamplifier: -100e-9 to 1



4210-SMU or 4211-SMU with a preamplifier:

to 1

Details

The default autoranged ranges are 100 nA without a preamplifier and 1 nA with a preamplifier.

Example

Also see

4-8 4200A-SCS-907-01 Rev. C June 2022

None

Model 4200A

KXCI common commands

channel

range

 4200-SMU or 4201-SMU with a preamplifier: 1e-12 to 100e-3

compliance

Compliance, permitted values (% of range): 10 to 100

RI 1, 1E-3, 1E-3

This command string instructs SMU1 to go to the 1 mA range and set compliance to 1 mA.

Resolution, in number of digits:

RS 7

This command string provides full SMU resolution when the 4200A command set is selected.

-SCS KXCI Remote Control Programming Section 4:

This command instructs a SMU to go to a specified range immediately without waiting until the initiation of a test.

Usage

RI channel,range,compliance

SMU number (1 to 9) Range, permitted values in amps:

 4200-SMU or 4201-SMU without a preamplifier: 100e-9 to 100e-3

Example

Also see

None

This command sets the measurement resolution for all channels of a SMU.

Usage

RS A

 4200A command set: 3 to 7



4145 Emulation command set: 3 to 5

Example

Also see

None

4200A-SCS-907-01 Rev. C June 2022 4-9

Section

Programming

4: KXCI common commands Model 4200A-SCS KXCI Remote Control

*RST

This command resets the instrument settings to default settings.

Usage

*RST

Details

This command must include * before the command. This command resets SMUs, PGUs, PMUs, and CVUs. It does not reset the 4200A-CVIV. The *RST

command also executes :CVU:RESET.

Example

Returns the instrument to default settings and cancels all pending commands.

Also see

Usage

Details

Also see

:CVU:RESET (on page 6-21)

The SP command allows you to acquire the GPIB serial poll byte when ethernet communications is selected.

This command is not available for GPIB communications. Use DR for GPIB communications.

DR (on page 4-4)

4-10 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

KXCI common commands

AB (on page 4-11)

Aborts the execution of a module of the user library.

EX (on page 4-12)

Executes a user module using specified parameter values.

GD (on page 4-13)

Queries and returns the description of a KULT module.

GN (on page 4-14)

Queries input or output parameter values, or both, by name for the last user module run in KXCI.

Queries input or output parameter values, or both, by number for the last user module run in KXCI.

instrumentinfo (on page 4-17)

Retrieves all information on the instru ment car ds in the 4200A-SCS and the 4200A-CVIV Multi-Switch, if attached.

remotemoduleinfo (on page 4-18)

Retrieves all information on the preamplifiers and remote preamplifier/switch modules (RPMs) that are attached to the 4200A-SCS.

systeminfo (on page 4-19)

Retrieves 4200A-SCS system infor mati on.

UL (on page 4-16)

Switches KXCI operation to the user library (usrlib) mode.

-SCS KXCI Remote Control Programming Section 4:

Calling KULT user l ibraries remotely

KXCI contains a set of commands to call user libraries built by the Keithley User Library (KULT) on the 4200A-SCS from a remote interface. Refer to Model 4200A-SCS KULT and KULT Extension Programming (4200A-KULT-907-01) for details on using KULT.

The LPT commands pulse_measrt and

PostDataDoubleBuffer are not compatible with KXCI and cannot be used in user libraries called by KXCI. Use PostDataDouble for user test modules (UTMs) that are called using KXCI. Refer to Model 4200A-SCS LPT Librar y Programming for additional information on these commands.

Summary of commands for remote calls

Command Brief description

GP (on page 4-15)

This command aborts the execution of a module of the user library.

Usage

Also see

4200A-SCS-907-01 Rev. C June 2022 4-11

EX (on page 4-12)

Section

Programming

UserLibrary

UserModule

EX my_2nd_lib VSweep(0, 5, , 11, , 11)

Assume that the following user module (built in KULT) performs a voltage sweep and stores the test

4: KXCI common commands Model 4200A-SCS KXCI Remote Control

This command executes a user module using specified parameter values.

Usage

EX UserLibrary UserModule(param1, param2, param3...)

The name of the user library that contains the module to be run The name of the user module to be run

param1, param2 param3...

Details

Use the following rules for the input and output parameters:

• Separate parameter values by commas. Put only the string or name between commas, without a

leading space, to prevent parsing errors.

• Separate multiple values in an array by semicolons.

The specified input or output parameters, or both, for the user module (function); see Details

• Input and output array parameters must have fewer than 16,000 elements.

• Do not use braces or brackets to enclose array parameters.

• Do not use quotation marks to enclose strings or names.

For an input parameter, type in the value of the parameter. If the position for an input parameter is left empty, the default value for the parameter is used.

For an output parameter, leave the space empty, as shown in the following example.

When used before the GN o

r GP commands, you may need to add a delay to allow the execution of

the module to finish.

Example 1

voltages and measured current readings in arrays:

 User Library: my_2nd_lib  User Model: VSweep

The parameter sequence for the VSweep function is as follows: Vstart (input), Vstop (input), Imeas (output), NumIPoints (input), Vforce

(output), NumVPoints (input)

This example shows how a user function can be run from the KXCI console using parameters that perform an 11-point sweep that starts at 0 V and stops at 5 V. When the KXCI is in the usrlib mode, the example command runs the KULT function.

After execution of the module completes, you can query input or output parameters or both to return the values. Use GN or GP to query parameter s.

4-12 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

KXCI common commands

EX sweep_lib list_sweep(SMU1,SMU2, 0.0; 0.5; 1.0; 1.5; 2.0; 2.5; 3.0, 7, , 7,

,7)

Assume that the following module (built in KULT) performs a voltage list sweep and stores the forced

query parameters.

UserLibrary

The name of the user library that contains the KULT module to be run

UserModule

The name of the user module to be run

GD my_2nd_lib VSweep

This command queries the description of the user modul e in the example in the EX command description. The description is displayed in the KXCI console.

Example 2

Also see

-SCS KXCI Remote Control Programming Section 4:

voltages and measured currents in the following arrays:

 User Library: sweep_lib  User Module: list_sweep

The parameter sequence for the list_sweep function is as follows: forceSMU (input), measureSMU (input), VoltageList (input), numVoltages

(input), ForceV (output), numForceV (input), measI (output), numMeasI (input)

This example shows how a user module that has string and array input parameters can be run from the KXCI console. The two SMUs are specified by their string names, separated by commas, without spaces. The voltage list is an input array of doubles that represent the list of voltages to sweep. The values in the list are separated by semicolons so that the forcing SMU sweeps from 0 V to 3 V in 0.5 V steps.

When KXCI is in the usrlib mode, this example command runs the user module. After execution is complete, you can query the input or output parameters to return values. Use GN or GP

AB (on page 4-11) GN (on page 4-14) GP (on page 4-15)

This command queries and returns the description of a KULT module.

Usage

GD UserLibrary UserModule

Example

Also see

EX (on page 4-12)

4200A-SCS-907-01 Rev. C June 2022 4-13

Section

Programming

ParameterName

The name of the parameter in the KULT module

NumValues

The number of values in an output array to be returned; see Details

GN Vforce 11

This command queries all 11 test voltages (

parameter) for the function that was run in the

0; 0.5; 1.0; 1.5; 2.0; 2.5; 3.0; 3.5; 4.0; 4.5; 5.0

4: KXCI common commands Model 4200A-SCS KXCI Remote Control

This command queries input or output parameter values, or both, by name for the last user module run in KXCI.

Usage

GN ParameterName GN ParameterName NumValues

Details

The NumValues parameter is only used for an output parameter that is an array. If NumValues is not used, one value is returned. NumValues must be less than 16,000.

Arrays are returned as a list of values separated by semicolons. The value returned for an input parameter is the given value. The values returned for an output

parameter is the outcome of the test (for example, measured readings). The output is truncated after 1024 characters on the KXCI console, but the full data string is returned

to the caller.

Example

Also see

You can also query a parameter by specifying the corresponding number for the parameter in the KULT module using GP (on page 4-15

command description for EX. The following array of test voltages are returned and displayed in the KXCI console:

EX (on page 4-12) GP (on page 4-15)

Vforce

4-14 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

KXCI common commands

ParameterPosition

The position of the parameter in the KULT module

NumValues

The number of values in an output array to be returned; see Details

GP 5 11

This command queries all test voltages for the

parameter for the user module that was run in the

0; 0.5; 1.0; 1.5; 2.0; 2.5; 3.0; 3.5; 4.0; 4.5; 5.0

-SCS KXCI Remote Control Programming Section 4:

This command queries input or output parameter values, or both, by number for the last user module run in KXCI.

Usage

GP ParameterPosition GP ParameterPosition NumValues

Details

NumValues is only used for an output parameter that is an array. If NumValues is not used, one value is returned. NumValues must be less than 16,000.

Arrays are returned as a list of values separated by semicolons. The value returned for an input parameter is the given value. The values returned for an output

parameter is the outcome of the test (for example, measured readings). The output is truncated after 1024 characters on the KXCI console, but the full data string is returned

to the caller.

Example

Also see

You can also query a parameter by specifying the name of the parameter in the user module. See

GN (on page 4-14

EX example. Vforce is the fifth parameter in the function. The following array of test voltages is returned and displayed in the KXCI console:

None

Vforce

4200A-SCS-907-01 Rev. C June 2022 4-15

Section

Programming

UL EX cvivulib cviv_configure (CVIV1, 1, 2, 3, 0, 0, CVHI, CVLO, NC, NC, CV Meas)

source code or the Clarius Help pane for descriptions of the user mod ule para met ers and r eturn val ues .

4: KXCI common commands Model 4200A-SCS KXCI Remote Control

This command switches KXCI operation to the user library (usrlib) mode.

Usage

Details

This command allows for the use of direct user library module calls. This command needs to be sent only once before any of the other commands to call user modules.

To switch back to normal KXCI command modes, send DE or US. Send the UL command through GPIB or ethernet to change to the remote usrlib command set.

Example

Select the user library mode. Execute the user module cviv_configure in the user library cvivulib. Refer to the user module

Also see

DE page command strings (on page 5-5) User mode commands (on page 5-35)

SystemUtil User Library

This user library permits KXCI using the UL mode (see Calling KULT user librar ies r emote ly (on pag e 4-11)) to retrieve information about the 4200A-SCS instrument and the system.

This user library is not compatible with Clarius user test modules (UTMs). It only works with the UL

of KXCI.

mode

4-16 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

KXCI common commands

result

String of results for the instruments

maxlen

The maximum number of bytes that result parameter can store in the buffer

len

Number of bytes returned by the function

Output for a 4200A-SCS with three instrument cards installed in slot 3 (4220-PGU), slot 5 (4225-PMU),

3,caldate:Aug 09, 2010,caldue:Aug 09, 2011

-SCS KXCI Remote Control Programming Section 4:

instrumentinfo

This command retrieves all information on the instrument cards in the 4200A-SCS and the 4200A-CVIV MultiSwitch, if attached.

Usage

int instrumentinfo(char *result, int maxlen, int *len);

Details

This function returns all of the instrument-level information for the cards in the 4200A-SCS and the 4200A-CVIV, if attached. The results contain the following information for each instrument card in the 4200A-SCS chassis:

• Slot number (for the 4200A-CVIV, 1 is returned)

Example

Also see

• Instrument card ID

• Model number

• Serial number

• Hardware version

• Firmware version

• Calibration date

• Calibration due date

All of the information is comma-separated.

and slot 7 (4210-CVU or 4215-CVU):

slotno:3,name:VPU1,model:KIVPU4220,serialno:1254281,hwver:1.0,fwver:1.50,calda

te:Dec 19, 2009,caldue:Dec 19, 2010,

slotno:5,name:PMU1,model:KIPMU4225,serialno:1276563,hwver:1.0:544911,fwver:1.5

0,caldate:Nov 28, 2011,caldue:Nov 27, 2012,

slotno:7,name:CVU1,model:KICVU4210,serialno:Z005712,hwver:3.0:493083,fwver:2.0

remotemoduleinfo (on page 4-18)

4200A-SCS-907-01 Rev. C June 2022 4-17

Section

Programming

result

String of results for the remote modules

maxlen

The maximum number of bytes that the result can store in the buffer

len

Number of bytes returned by the function

Output for a 4200A-SCS with two preamplifiers (attached to SMUs in slot 1 and slot 2) and one RPM

2017,caldue:Jan 31, 2018

4: KXCI common commands Model 4200A-SCS KXCI Remote Control

remotemoduleinfo

This command retrieves all information on the preamplifiers and remote preamplifier/switch modules (RPMs) that are attached to the 4200A-SCS.

Usage

int remotemoduleinfo(char *result, int maxlen, int *len);

Details

This function returns all information on the preamplifiers and RPMs that are attached to the 4200ASCS. The results contain the following information for each preamplifier and RPM:

• Slot number

• Instrument card ID

Example

Also see

• Model number

• Serial number

• Hardware version

• Firmware version

• Calibration date

• Calibration due date

All the information is comma-separated.

attached to channel 1 of the PMU in slot 6:

slotno:1,name:PA1,model:KI4200,serialno:0734120,hwver:D7481,fwver:E02.1,caldat

e:Feb 29, 2016,caldue:Mar 01, 2017,

slotno:2,name:PA2,model:KI4200,serialno:0901553,hwver:D08288,fwver:E03,caldate

:Feb 28, 2016,caldue:Feb 28, 2017,

slotno:6,name:RPM1-

1,model:KIRPM4225,serialno:1314347,hwver:1.4,fwver:2.00,caldate:Jan 31,

instrumentinfo (on page 4-17)

4-18 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

KXCI common commands

result

maxlen

The maximum number of bytes that the result can be stored in the buffer

len

Number of bytes returned by the function

Example system info output:

-SCS KXCI Remote Control Programming Section 4:

systeminfo

This command retrieves 4200A-SCS system information.

Usage

int systeminfo(char *result, int maxlen, int *len);

String of results for the system

Details

This function returns system level information for the 4200A-SCS. The result string contains the following information:

• 4200A-SCS serial number

• System software version

• System platform version

• Clarius

application version

Example

Also see

The results are comma-separated.

serialno:1209478,swver:4200A-852-1.0,platformver:4200A-300-1, clariusver:V1.2

None

4200A-SCS-907-01 Rev. C June 2022 4-19

Section

Programming

SMU

Medium-power SMU without a preamplifier

HPSMU

High-power SMU without a preamplifier

SMUPA

Medium-power SMU with a preamplifier

HPSMUPA

High-power SMU with a preamplifier

CVU

Capacitance Voltage Unit

VPU

PGU (source only)

PMU

PMU without an RPM

PMURPM

PMU with an RPM

PMUnRPM1

PMU with RPM tied to channel 1

PMUnRPM2

PMU with RPM tied to channel 2

PMUnRPM1-2

PMU with RPM tied to channel 1 and channel 2

Voltage source only (20 V is presently supported)

Voltage meter

No channel in slot

4: KXCI common commands Model 4200A-SCS KXCI Remote Control

4200A command set only commands

The OPT? command string returns a result string that indicates the 4200A-SCS slot configuration for KXCI.

*OPT?

This command returns a result string that contains the 4200A-SCS slot configuration for KXCI.

Usage

*OPT?

Details

When the 4200A-SCS receives this command, it returns a configuration string with up to eight sets of characters:

xxxn,xxxn,xxxn,xxxn,xxxn,xxxn,xxxn,xxxn

Each character set represents the configuration of a slot in the 4200A-SCS. If the corresponding slot contains a channel, xxx indicates the instrument in sl ot. n is the channel number (1 to 9).

The possible returns for xxx are described in the following table.

SMUs

CVUs

PMUs and PGUs

Voltage sources

Voltage meters

Other

Also see

None

4-20 4200A-SCS-907-01 Rev. C June 2022

Command reference .................................................................5-8

In this section:

KXCI SMU commands ..............................................................5-1

SMU default settings .................................................................5-2

System mode SMU default settings ..........................................5-3

Control commands ....................................................................5-4

KXCI SMU commands

The SMU command set includes the following command types:

Section 5

KXCI SMU commands

• Page commands

• System mode commands

• User mode commands

• Common commands

• 4200A only commands

KXCI locates the instrument control routines in pages that are similar to the Keysight Model 4145B command pages. On earlier instruments, page controls allowed you to switch between screens on the instrument. You could page between configuration, data returns, and graphing. This paradigm is used in KXCI, so before sending an instrument control command string, you must send one of the appropriate page commands, which are summarized in Page commands (on page 5-4

The system mode commands are used to configure the SMUs and make readings. They are a comprehensive set of commands that use all the source-measure capabilities of up to eight SMUs installed in the 4200A-SCS. These commands are summarized in System mode commands page 5-5).

The user mode commands are used for SMU configuration and data retrieval. These commands are summarized in User mode comma nds (on pag e 5-6

The common commands can be used in any operating mode. These commands are summarized in

Commands common to system and user modes (on page 5-7

(on

The 4200A only commands are specific to the 4200A mode (they cannot be used if the KXCI Settings option in KCon is set to 4145 Emulation). They are summarized in 4200A only command set page 5-7).

(on

Section

Programming

Range

100 μA

Compliance

105 μA

Delay Time

Hold Time

Wait Time

Interval

5: KXCI SMU commands Model 4200A-SCS KXCI Remote Control

The KXCI command set for the SMUs is similar to the command set used by the Keysight Model 4145B. This similarity allows many programs already developed for the Keysight Model 4145B to run on the 4200A-SCS.

Detailed information on the command set is presented after the tables.

SMU default settings

You can return SMUs to power-on default settings by transmitting the DCL (device clear) or SDC (selected device clear) general bus command to the 4200A-SCS. The power-on default settings for the user mode are listed in the following table.

The DCL command returns all instruments (including the SMUs) that are connected to the bus to their default settings. The SDC only affects the SMUs. Note that the device clear commands do not affect the KXCI configuration settings.

Use either of the following C programming language commands (GPIB address 17) to return the SMUs to their power-on default settings:

transmit ("UNL LISTEN 17 SDC", &status); // Reset 4200A only. transmit ("DCL", &status); // Reset all instruments.

The SDC and DCL commands described above are not text-string commands, nor are any of the other commands in this manual that are sent using the transmit function. They are low-level commands that must be sent differently than text-string commands. Do not try to use the transmit function to output text-string commands across the GPIB; use the send function for text-string commands.

SMU power-on user mode default settings Setting Default

NRdgs 1

5-2 4200A-SCS-907-01 Rev. C June 2022

Mode User mode

Model 4200A

KXCI SMU commands

SMU1

SMU8*

VM2

N/A

COM

N/A

CONSTant

N/A

* If there are fewer than eight SMUs, only the SMUs in the chassis are programmed to the defaults shown.

Linear

0.00 V

0.00002 A (20.00 μA)

1.00 V

N/A

0.010 V

0.00002 A (20.00 μA)

101

0.1 A

2 V

V1 COM

VS2 V

0.00 V

0.105 A

N/A

-SCS KXCI Remote Control Programming Section 5:

System mode SMU default settings

When KXCI mode is started, the SMUs are in a default state that mimics the Keysight Model 4145B, as shown in the channel definition and source setup tables below. This means that each SMU is active and part of the test, whether or not the test used all the SMUs in the 4200A-SCS chassis.

This may be undesirable, as many tests use a different number of SMUs or SMUs in a different state from the Keysight 4145B default. To avoid the complication of building a KXCI test starting with the default setup, use the following commands to remove the SMUs from the setup:

DE CH1 CH2 CH3 CH4 VM1 VM2 VS1 VS2

The above shows the method for a system with eight SMUs. A system with only four SMUs would not require the last four definitions:

DE CH1 CH2 CH3 CH4

Channel Definition (Page DE) KXCI defaults Instrument Name Source Command

V I Mode Function

SMU2 SMU3* SMU4* SMU5* SMU6* SMU7*

Source Setup (Page SS) KXCI defaults VAR1 (command VR) VAR2 (command IP) Name Sweep mode Start Stop Step Number of steps Compliance

V2 V3 V4 VS1 VS2 VM1

I2 I3 I4 N/A N/A N/A

I V V V V N/A

VAR2 VAR1 CONSTant CONSTant CONSTant N/A

CH CH CH VS VS VM

Constant Source Compliance Command

V4 V VS1 V

4200A-SCS-907-01 Rev. C June 2022 5-3

0.00 V

0.1 A N/A

VC SC

Section

Programming

DE (on page 5-8)

Accesses SMU channel definition page.

SS (on page 5-12)

Accesses source setup page.

SM (on page 5-23)

Accesses measurement setup page.

MD (on page 5-30)

Accesses measurement control page.

US (on page 5-35)

Accesses user-mode page.

UL (on page 4-16)

Allows for use of direct user library module calls. See Calling KULT user

libraries remotely (on page 4-11).

5: KXCI SMU commands Model 4200A-SCS KXCI Remote Control

Control commands

Commands to control instrument operation are grouped as follows:

• Page commands: KXCI locates the instrument control routines in pages that are similar to the

Keysight Model 4145B command pages. Therefore, before sending an instrument control command string, you must send the appropriate page command. The page commands are summarized in Page commands (on page 5-4

• System mode commands: This comprehensive set of commands uses all of the source-

measure capabilities of up to eight SMUs installed in the 4200A-SCS. These commands are summarized in System mode commands (on page 5-5

• User mode commands: This limited set of commands performs basic source-measure

operation. These commands are summarized in User mode commands (on page 5-6

• Common commands: These commands are valid in any operating mode. These commands are

summarized in Commands common to system and user modes (on page 5-7

• 4200A only commands: These commands are specific to the 4200A mode (cannot be used if

4145 Emulation is selected in the KXCI Settings in KCon). They are summarized in

command set (on page 5-7).

4200A only

The KXCI command sets for the SMUs and PMUs and PGUs are similar to the command set used by the Keysight Model 4145B. This similarity allows many programs already developed for the Keysight Model 4145B to run on the 4200A-SCS.

Detailed information on the command set is presented after the tables.

Page commands

Page command Function

5-4 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

KXCI SMU commands

-SCS KXCI Remote Control Programming Section 5:

System mode commands

The system mode commands are listed in the following topics. Full descriptions are provided in

System mode commands (on page 5-8

DE page command str ings

The Channel Definition (DE) page command strings include:

• CH: SMU channel definition (on page 5-9)

• VS: VS1...VSn channel definit ion (on page 5-11)

• VM: VM1...VMn channel definition (on page 5-10)

SS page command strings

The Source Setup (SS) page command strings include:

• VR and IR: VAR1 setup (on page 5-21)

• VP and IP: VAR2 setup (on page 5-19)

• ST command: Auto standby (on page 5-16)

• FS command: VAR1' setup (on page 5-13)

• RT command: VAR1' setup (on page 5-14)

• VL and IL commands: List sweep setup (on page 5-18)

• VC and IC commands: SMU constant voltage or current setup ( on pag e 5-17)

• SC command: Constant VS setup (on page 5-16)

• HT command: Set sweep hold time (on page 5-14)

• DT command: Set sweep delay time (on page 5-12)

SM page command str ings

The measurement setup (SM) page command strings include:

• WT command: Set wait time (on page 5-26)

• IN command: Set interval (on page 5-24)

• NR command: Select number of readings (on pag e 5-26)

• DM command: Select display mode (on page 5-24)

• LI command: List mode, enables V and I functions for test sequence (on page 5-25)

• XN command: Configure graph X-axis for electric al par ameter (on page 5-27)

• XT command: Configure graph X-axis for time domain (on page 5-27)

• YA command: Configure graph Y1 axis (on pag e 5-28)

• YB command: Configure graph Y2 axis (on pag e 5-29)

4200A-SCS-907-01 Rev. C June 2022 5-5

Section

Programming

5: KXCI SMU commands Model 4200A-SCS KXCI Remote Control

MD page com mand strin gs

The measurement control (MD) page command string includes:

• ME command: Control measurements (on page 5-30)

Data output and file commands

The data output and file commands command strings are valid in any system mode page. They are:

• DO command: Obtain output data (on page 4-3)

• SR command: Set fixed source range (on pag e 5-34)

• SV command: Save file (on page 5-32)

• GT command: Get file ( o n page 5-31)

• MP command: Map channel (on page 5-33)

User mode commands

The user mode commands are provided in the following list. Full descriptions are provided in User

mode commands (on page 5-35).

• DI command: Current SMU setup (on page 5-35)

• DS command: VS1...VS9 setup (on page 5-36)

• DV command: Voltage SMU setup (on page 5-37)

• TI command: Current trigger ing (on page 5-38)

• TV command: Voltage triggering (on page 5-39)

5-6 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

KXCI SMU commands

-SCS KXCI Remote Control Programming Section 5:

Commands common to system and user modes

Some commands are common to the system and user modes, as listed below. Descriptions of these commands are provided in Commands common to system and user modes (on page 4-1

• AC command: Perform autocalibration (on page 4-2)

• BC command: Clear data buffer (on page 4-2)

• DO command: Return the timestamp data (on page 4-3)

• DR command: Control service request for Data Ready (on page 4-4)

• EC command: Exit on compliance (on page 4-4)

• EM command: Switch between 4145 and 4200A modes (on page 4-5)

• ID command: Retrieve instrument ID (on page 4-5)

• *IDN? command: Identification query (on page 4-6)

• IT command: Set integration time (on page 4-6)

• RD command: Request real-time readings ( on pag e 4-7)

• RG command: Set the lowest current-measurement range (on page 4-8)

• RI command: Instruct a SMU to go a specified range (on page 4-9)

• *RST command: Resets instrument settings to default settings (on page 4-10)

• RS command: Set global measurement resolution (on page 4-9)

• SP command: Acquire GPIB serial poll byte when using ethernet communications (on page 4-10)

4200A command set only

The 4200A command set only command is:

• *OPT? command: Get KXCI configuration of the 4200A-SCS (on page 4-20)

4200A-SCS-907-01 Rev. C June 2022 5-7

Section

Programming

5: KXCI SMU commands Model 4200A-SCS KXCI Remote Control

Command reference

Commands to control instrument operation are grouped as follows:

• System mode commands: This comprehensive set of commands allows you to use all the

source-measure capabilities of the SMUs installed in 4200A-SCS.

• User mode commands: This limited set of commands allows you to perform basic

source-measure operatio n.

• Common commands: These commands are valid in any operating mode.

These commands include 4200A only commands, which are valid only while using the 4200A command set instead of the 4145 Emulation command set.

Numeric values can be entered in fixed decimal format (for example, 0.1234) or floating decimal format (for example, 123.4e-3). Maximum number of characters for the value is 12. The maximum number of digits for an exponent is 2.

System mode commands

Most system mode commands are divided into groups, known as pages. In order to use these commands, the appropriate page has to be selected. System mode commands are grouped as follows. For the pages, the command to select the page is shown in parentheses.

• Channel definition page (DE)

• Source setup page (SS)

• Measurement setup page (SM)

• Measurement control page (MD)

• Data output and file commands (valid in any system mode page)

• Channel mapping command

• Fixed source ranging command

Channel definition page (DE)

Use the command strings for the DE page for the following operations:

• SMU channel definition

• VS1...VSn channel definition

• VM1...VMn channel definition

To send the channel definition command strings to the 4200A-SCS, you must select the channel definition page by sending the command:

5-8 4200A-SCS-907-01 Rev. C June 2022

Mode

KXCI SMU commands

1, 2, ... or n SMU channel number; the largest value of n is the number of channels in the channel is turned off

BBBBBB

Voltage name

CCCCCC

Current name

Source mode or common:

 3

Source function:

 4

l 4200A-SCS KXCI Remote Control Programming Section 5:

The channel command defines a SMU channel.

Usage

CHA CHA, 'BBBBBB', 'CCCCCC', D, E

the system (9 maximum); if no parameters are specified after the channel number,

 1: Voltage source mode  2: Current source mode

: Common (output high connected to common)

Details

 1: VAR1 sweep source function  2: VAR2 step source function  3: Constant (fixed) source function

: VAR1' source function

For every used channel that is configured as a SMU, you must specify names for voltage and current, select the source mode, and select the source function.

When the source mode (D) is set to common (3), the source function (E) must be set to constant (3). The VAR1 source function performs a linear or logarithmic sweep that is synchronized to the steps of

VAR2. The VAR1 sweep is performed whenever VAR2 goes to a new step value. The constant source function outputs a fixed (constant) source value.

The VAR1' source function is similar to the VAR1 function, except that each sweep step is scaled by the ratio value (RT) and an offset (FS) as follows:

VAR1' sweep step = (VAR1 sweep step × RT) + FS

For example, assume VAR1 is set to sweep from +1 V to +3 V using 1 V steps. If RT is set to 2, and FS is set to 1, each step of VAR1' is calculated as follows:

VAR1' step 1 = (1 V × 2) + 1 = 3 V VAR1' step 2 = (2 V × 2) + 1 = 5 V VAR1' step 3 = (3 V × 2) + 1 = 7 V

If you send CHA with no other parameters, the channel specified by A is disabled.

4200A-SCS-907-01 Rev. C June 2022 5-9

Section

Programming

DE CH3, 'V1', 'I1', 1, 3

This command string sets up the SMU assigned to channel 3 to source a fixed voltage (1 V). The specified

DE CH1; CH2; CH3; CH4

This command string disables channel s 1 throu gh 4.

Voltmeter channel: 1 to 9; the assigned value for a voltmeter depends on how instruments are mapped in KCon

BBBBBB

User-specified name (up to 6 characters)

VM1, 'VM1'

This command string defines the channel used for VM1 (specifies the name VM1).

5: KXCI SMU commands Model 4200A-SCS KXCI Remote Control

Example 1

Example 2

Also see

names for voltage and current are V1 and I1, respectively.

System mode commands (on page 5-5)

This command defines channels that are used as voltmeters.

Usage

VMA, 'BBBBBB'

Details

KXCI allows up to eight source-measure units (SMUs) to function solely as voltmeters. You can use any channel for any voltmeter function between VM1 and VM9. For example, in a system containing four SMUs, you can use SMU3 as VM7.

If you do not define one of the 4200A-SCS SMUs to emulate a VM, attempts to measure voltages through the nonexistent VM result in data values of 9.000e+37.

If nothing is specified after the prefix and channel number, the channel is not used. To measure voltage using the 4145B VM1...VMn function, define one of the 4200A-SCS SMUs to

emulate VM.

Example

Also see

5-10 4200A-SCS-907-01 Rev. C June 2022

None

Model 42

KXCI SMU commands

Voltage source (1 to 9); the assigned value depends on how instrume nts ar e mapped in KCon

BBBBBB

User-specified name (up to 6 characters)

Source function:

VS1, 'VS1', 1

This command string sets up the channel used by VS1 to perform a voltage sweep.

00A-SCS KXCI Remote Control Programming Section 5:

This command specifies the name and selects the source function for each voltage-source channel.

Usage

VSA, 'BBBBBB', C

 1: VAR1  2: VAR2  3: Constant



: VAR1'

Details

KXCI allows up to eight source-measure units to function solely as voltage sources. You can use any channel for any voltage-source function between VS1 and VS9. For example, in a system containing four SMUs, you can use SMU2 as VS5.

Example

Also see

For each voltage source that is used, you must specify a name and select the source function. The VAR1 function performs a voltage sweep that is synchronized to the steps of VAR2. The VAR1 source function performs a linear or logarithmic voltage sweep. The VAR1 sweep is done whenever VAR2 goes to a new step value. The VAR1' function is the same as VAR1 except that each step of the sweep is scaled by a specified ratio (RT) and offset (FS).

The constant source function outputs a fixed (constant) voltage source value. More information on source functions is available throughout this section.

If nothing is specified after the prefix and channel number, the channel is not used. To source voltage using the 4145B VS1...VSn function, define one of the 4200A-SCS SMUs to

emulate the VS.

None

4200A-SCS-907-01 Rev. C June 2022 5-11

Section

Programming

A.AAA

Delay time in seconds: 0 to 6.553

DT 1

This command string sets delay time to 1 s.

5: KXCI SMU commands Model 4200A-SCS KXCI Remote Control

Source setup page (SS)

The Source Setup (SS) commands set up the source functions of the SMUs, including the different types of sweeping.

Use SS command for the following operations:

• Sweep source setup (CH set to VAR1)

• Step source setup (CH set to VAR2)

• Source function setup (CH set to VAR1')

• Constant bias

• List sweep setup

• Interval or sweep delay time

• Sweep hold time

• RPM switching

• Compliance

To send the following command strings to the 4200A-SCS, you must first select the source setup page by sending the command:

This command sets the time to wait between when the output voltage is set and when the measurement is made in a sweep.

Usage

DT A.AAA

Details

Sets the time to wait between when the output voltage is set and when the measurement is made. The total time spent on each step in the sweep is a combination of this user-specified delay time and the time it takes to make a measure men t.

You typically use the delay time to allow the source to settle before making a measurement. For example, assume a delay time of 1 s. At each step of the sweep, the source is allowed to settle for 1 s before the measurement is made.

Example

Also see

None

5-12 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

KXCI SMU commands

AAA.A

Offset value: -210 to +210

Available SMU channel (1 to 9); if this parameter is not included, offset applies to all

VAR1'

-SCS KXCI Remote Control Programming Section 5:

This command sets the offset value when VAR1' is a selected source function.

Usage

FS ±AAA.A FS ±AAA.A,B

Details

channels that are configured to

When VAR1' is a selected source function, it does the VAR1 sweep with each step scaled by the ratio (RT) value and offset (FS) value as follows:

VAR1' sweep step = (VAR1 sweep step × RT) + FS

The VAR1 sweep shown in the example in VR and IR (on page 5-21) has five steps: 1 V

, 2 V, 3 V,

4 V, and 5 V. The corresponding VAR' sweep has the following steps when RT=3 and FS = 2:

VAR1' s

tep 1 = (1 V × 3) + 2 = 5 V

VAR1' step 2 = (2 V × 3) + 2 = 8 V VAR1' step 3 = (3 V × 3) + 2 = 11 V VAR1' step 4 = (4 V × 3) + 2 = 14 V VAR1' step 5 = (5 V × 3) + 2 = 17 V

This VAR1' sweep (not drawn to scale) is shown in the following figure.

Figure 10: VAR' sweep when ratio = 3 and full scale = 2

You can assign a unique offset value to any available SMU channel in the system.

4200A-SCS-907-01 Rev. C June 2022 5-13

Section

Programming

RT +3,2 FS +2,2

These command strings set up the VAR1' sweep shown in the figure in the Details (ratio = 3, offset = 2).

ratio is set to 3 and offset is set to 2.

AAA.A

655.3

HT 1

This command string sets the hold time to one second.

AAA.A

Ratio value: -10 to +10

Available SMU channel (1 to 9); if this parameter is not included, ratio applies to all

VAR1'

5: KXCI SMU commands Model 4200A-SCS KXCI Remote Control

Example

Also see

The above commands set up VAR1' for SMU channel 2. When channel 2 is defined for a VAR1' sweep,

None

This command sets a hold time that delays the start of a sweep.

Usage

HT AAA.A

Hold time in seconds: 0 to

Details

You can delay the start of a sweep by setting a hold time. When the sweep is triggered, it starts after the hold time expires.

For example, you can use the hold time to allow for the device to charge up and settle to the first bias point in the sweep before starting the sweep.

Example

Also see

None

This command sets the ratio value when VAR1' is a selected source function.

Usage

RT ±AA.A RT ±AA.A,B

channels that are configured to

5-14 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

KXCI SMU commands

RT +3,2 Ratio FS +2,2 Offset

These command strings set up the VAR1' sweep shown in the figure in the Details (ratio = 3, offset = 2).

ratio is set to 3 and offset is set to 2.

Details

-SCS KXCI Remote Control Programming Section 5:

When VAR1' is a selected source function, it does the VAR1 sweep with each step scaled by the ratio (RT) value and offset (FS) value as follows:

VAR1' sweep step = (VAR1 sweep step × RT) + FS

The VAR1 sweep shown in the example in VR and IR (on page 5-21

) has five steps: 1 V, 2 V, 3 V,

4 V, and 5 V. The corresponding VAR' sweep has the following steps when RT=3 and FS = 2:

VAR1' step 1 = (1 V × 3) + 2 = 5 V VAR1' step 2 = (2 V × 3) + 2 = 8 V VAR1' step 3 = (3 V × 3) + 2 = 11 V VAR1' step 4 = (4 V × 3) + 2 = 14 V VAR1' step 5 = (5 V × 3) + 2 = 17 V

This VAR1' sweep (not drawn to scale) is shown in the following figure.

Figure 11: VAR' sweep when ratio = 3 and full scale = 2

You can assign a unique ratio value to any available SMU channel in the system.

Example

The above commands set up VAR1' for SMU Channel 2. When Channel 2 is defined for a VAR1' sweep,

Also see

4200A-SCS-907-01 Rev. C June 2022 5-15

None

Section

Programming

Voltage source channel: 1 to 9; see Details

BBB.BBBB

Output voltage value: -210.00 to +210.00

SC1, 20

This command string sets up VS1 to output a constant 20 V level.

SMU channel number (1 to 9)

Enable or disable automatic standby:

 1: Enable automatic standby

5: KXCI SMU commands Model 4200A-SCS KXCI Remote Control

This command configures the source to output a fixed voltage level for channels that are configured to be voltage source only.

Usage

SCA, ±BBB.BBBB

Details

This command is for use with any channel configured solely as a VS1...VSn voltage source. It configures the source to output a fixed (constant) voltage level.

If nothing is specified after the channel number, the channel is turned off. The range of possible values for A depends on how instruments are mapped in KCon. The parameter

A represents the n in voltage source VSn.

Example

Also see

“Keithley Configuration Utility (KCon)” in Model 4200A -SCS Setup and Maintenance

This command controls automatic standby.

Usage

ST A, B

 0: Disable automatic standby

Details

When automatic standby is enabled, the SMU automatically goes into standby when the test completes. When disabled, the output stays on when the test completes.

Also see

5-16 4200A-SCS-907-01 Rev. C June 2022

None

Model 4200A

KXCI SMU commands

 Current: IC

SMU channel number: 1 to 9

Output value:

-1.0500

+1.0500

-1.0500

+1.0500

-SCS KXCI Remote Control Programming Section 5:

VC and IC

This command configures the SMU to output a fixed (constant) voltage or current level.

Usage

AAB, ±CCC.CCCC, ±DDD.DDDD

Source mode:

 Voltage: VC

Details

Also see

CCC.CCCC

 Voltage source: -210.00 to +210.00  Current source, 4200-SMU or 4201-SMU: -0.1050 to +0.1050



DDD.DDDD

Current source, 4210-SMU or 4211-SMU:

Compliance value:

 Voltage source: -210.00 to +210.00  Current source, 4200-SMU or 4201-SMU: -0.1050 to +0.1050



Current source, 4210-SMU or 4211-SMU:

For any channel configured as a SMU, this command configures the SMU to output a fixed (constant) voltage or current level.

With the voltage source mode (VC) specified in the command string, you set the current compliance. For the current source mode (IC), you set the voltage compliance.

None

4200A-SCS-907-01 Rev. C June 2022 5-17

Section

Programming

 Current source (SMU only): IL

Channel number: 1 to 9

Master or subordinate mode:

DDD.DDDD

Compliance value:

 Current source, 4210-SMU or 4211-SMU: -1.0500 to +1.0500

EE.EEEE

List values:

-1.0500

+1.0500

VL1,1, 0.01, 1, 5, 2

This command string sets up a channel 1 list sweep (1 V, 5 V, 2 V arbitrary steps, and compliance = 10 mA).

5: KXCI SMU commands Model 4200A-SCS KXCI Remote Control

VL and IL

This command sets up a list sweep.

Usage

AAB, C, ±DDD.DDDD, ±EE.EEEE, ... ±EE.EEEE

The source mode:

 Voltage source (SMU or VS1...VS9): VL

 Subordinate mode: 0



Master mode: 1

 Voltage source: -210.00 to +210.00  Current source, 4200-SMU or 4201-SMU: -0.1050 to +0.1050

Details

Example

Also see

 Voltage source: -210.00 to +210.00  Current source, 4200-SMU or 4201-SMU: -0.1050 to +0.1050



Current source, 4210-SMU or 4211-SMU:

A list sweep occurs in the order of the defined sweep parameters. If the source is a SMU, the source mode for the sweep can be voltage or current. If a voltage source (VS1...Sn) is used, the source mode must be voltage.

With the voltage source mode (VL) specified in the command string, you are setting the current compliance. For the current source mode (IL), you are setting the voltage compliance. If you are sourcing voltage, if you specify a compliance current that is below the minimum allowable value (100 pA with a preamplifier installed and 100 nA without a preamplifier), KXCI sets it to the mini mum allowable value.

The maximum number of points for the list is 4096. Sweep points must be delimited by commas.

None

5-18 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

KXCI SMU commands

The source mode:

SMU

BBB.BBBB

Start value:

-1.0500

+1.0500

CCC.CCCC

Step value:

 Current source, 4210-SMU or 4211-SMU: -1.0500 to +1.0500

Number of steps: 1 to 32

EEE.EEEE

Compliance value (see Details):

-1.0500

+1.0500

VAR2 source stepper index: 1 to 4 (see Details)

-SCS KXCI Remote Control Programming Section 5:

VP and IP

This command sets up the VAR2 step sweep.

Usage

AA ±BBB.BBBB, ±CCC.CCCC, DD, ±EEE.EEEE AA ±BBB.BBBB, ±CCC.CCCC, DD, ±EEE.EEEE, FF

 VP: Voltage source (SMU or VS1...VS8)



: Current source (

 Voltage source: -210.00 to +210.00  Current source, 4200-SMU or 4201-SMU: -0.1050 to +0.1050  Current source, 4210-SMU or 4211-SMU:

 Voltage source: -210.00 to +210.00  Current source, 4200-SMU or 4201-SMU: -0.1050 to +0.1050

only)

Details

 Voltage source: -210.00 to +210.00  Current source, 4200-SMU or 4201-SMU: -0.1050 to +0.1050



Current source, 4210-SMU or 4211-SMU:

With the voltage source mode (VP), the output value is in volts. For the current source mode (IP), the output value is in amperes.

If you specify a voltage start or step value below 0.001 V, KXCI automatically sets the value to zero. With the voltage source mode (VP), you are setting the current compliance. For the current source

mode (IP), you are setting the voltage compliance. When sourcing voltage (VP), if you specify a compliance current that is below the minimum allowable value (100 pA with a preamplifier installed and 100 nA without a preamplifier), KXCI sets it to the minimum allowable value.

If you are using is a SMU as the source, the source mode for the VAR2 steps can be voltage or current. If, however, a voltage source (VS1...VS9) is used, the source mode must be voltage. For configuration details, refer to “Keithley Configuration Utility (KCon)” in Model 4200A-SCS Setup and Maintenance.

If the source stepper index (FF) is omitted, the default is 1 (first stepper). Use the CH command to define one or more VAR2 sources. The first defined VAR2 is index = 1. The second channel is defined as VAR2 is index = 2, and so on up to a maximum of four VAR2 sources. Note that this is an extension to the traditional VAR2 capability.

4200A-SCS-907-01 Rev. C June 2022 5-19

Section

Programming

VP 5, 5, 3, 0.01

This command string sets up a VAR2 voltage sweep with start = 5 V, step = 5 V, number of steps = 3, and are the same steps that are shown synchronized with sweeps in VR and IR: VAR1 setup (on page 5-21).

5: KXCI SMU commands Model 4200A-SCS KXCI Remote Control

Parameters for the VAR2 step function include the start value, step value, and the number of steps. In the following figure, the VAR2 step function starts at 5 V, steps in 5 V increments and has three steps.

Figure 12: Steps resulting fr om the VP 5, 5, 3, 0.01 command string

Example

Also see

compliance = 10 mA. This command string performs the steps shown in the figure in the Details. These

CH: SMU channel definition (on page 5-9)

5-20 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

KXCI SMU commands

 IR: Current source (SMU only)

The sweep type:

 4: Log50 sweep

CCC.CCCC

Start value:

-1.0500

+1.0500

DDD.DDDD

Stop value:

-1.0500

+1.0500

EEE.EEEE

Step value (linear sweep only):

FFF.FFFF

Compliance value (also see Details):

For a log sweep, do not set a compliance value

-SCS KXCI Remote Control Programming Section 5:

VR and IR

This command sets up the VAR1 source function.

Usage

AAB, ±CCC.CCCC, ±DDD.DDDD, ±EEE.EEEE, ±FFF.FFFF

The source mode:

 VR: Voltage source (SMU or VS1...VS9)

 1: Linear sweep  2: Log10 sweep  3: Log25 sweep

 Voltage source: -210.00 to +210.00  Current source, 4200-SMU or 4201-SMU: -0.1050 to +0.1050



Current source, 4210-SMU or 4211-SMU:

Details

 Voltage source: -210.00 to +210.00  Current source, 4200-SMU or 4201-SMU: -0.1050 to +0.1050



Current source, 4210-SMU or 4211-SMU:

 Voltage source: -210.00 to +210.00  Current source, 4200-SMU or 4201-SMU: -0.1050 to +0.1050  Current source, 4210-SMU or 4211-SMU: -1.0500 to +1.0500

For a log sweep, do not set a step value (steps are determined by the setting for B)

 Voltage source: -210.00 to +210.00  Current source, 4200-SMU or 4201-SMU: -0.1050 to +0.1050  Current source, 4210-SMU or 4211-SMU: -1.0500 to +1.0500

If you specify a voltage start or step value below 0.001 V, KXCI automatically sets the value to zero. When setting the step value, be aware that the maximum number of points for VAR1 is 1024:

Number of points = (int)(Abs((Stop Value - Start Value) / Step Value) + 1.5)

4200A-SCS-907-01 Rev. C June 2022 5-21

Section

Programming

5: KXCI SMU commands Model 4200A-SCS KXCI Remote Control

When you are setting a voltage source mode (VR), you are setting a current compliance value. If you are setting a current source mode (IR), you are setting voltage compliance. When sourcing voltage, note that if you specify a compliance current that is below the minimum allowable value (100 pA with a preamplifier installed and 100 nA without a preamplifier), KXCI sets it to the minimum allowabl e value.

When VAR1 is a selected source function, it does a sweep that is synchronized to the steps of the VAR2 step function. The VAR1 sweep is repeated whenever VAR2 goes to a new step value, as shown in the following figure.

Figure 13: Synchronized VAR1 sweeps and VAR2 steps

If the source is a SMU, the source mode for the sweep can be voltage or current. If, however, a voltage source (VS1...Sn) is used, the source mode must be voltage.

You can do the sweep on a linear or logarithmic scale. With the linear sweep mode selected, the start, stop, and step value parameters define the sweep. Each VAR1 sweep in the figure above sweeps from 1 V (start) to 5 V (stop) in 1 V steps.

5-22 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

KXCI SMU commands

VR1, 1, 5, 1, 0.01

This command string sets up a VAR1 linear sweep with a start = 1 V, stop = 5 V, step = 1 V, and

-SCS KXCI Remote Control Programming Section 5:

With a logarithmic sweep mode selected (log base 10, 25, or 50), only specify the start and stop values. Step size is automatically set to provide a symmetrical sweep on the logarithmic scale.

Example

Also see

The time spent on each sweep step depends on the user-s

et delay time and the time it takes to

perform the measurement.

You can delay the start of the sweep by setting a hold time.

compliance = 10 mA. The following figure shows the sweep that results from this setup. The figure in the Details shows the results of the same setup when used with a VAR2 step command.

None

Measurement setup page (SM)

Use the command strings for the SM page for the following operations:

• Set wait time

• Set interval

• Select number of readings

• Select list display mode

• Configure the X and Y data

To send the following command strings to the 4200A-SCS, select the SM page by sending the command:

4200A-SCS-907-01 Rev. C June 2022 5-23

Section

Programming

 List display mode: 2

DM1

This command string prepares the 4200A-SCS to receive graphics commands.

AA.AA

Interval in seconds: 0.01 to 10

IN 0.1

This command string sets the interval to 100 ms.

5: KXCI SMU commands Model 4200A-SCS KXCI Remote Control

This command selects the Keysight 4145B display mode.

Usage

DMA

Display modes:

 Graphics display mode: 1

Details

The 4200A-SCS supports the Keysight 4145B graphics display mode and the Keysight 4 14 5 B lis t display mode command.

The 4200A-SCS does not accept the matrix mode and SMU mode commands (DM3 and DM4).

Example

Also see

None

This command sets the time between sample measurements.

Usage

IN AA.AA

Details

For time domain measurements, you can set the time between sample measurements. After a sample measurement is made, the next measurement starts after the time interval expires.

For constant bias measurements, this is the time between readings.

Example

Also see

None

5-24 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

KXCI SMU commands

AAAAAA

A name assigned for CH, VS, or VM; see channel definition page (DE)

L1 'V1', 'I1', 'VS1'

Assume the following names have been assigned us ing the DE page for SMU channel 1 (CH1):

The command string enables the above functions for a test sequence.

-SCS KXCI Remote Control Programming Section 5:

This command enables voltage and current functions to be measured when the 4200A-SCS is in list display mode.

Usage

LI 'AAAAAA' LI 'AAAAAA', 'AAAAAA' LI 'AAAAAA', 'AAAAAA', 'AAAAAA' LI 'AAAAAA', 'AAAAAA', 'AAAAAA', 'AAAAAA' LI 'AAAAAA', 'AAAAAA', 'AAAAAA', 'AAAAAA', 'AAAAAA' LI 'AAAAAA', 'AAAAAA', 'AAAAAA', 'AAAAAA', 'AAAAAA', 'AAAAAA'

Details

When the 4200A-SCS is in the list display mode (DM2 asserted), the LI command enables functions to be measured in a test sequence. To enable a function, include the SMU channel name (as assigned by the CH command), voltage source name (as assigned by the VS command), or the voltmeter name (as assigned by the VM command) in the command string. The DE page is used to assign names to voltage and current functions.

Example

Also see

Only functions that are specified (enabled) are measured. Data sheet columns for disabled functions are not shown.

 Voltage is named V1  Current is named I1  Voltage source is named VS1

Channel definition page (DE) (on page 5-8) DM (on page 5-24)

4200A-SCS-907-01 Rev. C June 2022 5-25

Section

Programming

AAAA

 4145 Emulation command set: 1 to 1024

NR 200

This command string sets up the 4200A-SCS to make 200 sample measurements.

AAA.AAA

100

WT 0.1

This command string sets the wait time to 100 ms.

5: KXCI SMU commands Model 4200A-SCS KXCI Remote Control

This command sets the number of readings that can be made for time domain measurements.

Usage

NR AAAA

Number of measurements to make:

 4200A command set: 1 to 4096

Details

For time domain measurements, you can set the number of sample measurements that can be made. The readings are stored in the buffer.

Example

Also see

None

This command delays the start of a test sequence for time domain measurements.

Usage

WT AAA.AAA

Wait time in seconds: 0 to

Details

For time domain measurements, you can delay the start of a test sequence by setting a wait time. The test sequence starts after the wait time period expires.

For the sampling mode or constant bias, this command is a delay after the source output level is set and before the readings begin.

Example

Also see

None

5-26 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

KXCI SMU commands

AAAAAA

The SMU channel name for the X-axis; up to 6 characters long; must be one of the

 Log scale: 2

CCCC.CCC

X-axis minimum value

±999

DDDD.DDD

X-axis maximum value

±999

XN 'V1', 1, -5, 5

 Sets up the X-axis to be scaled linearly between

5 V and +5 V.

AAAA.AA

X-axis minimum time value (in seconds): 0.01 to 9999

BBBB.BB

X-axis maximum time value (in seconds): 0.01 to 9999

XT 0, 10

This command string:

 Sets up the X-axis to be scaled between 0 s and 10 s.

-SCS KXCI Remote Control Programming Section 5:

This command configures the X-axis of the graph to plot an electrical parameter.

Usage

XN 'AAAAAA', B, ±CCCC.CCC, ±DDDD.DDD

SMU channel names that you specify on the channel definition (DE) page X-axis scale type

 Linear scale: 1

 Volts: ±9999



Amperes:

 Volts: ±9999



Amperes:

Example

This command string:

 Specifies that values from SMU channel V1 are to be plotted on the X-axis.

−

Also see

Channel definition page (DE) (on page 5-8)

This command configures the X-axis of the graph to plot time domain values in seconds.

Usage

XT AAAA.AA, BBBB.BB

Example

 Specifies that time domain values are to be plotted on the X-axis.

Also see

4200A-SCS-907-01 Rev. C June 2022 5-27

None

Section

Programming

AAAAAA

The SMU channel name for the Y1-axis, up to 6 characters; must be one of the

B CCCC.CCC

Y1-axis minimum value :

±999

DDDD.DDD

Y1-axis maximum value :

 Amps: ±999

YA 'I1', 1, -5E-9, 5E-9

This command string:

 Sets up the Y1-axis to be scaled linearly between −5 nA and +5 nA.

5: KXCI SMU commands Model 4200A-SCS KXCI Remote Control

This command configures the Y1-axis of the graph.

Usage

YA 'AAAAAA', B, ±CCCC.CCC, ±DDDD.DDD

SMU channel names that you specify on the channel definition (DE) page Y1-axis scale type:

 Linear scale: 1  Log scale: 2



Log scale absolute value: 3

 Volts: ±9999



Amps:

 Volts: ±9999

Example

Also see

 Specifies that values from SMU channel I1 are to be plotted on the Y1-axis.

Channel definition page (DE) (on page 5-8)

5-28 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

KXCI SMU commands

AAAAAA

The SMU channel name for the Y2-axis, up to 6 characters; must be one of the

B CCCC.CCC

Y2-axis minimum value

±999

DDDD.DDD

Y2-axis maximum value

 Amperes: ±999

YB 'I2', 2, 100E-9, 1E-3

The command string:

 Sets up the Y2-axis to be scaled logarithmically between 10 0 nA and 1 mA.

-SCS KXCI Remote Control Programming Section 5:

This command configures the Y2-axis of the graph.

Usage

YB 'AAAAAA', B, ±CCCC.CCC, ±DDDD.DDD

SMU channel names that you specify on the channel definition (DE) page Y2 axis scale type:

 Linear scale: 1  Log scale: 2



Log scale absolute value: 3

 Volts: ±9999



Amperes:

 Volts: ±9999

Example

Also see

 Specifies that values from SMU channel I2 are to be plotted on the Y2-axis.

Channel definition page (DE) (on page 5-8)

4200A-SCS-907-01 Rev. C June 2022 5-29

Section

Programming

Measurement action:



ME1

This command string triggers the start of the test and stores the readings in the cleared buffer.

5: KXCI SMU commands Model 4200A-SCS KXCI Remote Control

Measurement control p ag e (MD)

The measurement control page contains the command to trigger a test. To send the command string to control measurements, select the measurement control page by

sending the command:

This command controls measurements.

Usage

MEA

 Run a single trigger test and store readings in a cleared buffer: 1  Run a repeat trigger test and store readings in a cleared buffer: 2  Run a single trigger test and append readings to the buffer: 3

Abort the test: 4

Details

Example

Also see

The ME1 or ME2 command triggers the start of the test and makes the programmed number of measurements. The measured readings are stored in the buffer. Note that the buffer is cleared before readings are stored.

The ME3 command also triggers the test but does not clear the buffer before storing the measured readings. The readings are appended to the readings already stored in the buffer. The buffer can hold up to 4096 readings.

The ME4 command aborts the test.

None

5-30 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

CI SMU commands

File type:

BBBBB

GT 'P Setup1'

This command string gets the program file named Setup1.

-SCS KXCI Remote Control Programming Section 5: KX

Data output and file commands

The command strings for the following operations are valid in any system mode page:

• Obtain output data

• Save file

• Get file

This command acquires (loads) the saved data file or program file.

Usage

GT 'A BBBBBB'

 Program file: P



Data/program file: D

Name of file (up to 6 characters)

Details

Example

Also see

The file type and file name must be separated by a space. For a program file, this command launches the program. For a data file, it opens the files. When the

saved program file is recalled, the instrument returns to the settings stored in that file.

The save (SV

SV command: Save file (on page 5-32)

) command string is used to save instrument settings or to store data acquired in a test.

4200A-SCS-907-01 Rev. C June 2022 5-31

Section

Programming

File type:

BBBBB

Name of file (up to 6 characters)

CCCCCCCC

Comment (up to 8 characters)

SV 'P Setup1'

This command string saves the command sequence as a program file named Setup1.

5: KXCI SMU commands Model 4200A-SCS KXCI Remote Control

This command saves a program file or data file.

Usage

SV 'A BBBBBB' SV 'A BBBBBB CCCCCCCC'

 Program file: P



Data file: D

Details

You must separate the file name and the comment from each other by a space. When saving a program file, the present instrument settings are stored in a file at the directory path:

Example

Also see

C:\s4200\sys\KXCI

You specify the name for the file.

The get command string is used to acquire the saved file.

GT command: Get file (on pag e 5-31)

5-32 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

MU commands

The channel to be mapped: A value between 1 and the num ber of channe ls in the BBB

SMU, VS, or VM

The number of the SMU, VS, or VM

MP 3, VM5

This command string maps channel 3 to VM5.

-SCS KXCI Remote Control Programming Section 5: KXCI S

Channel mapping command

You can use the following command with any system mode page. It maps channel n to a given VS, SMU, or VM function.

This command maps channel n to a given VS, SMU, or VM function.

Usage

MP A, BBBC

system (9 maximum)

Details

Example

Also see

If BBB and C are not included in the command, the function defaults to SMU<A>, where <A> is the number of the channel to be mapped.

None

4200A-SCS-907-01 Rev. C June 2022 5-33

Section

Programming

The channel to be controlled: Aa value between 1 and the number of channels in

1.0

SR 1, 2

This command string selects best fixed range on channel 1.

5: KXCI SMU commands Model 4200A-SCS KXCI Remote Control

Fixed source ranging comm and

You can use the following command with any system mode page.

This command sets a fixed source range on channel n.

Usage

SR A, B

the system (9 maximum) Range:

 Auto: 0  Best fixed range (determined by maximum sweep parameters): 2



Fixed range: > 0 to

Details

Example

Also see

The default setting is autorange for backward compatibility. If you specify a range that is below the bias or sweep parameters that follow, the range is adjusted to accommodate the sweep.

None

5-34 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

ommands

SMU channel: 1 to 9

DDD.DDDD

Output value (amperes):



−1.0500

+1.0500

EEE.EEEE

Compliance value (voltage): −210.00 to 210.00

-SCS KXCI Remote Control Programming Section 5: KXCI SMU c

User mode commands (US)

You can use the user mode (US) command strings for the following operations:

• SMU setup

• VS1...VS9 setup

• Triggering

To send these command strings to the 4200A-SCS, select the user mode by sending the command:

This command sets up a SMU channel as a current source.

Usage

DIB DIB, CC, ±DDD.DDDD, ±EEE.EEEE

Current source range:

 Autorange: 0  1 nA range (only with a preamplifier): 1  10 nA range (only with a preamplifier): 2  100 nA range: 3  1 μA range: 4  10 μA range: 5  100 μA range: 6  1 mA range: 7  10 mA range: 8  100 mA range: 9  1 A range (only with a 4210-SMU or 4211-SMU): 10  1 pA range (only with a preamplifier): 11  10 pA range (only with a preamplifier): 12



100 pA range (only with a preamplifier): 13

 4200-SMU or 4201-SMU: −0.1050 to +0.1050

4210-SMU or 4211-SMU:

4200A-SCS-907-01 Rev. C June 2022 5-35

Section

Programming

DI1, 1, 10, 1, 20

This command string configures SMU1 to source 1 nA on the 1 A source range and sets voltage compliance to 20 V.

n, for voltage source VSn; range 1 to 9

BBB.BBBB

-200.00

+200.00

DS1, 20

This command string sets VS1 to output 20 V.

Details

5: KXCI SMU commands Model 4200A-SCS KXCI Remote Control

For every channel that is configured as a SMU, you must select the source mode (voltage or current), source output range, output value, and compliance value.

To select the voltage source mode, see DV (on page 5-37

If you send DIB with no other parameters, the output of the specified channel is disabled.

Example

Also see

DV (on page 5-37)

This command specifies the channel number and the voltage output value for each voltage source.

Usage

DSA, ±BBB.BBBB

Output voltage value:

Details

KXCI allows up to nine source-measure units to function solely as voltage sources. You can use any channel for any voltage-source function between VS1 and VS9. For example, in a system containing four SMUs, you can use SMU2 as VS5.

The assigned n value for a voltage source (VSn) or voltmeter (VMn) depends on how instruments are mapped in KCon.

Example

Also see

5-36 4200A-SCS-907-01 Rev. C June 2022

None

Model 4200A

nds

SMU channel: 1 to 9

Voltage source range:

 2 V range: 5 (only with a preamplifier)

DDD.DDDD

Output value (voltage): −210.00 to +210.00

EEE.EEEE

Current compliance value (amperes):

−1.0500

+1.0500

DV1, 1, 10, 10E-3

This command string configures SMU1 to source 10 V on the 20 V source range and sets current compliance to 10 mA.

-SCS KXCI Remote Control Programming Section 5: KXCI SMU comma

This command sets up a SMU channel as a voltage source.

Usage

DVB DVB, CC, ±DDD.DDDD, ±EEE.EEEE

 Autorange: 0  20 V range: 1  200 V range: 2 or 3  200 mV range: 4 (only with a preamplifier)

Details

Example

Also see

 4200-SMU or 4201-SMU: −0.1050 to +0.1050



4210-SMU or 4211-SMU:

For every channel that is configured as a SMU, you must select the source mode (voltage or current), source output range, output value, and compliance value.

To select the current source mode, see DI (on page 5-35

If you specify a compliance current that is below the minimum-allowable value, KXCI sets it to the minimum allowable value.

If you send DVB with no other parameters, the output of the specified channel is disabled.

DI (on page 5-35)

4200A-SCS-907-01 Rev. C June 2022 5-37

Section

Programming

5: KXCI SMU commands Model 4200A-SCS KXCI Remote Control

This command triggers a current measurement.

Usage

TI AABB

Measure channel for current measureme nts :

 SMU1: 1  SMU2: 2  SMU3: 3  SMU4: 4  SMU5: 5  SMU6: 6  SMU7: 7



Details

SMU8: 8

Also see

After sending the command string to trigger a measurement and addressing the 4200A-SCS to talk, the output data string is sent to the computer in the following format:

X Y Z ±N.NNNN E±NN

Where:

• X: The status of the data (where X = N for a normal reading)

• Y: The measure channel (Y = A through F)

• Z: The measure mode (Z = V or I)

• ±N.NNNN E±NN is the reading (mantissa and exponent)

• When channels are mapped to different functions (VM or VS), KXCI tries to trigger measurements

on the specified channels. However, if the mapped function for a channel does not match the requested measurement, KXCI reports an error. For example, if the mapped function for a channel is VS2, but the requested measurement is TI2, KXCI reports an error, because a VS cannot measure current.

TV (on page 5-39) VM (on page 5-10) VS (on page 5-11)

5-38 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

KXCI SMU commands

 VM8: 16

-SCS KXCI Remote Control Programming Section 5:

This command triggers a voltage measurement.

Usage

TV BB

Measure channel for voltage mea sure ment s:

 SMU1: 1  SMU2: 2  SMU3: 3  SMU4: 4  VM1: 5  VM2: 6  SMU5: 7  SMU6: 8  SMU7: 9  SMU8: 10  VM3: 11  VM4: 12  VM5: 13  VM6: 14  VM7: 15

Details

You can use a SMU to measure voltage either directly (as mapped SMU1 to SMU9) or as a mapped voltmeter (VM1 to VM9), so the SMU is specified in the trigger command string by a unique identifier. For example, a physical SMU that has been mapped as SMU5 (using KCon) is specified by the unique identifier 7.

After sending the command string to trigger a measurement and addressing the 4200A-SCS to talk, the output data string is sent to the computer in the following format:

X Y Z ±N.NNNN E±NN

Where:

• X: The status of the data (where X = N for a normal reading)

• Y: The measure channel (Y = A through F)

• Z: The measure mode (Z = V or I)

• ±N.NNNN E±NN is the reading (mantissa and exponent)

4200A-SCS-907-01 Rev. C June 2022 5-39

Section

Programming

5: KXCI SMU commands Model 4200A-SCS KXCI Remote Control

Also see

When channels are mapped to different functions (VM or VS), KXCI tries to trigger measurements on the specified channels. However, if the mapped function for a channel does not match the requested measurement, KXCI reports an error. For example, if the mapped function for a channel is VS2, but the requested measurement is TI2, KXCI reports an error, because a VS cannot measure current.

TI (on page 5-38) VM (on page 5-10) VS (on page 5-11)

5-40 4200A-SCS-907-01 Rev. C June 2022

Code examples .......................................................................6-24

In this section:

KXCI CVU commands ..............................................................6-1

Summary of KXCI CVU commands ..........................................6-2

User mode commands ..............................................................6-3

System mode commands..........................................................6-7

Modeless commands ..............................................................6-15

KXCI CVU commands

The commands in the capacitance-voltage unit (CVU) user and system command modes control the CVU using KXCI. This mimics the paradigm used to control the SMUs in I-V tests.

Section 6

KXCI CVU commands

In user mode, all commands are processed sequentially and you have full control over the execution sequence and flow control. When a measurement is complete, only one point is generated (such as R + Jx, Cp, Gp, Cs, or Rs). User mode is similar to using the LPT library when running locally.

In system mode, when you send the run command, the system buffers and executes all CVU test parameters automatically. The CVU card executes full sweeps. The output sequencing, settling, and sweeping are all handled internally. The 4200A-SCS returns the entire buffer of test data. System mode is similar to running Clarius tests.

Many of the CVU commands are valid in both user and system mode, so they are considered to be modeless commands. Processing of these commands depends on the selected mode. If user mode is selected, the command is processed immediately and sent directly to the card. If system mode is selected, the parameter is buffered in a test object, and does not take effect until the execute command is sent. At that time, the CVU firmware acts on the settings and executes the test sequence.

To select the mode, use the :CVU:MODE (on page 6-19 To set the mode to user, send:

:CVU:MODE 0

To set the mode to system, send:

) command.

:CVU:MODE 1

All the commands act on the selected card, which is set using the :CVU:CHANNEL command.

Section

Programming

User

:CVU:CABLE:COMP:LOAD (on page 6-4)

Performs load compensation and collects the load compensation cable data for the CVU.

the CVU.

User

:CVU:CABLE:COMP:OPEN (on page 6-5)

Performs open compensation and collect s the open compensation cable data for the CVU.

User

:CVU:CABLE:COMP:SHORT (on page 6-6)

Performs short compensation and coll ect s the short compensation cable data for the CVU.

User

:CVU:MEASZ? (on page 6-7)

Triggers and returns a single Z measurement using the present CVU settings.

System

:CVU:BIAS:DCV:SAMPLE (on page 6-7)

Configures the CVU card to bias a dc voltage

System

:CVU:DATA:FREQ? (on page 6-7)

Queries the frequency measuremen t of the CVU when a test is complete.

Queries the status of the CVU when a test is complete.

System

:CVU:DATA:TSTAMP? (on page 6-8)

Queries the timestamp of the measurements of the CVU when a test is complete.

System

:CVU:DATA:VOLT? (on page 6-8)

Queries the voltage measurement of the CVU when a test is complete.

System

:CVU:DATA:Z? (on page 6-8)

Queries the Z measurement of the CVU when a test is complete.

System

:CVU:DELAY:STEP (on page 6-9)

Sets the hold time for the CVU test on the

:CVU:SWEEP:DCV

System

:CVU:DELAY:SWEEP (on page 6-9)

Sets the sweep delay for the CVU test on the selected card.

System

:CVU:SAMPLE:HOLDT (on page 6-10)

Sets the hold time for a sampling mode test on the selected card.

Sets the delay between samples for the selected card.

System

:CVU:SOAK:DCV (on page 6-11)

Sets the presoak dc voltage for all sweeps for the selected CVU card.

System

:CVU:STANDBY (on page 6-11)

Configures the selected CVU card to disable dc active.

System

:CVU:STEP:FREQ (on page 6-11)

Configures the selected CVU card to step frequency and sample Z measurements.

System

:CVU:SWEEP:ACV (on page 6-12)

Configures the selected CVU card to sweep ac voltage and sample Z measurements.

System

:CVU:SWEEP:DCV (on page 6-12)

Configures the selected CVU card to sweep dc voltage and sample Z measurements.

System

:CVU:SWEEP:FREQ (on page 6-13)

Configures the selected CVU card to sweep frequency and sample Z measurements.

System

:CVU:SWEEP:LISTDCV (on page 6-14)

Configures the selected CVU card to sweep measurements.

System

:CVU:TEST:ABORT (on page 6-14)

Stops a running KXCI CVU test.

6: KXCI CVU commands Model 4200A-SCS KXCI Remote Control

Summary of KXCI CVU comman ds

Mode Command Brief description

User :CVU:CABLE:COMP:MEASCUSTOM (on

page 6-5)

System :CVU:DATA:STATUS? (on page 6-8)

Performs custom cable-length com pen sati on and collects the compensation cable data for

and sample n Z measurements.

selected card for the :CVU:SWEEP:FREQ and

operations.

System :CVU:SAMPLE:INTERVAL (on page 6-10)

6-2 4200A-SCS-907-01 Rev. C June 2022

bias at the end of a test or to leave the dc bias

arbitrary dc voltage points and sample Z

Model 4200A

KXCI CVU commands

System

:CVU:TEST:RUN (on page 6-14)

Starts a CVU test on the specified card.

Modeless

:CVU:ACV (on page 6-15)

Sets the ac drive level for specified CVU card.

Modeless

:CVU:ACZ:RANGE (on page 6-15)

Sets the ac measurement range for the specified CVU card.

Modeless

:CVU:CHANNEL (on page 6-16)

Selects the CVU card on which subsequent CVU commands will act.

Modeless

:CVU:CONFIG:ACVHI (on page 6-16)

Defines the source terminal (ac only) for the CVU test.

Modeless

:CVU:CONFIG:DCVHI (on page 6-16)

Defines the source terminal (dc only) for the CVU test.

Modeless

:CVU:CORRECT (on page 6-17)

Enables or disables open, short, and load correction for the specified CVU card.

Modeless

:CVU:DCV (on page 6-17)

Sets the dc bias voltage for the specified CVU card.

Modeless

:CVU:DCV:OFFSET (on page 6-18)

Applies an offset value to the dc low terminal.

Modeless

:CVU:FREQ (on page 6-18)

Sets the frequency for the ac source for the specified CVU card.

Modeless

:CVU:FSTEPSIZE (on page 6-10)

Configures the frequency step size for the selected 4215-CVU card.

Modeless

:CVU:LENGTH (on page 6-19)

Selects the cable length for the specified CVU card.

Modeless

:CVU:MODE (on page 6-19)

Sets the mode to User or System.

Modeless

:CVU:MODEL (on page 6-20)

Sets the measurement model for the selected CVU card.

Modeless

:CVU:OUTPUT (on page 6-20)

Enables or disables the CVU output.

Modeless

:CVU:RESET (on page 6-21)

Sends a soft reset to the specified card.

CVU card.

Modeless

:CVU:TEST:COMPLETE? (on page 6-24)

Queries the status of the test.

-SCS KXCI Remote Control Programming Section 6:

Mode Command Brief description

Modeless :CVU:SPEED (on page 6-21) Sets the measurement speed for the selected

User mode commands

4200A-SCS-907-01 Rev. C June 2022 6-3

Section

Programming

length

7.0

load

The load value

6: KXCI CVU commands Model 4200A-SCS KXCI Remote Control

:CVU:CABLE:COMP:LOAD

This command performs load compensation and collects the load compensation cable data for the CVU.

Usage

:CVU:CABLE:COMP:LOAD length, load

The length of the cable:

 0: ≤ 0.5 m  1.5: >0.5 m to < 2.5 m  3.0: ≥ 2.5 m to 5 m  4.0: Custom  5.0: CVIV 2W  6.0: CVIV 4W black 0.75 m cable



Details

: CVIV 4W blue 0.61 m ca ble

Also see

If you use the custom setting, run :CVU:CABLE:COMP:MEASCUSTOM before sending the :CVU:CABLE:COMP:LOAD command.

Custom cable compensation supports only one set of cable constants for a CVU. For example, if you run custom cable compensation for CVU2 and CVU1, the constants for CVU2 are lost.

To enable or disable load compensation, send :CVU:CORRECT. For additional information on cable compensation, refer to “Connection compensation” in the Model

4200A-SCS Capacitance-Voltage Unit (CVU) User’s Manual.

:CVU:CABLE:COMP:MEASCUSTOM (on page 6-5) :CVU:CORRECT (on page 6-17)

6-4 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

KXCI CVU commands

length

7.0

-SCS KXCI Remote Control Programming Section 6:

:CVU:CABLE:COMP:MEASCUSTOM

This command performs custom cable-length compensation and collects the compensation cable data for the CVU.

Usage

:CVU:CABLE:COMP:MEASCUSTOM

Details

If you are using the custom parameter for the open, short, or load commands, send the :CVU:CABLE:COMP:MEASCUSTOM command before sending those commands.

For additional information on cable compensation, refer to “Connection compensation” in the Model 4200A-SCS Capacitance-Voltage Unit (CVU) User’s Manual.

Also see

:CVU:CABLE:COMP:LOAD (on page 6-4) :CVU:CABLE:COMP:OPEN (on page 6-5) :CVU:CABLE:COMP:SHORT (on page 6-6)

:CVU:CABLE:COMP:OPEN

This command performs open compensation and collects the open compensation cable data for the CVU.

Usage

:CVU:CABLE:COMP:OPEN length

The length of the cable:

 0: ≤ 0.5 m  1.5: >0.5 m to < 2.5 m  3.0: ≥ 2.5 m to 5 m  4.0: Custom  5.0: CVIV 2W  6.0: CVIV 4W black 0.75 m cable



Details

If you use the custom setting, send the :CVU:CABLE:COMP:MEASCUSTOM command before sending the :CVU:CABLE:COMP:OPEN command.

Custom cable compensation supports only one set of cable constants for a CVU. For example, if you run custom cable compensation for CVU2 and CVU1, the constants for CVU2 are lost.

To enable or disable load compensation, send the CVU:CORRECT command.

: CVIV 4W blue 0.61 m ca ble

4200A-SCS-907-01 Rev. C June 2022 6-5

Section

Programming

length

The length of the cable:

 7.0: CVIV 4W blue 0.61 m cabl e

6: KXCI CVU commands Model 4200A-SCS KXCI Remote Control

For additional information on cable compensation, refer to “Connection compensation” in the Model 4200A-SCS Capacitance-Voltage Unit (CVU) User’s Manual.

Also see

:CVU:CABLE:COMP:MEASCUSTOM (on page 6-5) :CVU:CORRECT (on page 6-17)

:CVU:CABLE:COMP:SHORT

This command performs short compensation and collects the short compensation cable data for the CVU.

Usage

:CVU:CABLE:COMP:SHORT length

 0: ≤ 0.5 m  1.5: >0.5 m to < 2.5 m  3.0: ≥ 2.5 m to 5 m  4.0: Custom  5.0: CVIV 2W  6.0: CVIV 4W black 0.75 m cable

Details

Also see

If you use the custom parameter, send the :CVU:CABLE:COMP:MEASCUSTOM command before sending the :CVU:CABLE:COMP:SHORT command.

Custom cable compensation supports only one set of cable constants for a CVU. For example, if you run custom cable compensation for CVU2 and CVU1, the constants for CVU2 are lost.

To enable or disable load compensation, send the CVU:CORRECT command. For additional information on cable compensation, refer to “Connection compensation” in the Model

4200A-SCS Capacitance-Voltage Unit (CVU) User’s Manual.

:CVU:CABLE:COMP:MEASCUSTOM (on page 6-5) :CVU:CORRECT (on page 6-17)

6-6 4200A-SCS-907-01 Rev. C June 2022

Model 4200A

KXCI CVU commands

biasv

−30

+30

samples

4096

-SCS KXCI Remote Control Programming Section 6:

:CVU:MEASZ?

This command triggers and returns a single Z measurement using the present CVU settings.

Usage

:CVU:MEASZ?

Details

When the command is complete, the single reading is available.

Also see

None

System mode comman ds

The CVU system mode commands are similar to Clarius tests. When you send the run command, the system buffers and executes all CVU test parameters automatically. The CVU executes full sweeps. The output sequencing, settling, and sweeping are all handled internally on the CVU.

:CVU:BIAS:DCV:SAMPLE

This command configures the CVU card to bias a dc voltage and sample n Z measurements.

Usage

:CVU:BIAS:DCV:SAMPLE biasv, samples

Voltage to source when sampling Z-measurements: The number of Z-measurements the CVU makes for the test operation: 1 to

Details

Configures the CVU to bias a dc voltage and sample n Z measurements for the CVU card. The other parameters are set by their respective commands.

Also see

None

:CVU:DATA:FREQ?

This command queries the frequency measurement of the CVU when a test is complete.

Usage

:CVU:DATA:FREQ?

Also see

4200A-SCS-907-01 Rev. C June 2022 6-7

None

Tektronix 4200A-SCS User manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Safety precaut ions

Table of contents

Introduction

Introduction

KXCI communication connections

KXCI communications connections

GPIB connections

Ethernet connections

Using KCon to configure KXCI

Set up KXCI for GPIB control

Set up KXCI for ethernet control

Setting up KXCI as a 4145B emulator

GPIB communications

GPIB status indicators (GPIB communications only)

Graph display

Error messages

Ethernet communications

KXCI ethernet client driver

Driver functions

Example write and read with ethernet

Using KXCI

Using KXCI

Output data formats

Data format for system mode readings

Data format for user mode readings

Status byte and serial polling

Status byte

Bit B0, Data Ready

Bit B1, Syntax Error

Bit B4, Busy

Bit B6, RQS (request for service)

Serial polling

Waiting for SRQ

Sample programs

Program 1: VAR1 and VAR2 sweep (system mode)

Program 2: Basic source-measure (user mode)

Program 3: Retrieving saved data (system mode)

Logging commands, errors, and test results

Logging commands

Logging errors

Logging test results

Understanding the log file

Graphing the test results

KXCI common commands

Commands common to system and user modes

*IDN?

*RST

Calling KULT user l ibraries remotely

Summary of commands for remote calls

SystemUtil User Library

instrumentinfo

remotemoduleinfo

systeminfo

4200A command set only commands

*OPT?

KXCI SMU commands

KXCI SMU commands

SMU default settings

System mode SMU default settings

Control commands

Page commands

System mode commands

DE page command str ings

SS page command strings

SM page command str ings

MD page com mand strin gs

Data output and file commands

User mode commands

Commands common to system and user modes

4200A command set only

Command reference

System mode commands

Channel definition page (DE)

Source setup page (SS)

VC and IC

VL and IL