Tektronix 4200-SCS IC-CAP Driver Quick Start Guide

4200-SCS IC-CAP Driver
Quick Start Guide
4200ICCAP-903-01 Rev. C /May 2006
www.keithley.com
A GREATER MEASURE OF CONFIDENCE

WARRANTY

Keithley Instruments, Inc. warrants this product to be free from defects in material and workmanship for a period of 1 year from date of shipment.
Keithley Instruments, Inc. warrants the following items for 90 days from the date of shipment: probes, cables, rechargeable batteries, diskettes, and documentation.
During the warranty period, we will, at our option, either repair or replace any product that proves to be defective.
To exercise this warranty, write or call your local Keithley representative, or contact Keithley headquarters in Cleveland, Ohio. You will be given prompt assistance and return instructions. Send the product, transportation prepaid, to the indicated service facility. Repairs will be made and the product returned, transportation prepaid. Repaired or replaced products are warranted for the balance of the original warranty period, or at least 90 days.
LIMITATION OF WARRANTY
This warranty does not apply to defects resulting from product modification without Keithley’s express written consent, or misuse of any product or part. This warranty also does not apply to fuses, software, non-recharge able batteries, damage from battery leakage, or problems arising from normal wear or failure to follow instruc­tions.
THIS WARRANTY IS IN LIEU OF ALL OTHER WARRANTIES, EXPRESSED OR IMPLIED, INCLUD­ING ANY IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR USE. THE REMEDIES PROVIDED HEREIN ARE BUYER’S SOLE AND EXCLUSIVE REMEDIES.
NEITHER KEITHLEY INSTRUMENTS, INC. NOR ANY OF ITS EMPLOYEES SHALL BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF ITS INSTRUMENTS AND SOFTWARE EVEN IF KEITHLEY INSTRUMENTS, INC., HAS BEEN ADVISED IN ADVANCE OF THE POSSIBILITY OF SUCH DAMAGES. SUCH EXCLUDED DAMAGES SHALL INCLUDE, BUT ARE NOT LIMITED TO: COSTS OF REMOVAL AND INSTALLATION, LOSSES SUSTAINED AS THE RESULT OF INJURY TO ANY PERSON, OR DAMAGE TO PROPERTY.
-
A G R E A T E R M E A S U R E O F C O N F I D E N C E
Keithley Instruments, Inc.
Corporate Headquarters • 28775 Aurora Road • Cleveland, Ohio 44139
440-248-0400 • Fax: 440-248-6168 • 1-888-KEITHLEY (534-8453) • www.keithley.com
12/04

License Agreement

IMPORTANT - READ CAREFULLY BEFORE OPENING SOFTWARE PACKET
The license(s) granted herein are being granted pursuant to a purchase order submitted by you (the "Licensee"), for the purchase of a license to certain Keithley software products to be used by Licensee, and, if applicable, by such of Licensee's employees, subcontractors, or other agents in performing services for Licensee on Licensee's premises (such employees, subcontractors, and agents collectively referred to herein as "Employees").
By opening the software package, or exercising your rights to make and, as may be provided for below, use copies of the Software (as hereinafter defined), or keeping this package for over 30 days, Licensee agrees to be bound by, and to require each of its Employees to be bound by, the terms of this Keithley Instruments, Inc. 4200-SCS IC-CAP Driver License Agreement (the "Agreement"). If you do not agree to the terms of this Agreement, promptly return this package to Keithley Instruments within 30 days for a full refund. If you would like specific rights not granted in this Agreement, please contact Keithley Instruments for more information.
Keithley Instruments 4200-SCS 1IC-CAP Driver License Agreement
GRANT OF LICENSE
Keithley Instruments grants Licensee a license to use one copy of the version of Software on any one Workstation. In this agreement, "Use" means storing, loading, installing, compiling, executing, or displaying the Software. "Workstation" means any terminal, peripheral, or other device capable of access to a copy of the Software. "Software" means the enclosed 4200-SCS IC-CAP driver software, including, but not limited to, one or more of the following: source code, object code, dynamic link libraries, statically linked libraries, header files, sample programs, utility programs, make files, and scripts. The Software is designed to work with Agilent Technologies' IC-CAP software. The IC-CAP software is owned by Agilent Technologies and Licensee must obtain a separate license from Agilent Technologies with respect thereto.
SOURCE CODE LICENSE GRANT
Subject to the terms and conditions set forth herein, IF LICENSEE PURCHASED KEITHLEY INSTRUMENTS' MODEL 4200ICSRC, Licensee shall have the limited,
1. IC-CAP is a software product written, owned, and maintained by Agilent Technologies.
perpetual, revocable, nonexclusive, nontransferable right to modify (i.e. modify the source code and rebuild) the Software for use on any one Workstation for the sole and exclusive purpose of modifying pre-existing object code versions of the Keithley Instruments 4200­SCS driver software or creating new object code versions of the Keithley Instruments 4200­SCS driver software specifically to facilitate the use of IC-CAP with Keithley Instruments' 4200-SCS. Licensee is expressly prohibited from modifying the Software or source code for any purpose other than the foregoing. Licensee shall notify Keithley Instruments and promptly provide Keithley Instruments with a copy of any modified source code. Modified source code is not the property of Licensee and may only be used on a Workstation for which there is a grant of license hereunder from Keithley Instruments. Title to and ownership of all patents, copyrights, circuit layouts, mask works, trade secrets and other proprietary rights in any portion of the Software or Documentation (as hereinafter defined) incorporated into a Derivative Product (as hereinafter defined) shall at all times remain with Keithley Instruments, and Licensee shall not have any title or ownership therein; such Derivative Products will constitute "Software" for purposes of this Agreement. Licensee will obtain, at Keithley Instruments' expense, the execution of any instrument that may be appropriate to assign these rights to Keithley Instruments or perfect these rights in Keithley Instruments' name. Nothing contained in this Agreement will be construed to limit Keithley Instruments' rights to modify the Software or to develop other products that are similar to or offer the same or similar improvements as any Derivative Products developed by Licensee. "Derivative Products" means computer programs in machine readable object code or source code developed from or otherwise acquired by Licensee that are a modification of, enhancement of, derived from or based on the Software. No warranty by Keithley Instruments will apply to any modified source code.
The source codes of the Software are valuable assets of Keithley Instruments. Licensee hereby agrees to keep all source codes of the Software (including without limitation Derivative Products) in strict confidence, and to require each of its Employees to keep all source codes of the Software in strict confidence. Except as set forth below, neither Licensee nor any Employee may transfer or assign the Software or its rights under this Agreement.
COPYRIGHT
The Software and all user documentation related thereto (the "Documentation") is owned by Keithley Instruments or its suppliers and is protected by U.S. copyright laws and international treaties. Therefore, Licensee must treat the Software and Documentation like any copyrighted material and may not make any copies thereof with the following exceptions: (a) Licensee may create one backup copy of the Software solely for backup purposes, (b) Licensee may transfer the Software to a hard disk and keep the original copy solely for backup purposes and (c) Licensee may make an unlimited number of copies (either in hardcopy or electronic form) of Documentation delivered by Keithley Instruments electronically, provided that such copies shall be used solely for internal purposes and
shall not be republished or distributed to any third party. All copies of the Software, Derivative Products or Documentation must include any proprietary notice that Keithley Instruments has affixed to the Software or Documentation, as the case may be. Licensee acknowledges that any copies of the Software in any form provided by Keithley Instruments or made by Licensee are the sole property of Keithley Instruments. Licensee will not have any right, title or interest in or to such Software or copies thereof except as provided in this Agreement. Further, Licensee shall secure and protect all Software, Derivative Products and Documentation consistent with the maintenance of Keithley Instruments' proprietary rights therein.
OTHER RESTRICTIONS
This license serves as proof of license to exercise the rights granted herein and must be retained by Licensee. Licensee may not rent, lease, sublicense or transfer the Software or Documentation. Licensee may not reverse engineer, decompile, or disassemble the Software, except to the extent that the foregoing restriction is expressly prohibited by applicable law. Licensee may not use this Software on any network that allows remote access to the Software outside the Workstation on which it was installed.
LIMITED WARRANTY
Keithley Instruments warrants to Licensee that the unaltered Software will substantially perform the functions described in the Documentation for a period of 90 days after the date of delivery of the Software to Licensee. Keithley Instruments' sole obligation under this warranty shall be limited to using reasonable efforts to correct material, documented, reproducible defects in the unaltered Software that Licensee describes and documents to Keithley Instruments during the 90-day period. In the event that Keithley Instruments fails to correct a material, documented, reproducible defect within a reasonable period, Keithley Instruments may, at Keithley Instruments' discretion, replace the defective Software, or refund to Licensee the amount that Licensee paid Keithley Instruments for the defective Software and cancel this Agreement and the licenses granted herein. In such event, Licensee shall promptly return to Keithley Instruments all copies of the Software and Documentation in Licensee's possession or control.
DISCLAIMER OF WARRANTIES
The Software and Documentation are provided "AS IS." EXCEPT AS SPECIFICALLY PROVIDED IN THE PARAGRAPH IMMEDIATELY ABOVE, KEITHLEY INSTRUMENTS MAKES NO WARRANTY, EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, ANY WARRANTY OF MERCHANTABILITY, NONINFRINGEMENT OR FITNESS FOR A PARTICULAR PURPOSE.
LIMITATION OF LIABILITY
In no event shall Keithley Instruments or its suppliers be liable for any loss of profit or indirect, special, incidental or consequential damages arising out of this agreement, whether the claim is based in tort (including negligence), contract or otherwise even if Keithley Instruments was advised of the possibility of such damages.
DEFAULT
Keithley Instruments may terminate this Agreement and revoke the licenses granted herein if Licensee materially fails to perform or comply with this Agreement or any provision hereof.
EXPORT REQUIREMENTS
The Software, Derivative Products, Documentation and all related technical information or materials are subject to export controls and are licensable under the U.S. Government export regulations. Licensee shall comply strictly with all legal requirements established under these controls and shall not export, re-export, divert, transfer or disclose, directly or indirectly, the Software, Derivative Products, Documentation or any related technical information or materials without the prior approval of the U.S. Department of Commerce.
U.S. GOVERNMENT RESTRICTED RIGHTS
The Software and Documentation are provided with RESTRICTED RIGHTS. Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(l)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 or subparagraphs (c)(1) and (2) of the Commercial Computer Software -- Restricted Rights at 48 CFR 52.227-19, as applicable. Contractor/manufacturer is Keithley Instruments, Inc., 28775 Aurora Road, Cleveland, OH 44139.
GOVERNING LAW: JURISDICTION
The laws of the State of Ohio will govern the validity, interpretation, construction, and performance of this Agreement. The Ohio state courts of Cuyahoga County, Ohio (or, if there is exclusive federal jurisdiction, the United States Court for the Northern District of Ohio) will have exclusive jurisdiction and venue over any dispute arising out of this Agreement, and Licensee hereby consents to the jurisdiction of such courts.
4200-SCS IC-CAP Driver
Quick Start Guide
©2006, Keithley Instruments, Inc.
All rights reserved.
Cleveland, Ohio, U.S.A.
Document Number: 4200ICCAP-903-01 Rev. C / May 2006

Manual Print History

The print history shown below lists the printing dates of all Revisions and Addenda created for this manual. The Revision Level letter increases alphabetically as the manual undergoes subsequent updates. Addenda, which are released between Revisions, contain important change information that the user should incorporate immediately into the manual. Addenda are numbered sequentially. When a new Revision is created, all Addenda associated with the previous Revision of the manual are incorporated into the new Revision of the manual. Each new Revision includes a revised copy of this print history page.
Revision A (Document Number 4200ICCAP-903-01) ............................... December 2001
Revision B (Document Number 4200ICCAP-903-01) .........................................April 2006
Revision C (Document Number 4200ICCAP-903-01 .......................................... May 2006
All Keithley product names are trademarks or registered trademarks of Keithley Instruments, Inc. Other brand names are trademarks or registered trademarks of their respective holders.

Safety Precautions

The following safety precautions should be observed before using this product and any associated instrumentation. Although some instruments and accessories would normally be used with non-hazardous voltages, there are situations where hazardous conditions may be present.
This product is intended for use by qualified 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 us­ing the product. Refer to the manual for complete product specifications.
If the product is used in a manner not specified, the protection provided by the product 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 equip­ment 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 manual. 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, and perform safe installations and repairs of products. Only properly trained service personnel may perform installation and service procedures.
Keithley products are designed for use with electrical signals that are rated Measurement Category I and Measurement Category II, as described in the International Electrotechnical Commission (IEC) Standard IEC 60664. Most measurement, control, and data I/O signals are Measurement Category I and must not be directly connected to mains voltage or to voltage sources with high transient over-voltages. Measurement Category II connections require protection for high transient over-voltages often as sociated with local AC mains connections. Assume all measurement, control, and data I/O connections are for connection to Category I sources unless otherwise marked or described in the Manual.
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 30V RMS,
42.4V peak, or 60VDC 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 volts, 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 sourc­es. NEVER connect switching cards directly to AC mains. When connecting sources to switching cards, install protective de­vices to limit fault current and voltage to the card.
Before operating an instrument, make sure the line cord is connected to a properly grounded power receptacle. Inspect the con­necting 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 pow­er 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 ca
-
-
5/03
bles 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. Al­ways make measurements with dry hands while standing on a dry, insulated surface capable of withstanding the voltage being measured.
The instrument and accessories must be used in accordance with its specifications and operating instructions or the safety of the equipment may be impaired.
Do not exceed the maximum signal levels of the instruments and accessories, as defined in the specifications and operating in­formation, and as shown on the instrument or test fixture panels, or switching card.
When fuses are used in a product, replace with same type and rating for continued protection against fire hazard.
Chassis connections must only be used as shield connections for measuring circuits, NOT as safety earth 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 safety earth ground using the wire recommended in the user documentation.
The ! symbol on an instrument indicates that the user should refer to the operating instructions located in the manual.
The symbol on an instrument shows that it can source or measure 1000 volts or more, including the combined effect of normal and common mode voltages. Use standard safety precautions to avoid personal contact with these voltages.
The symbol indicates a connection terminal to the equipment frame.
The WARNING heading in a manual explains dangers that might result in personal injury or death. Always read the associated information very carefully before performing the indicated procedure.
The CAUTION heading in a manual explains hazards that could damage the instrument. Such damage may invalidate the war­ranty.
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 Instruments. Standard fuses, with applicable national safety ap­provals, may be used if the rating and type are the same. 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 Instruments to maintain accuracy and functionality of the product.) If you are unsure about the applicability of a replacement component, call a Keithley Instruments office for information.
To clean an instrument, use a damp cloth 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., data acquisition board for installation into a computer) should never require cleaning if handled accord­ing to instructions. If the board becomes contaminated and operation is affected, the board should be returned to the factory for proper cleaning/servicing.

Table of Contents

1 General Overview
General information .................................................................................... 1-2
Contact information .............................................................................. 1-2
Addenda .............................................................................................. 1-2
Specifications ....................................................................................... 1-2
Product overview ........................................................................................ 1-2
Using this guide .......................................................................................... 1-3
2 Using the Pre-Compiled IC-CAP Driver
Introduction ................................................................................................ 2-2
General description .................................................................................... 2-2
Hardware overview .............................................................................. 2-2
Hardware name assignments .............................................................. 2-2
Instrument options ............................................................................... 2-3
Installation .................................................................................................. 2-4
Supplied files ....................................................................................... 2-4
Building for use with the 4200-SCS driver only ................................... 2-4
Building for use with other drivers ........................................................ 2-5
System configuration .................................................................................. 2-6
GPIB interfacing ................................................................................... 2-6
Software configuration ......................................................................... 2-6
Limitations and exclusions ....................................................................... 2-12
Conditions that cause switch to user sweep mode ............................ 2-12
Conditions that cause measurement to abort with error .................... 2-13
Other error conditions ........................................................................ 2-13
3 Using the 4200-SCS IC-CAP Driver Source Code
Introduction ................................................................................................ 3-2
Installation .................................................................................................. 3-2
Supplied files ....................................................................................... 3-2
Building from source code ................................................................... 3-3
System configuration .................................................................................. 3-5

List of Illustrations

2 Using the Pre-Compiled IC-CAP Driver
Figure 2-1 Main KCON screen ................................................................................ 2-6
Figure 2-2 System Configuration screen ................................................................. 2-7
Figure 2-3 KXCI Settings screen ............................................................................. 2-8
Figure 2-4 IC-CAP Hardware Setup screen ............................................................ 2-9
Figure 2-5 Hardware Setup screen after rebuild .................................................... 2-10
Figure 2-6 IC-CAP self test warning ...................................................................... 2-11
Figure 2-7 KXCI message screen after successful self test .................................. 2-11
Figure 2-8 IC-CAP KI4200 configuration screen ................................................... 2-12
4200ICCAP-903-01 Rev. C / May 2006

List of Tables

2 Using the Pre-Compiled IC-CAP Driver
Ta bl e 2-1 Instrument options .................................................................................. 2-3
Ta bl e 2-2 Supplied files .......................................................................................... 2-4
3 Using the 4200-SCS IC-CAP Driver Source Code
Ta bl e 3-1 Supplied files .......................................................................................... 3-2
4200ICCAP-903-01 Rev. C / May 2006
This page left blank intentionally.
4200ICCAP-903-01 Rev. C / May 2006
1

General Overview

4200ICCAP-903-01 Rev. C / May 2006
1-2 General Overview 4200-SCS IC-CAP Driver Quick Start Guide

General information

Contact information
If you have any questions, please contact your local Keithley representative or call one of our Application Engineers at 1-800-348-3735 (U.S. and Canada only). Additional information may be obtained at www.keithley.com.
Addenda
Any improvements or changes concerning the driver software or guide will be explained in an addendum included with the guide. Be sure to note these changes and incorporate them into the guide.
Specifications
4200-SCS system specifications are subject to change without notice. These specifications can be found on the 4200-SCS Complete Reference CD, available at www.keithley.com.

Product overview

The 4200-SCS IC-CAP driver provides the software interface between the 4200-SCS Semiconductor Characterization System and the IC-CAP Modeling software. With the driver installed and properly configured, all 4200-SMU, 4210-SMU, and 4200-PA modules can be controlled from within the IC-CAP environment.
The 4200-SCS IC-CAP driver can be installed by either installing the pre-compiled driver onto the machine running IC-CAP, or by recompiling the included 4200-SCS IC-CAP driver source code. All pre-compiled drivers and source code are included on the 4200ICCAP CD.
The specific IC-CAP versions, C/C++ compiler versions, and pre-compiled 4200-SCS IC-CAP driver versions are covered later in this document and in the Release Notes included on the 4200-SCS IC-CAP CD.
4200ICCAP-903-01 Rev. C / May 2006
4200-SCS IC-CAP Driver Quick Start Guide General Overview 1-3

Using this guide

This Quick Start Guide contains information necessary to install, configure, and test the 4200-SCS IC-CAP driver on your system. For information on using the IC-CAP Modelling Suite, refer to the IC-CAP User’s Guide provided with that software package.
Refer to the following sections for pertinent information:
Section 2: includes information on installing, configuring, and testing the precompiled 4200-SCS IC-CAP driver specific to your particular IC-CAP setup.
Section 3: contains information on installing, configuring, and compiling the 4200-SCS IC-CAP source code specific to your particular IC-CAP setup.
NOTE Refer to the software release notes on disk for any changes to the
installation and configuration procedures covered by this guide.
4200ICCAP-903-01 Rev. C / May 2006
1-4 General Overview 4200-SCS IC-CAP Driver Quick Start Guide
This page left blank intentionally.
4200ICCAP-903-01 Rev. C / May 2006
2
Using the Pre-Compiled
IC-CAP Driver
4200ICCAP-903-01 Rev. C / May 2006
2-2 Using the Pre-Compiled IC-CAP Driver 4200-SCS IC-CAP Driver Quick Start Guide

Introduction

This section contains information on installing, configuring, and testing the 4200-SCS IC-CAP driver. The information in this section pertains to enabling the pre-compiled 4200-SCS IC-CAP driver for your particular IC-CAP setup.
To complete the installation process, you must first manually install the driver files as covered in Keithley External Control Interface (KXCI) and IC-CAP as described in “Software
configuration” on page 2-6.
“Installation” on page 2-4, and then configure both the 4200-SCS

General description

Hardware overview
The 4200-SCS can be equipped with two to eight programmable source/measure­ment units (SMU):
Up to four SMUs can be high power
Each SMU can be equipped with an optional preamp
Each SMU can be assigned as SMU, Voltage Source (VS), or Voltage meter (VM)
NOTE Because of the flexibility of 4200-SCS configuration, you cannot
manually add the 4200-SCS to the IC-CAP instrument list. You must rebuild the list as covered in
Hardware name assignments
IC-CAP driver assigns the following names to the units:
SMUn: Source/Measurement Unit n (1, 2, .., 8)
HPSMUn: High Power Source/Measurement Unit n (3, 4, .., 8; only four of them are available at one time)
VSn: Voltage Source Unit n (1, 2 , .., 8)
VMn: Voltage Monitor Unit n (1, 2, ..,8)
NOTE Because the 4200-SCS is always operated in auto-range by IC-CAP,
there is no need for IC-CAP to know the existence of the optional preamps. Internally, the software tracks the existence of preamps so that proper input checking can be implemented.
Fixed ranges are available by setting “Init Command” accordingly; it may be important to take measurements on a fixed range. Use the RG command to set lowest current range. No range command is necessary for voltage ranges.
4200ICCAP-903-01 Rev. C / May 2006
“IC-CAP configuration” on page 2-9.
4200-SCS IC-CAP Driver Quick Start Guide Using the Pre-Compiled IC-CAP Driver 2-3
A ground unit (GNDU) provides a means for connecting device terminals to a ground reference without consuming a SMU resource and can sink up to 4.4A. The ground unit is supported in IC-CAP, but it will not appear in the Hardware
Editor Configuration dialog box.
Instrument options
Ta bl e 2-1 summarizes 4200-SCS instrument options used by IC-CAP.
Tab l e 2-1
Instrument options
Option Description
Use User Sweep Yes = use user sweep. No = use instrument’s internal sweep. Default = No.
Dependencies: None.
Hold Time Time the instrument waits before starting an internal or user sweep. Range is 0 to
655.3 sec in 10 msec steps. Default = 0. Dependencies: None.
Delay Time Time the instrument waits after the source is changed but before taking a
measurement at each step of an internal or user sweep. The range is 0 to 6.553 sec in 1 msec steps. Default = 0. Dependencies: None.
Integration Time Instrument settling time and A/D integration time; set to S (short), M (medium), L
(long), C (custom). Default: M. Dependencies: Delay factor, Filter factor, nPLC.
Delay Factor Instrument delay factor. Delay factor is only valid if Integration Time is C (Custom).
The internal default delay will be multiplied by the delay factor. Default equals 1. Min equals 0, max equals 100. Dependencies: Integration Time.
Filter Factor Instrument filter factor. Filter factor is only valid if Integration Time is C (Custom). The
A/D integration time will be multiplied by the square of filter factor. Default equals 1. Min equals 0, max equals 100. Dependencies: Integration Time.
nPLC Number of power line cycles (PLC) used for integration. nPLC is only valid if
Integration Time is C (Custom). Default equals 1. Min equals 0.01, max equals 10. Dependencies: Integration Time.
Measurement Timeout
Init Command This command field is used to set the instrument to a mode not supported by the
Forbid User Sweeps
Timeout in seconds for data reading. Minimum 5 sec. Maximum 86400 sec. Default = 900 sec. Dependencies: None.
option table. This command is sent at the end of instrument initialization for each measurement. Normal C escape characters such as \n (new line) are available. Default = none. Dependencies: None.
No = Allow user sweeps. Yes = Override IC-CAP default and force system sweeps in all situations.
Default = No. Dependencies: None.
4200ICCAP-903-01 Rev. C / May 2006
2-4 Using the Pre-Compiled IC-CAP Driver 4200-SCS IC-CAP Driver Quick Start Guide

Installation

NOTE Check the software release notes for any changes to the installation
procedure.
Supplied files
The 4200-SCS IC-CAP Driver CD contains all compiled drivers. Tab le 2-2 sum­marizes these supplied files.
Tab l e 2-2
Supplied files
IC-CAP
VERSION
2002 Solaris <UNSUPPORTED> <Any Solaris version of IC-CAP older than 2002
2004 Solaris libicusercxx.so Library used by IC-CAP to hold instrument drivers.
2006 Solaris (As of March 2006, Agilent
2002 WIN32 icusercxx.dll DLL used by IC-CAP to hold instrument drivers.
2004 WIN32 icusercxx62.dll DLL used by IC-CAP to hold instrument drivers.
2006 WIN32 icusercxx63.dll DLL used by IC-CAP to hold instrument drivers.
IC-CAPOS4200-SCS IC-CAP DRIVER
BINARY FILE DESCRIPTION
must be recompiled. Refer to Section 3 for details.>
had not yet released IC-CAP 2006 for Solaris)
Building for use with the 4200-SCS driver only
Follow these steps for basic installation (4200-SCS driver with no other user driv­ers):
To copy the icusercxx.so file to SOLARIS operating system:
NOTE <ICCAP_ROOT> refers to the directory where you installed IC-CAP. The
default is /opt/iccap2004.
1. Close IC-CAP if it is running.
2. Copy icusercxx.so to <ICCAP_ROOT>\bin.
3. Start IC-CAP and Rebuild the instrument list:
Under Instrument List, click Rebuild. IC-CAP will then rebuild the instrument list, a process that will take some time. During the process, any error messages shown on the 4200-SCS KXCI screen are normal.
4. You are now ready to use the 4200-SCS through IC-CAP.
4200ICCAP-903-01 Rev. C / May 2006
4200-SCS IC-CAP Driver Quick Start Guide Using the Pre-Compiled IC-CAP Driver 2-5
To copy icusercxx(62)(63).dll file to WIN32 operating system:
NOTE <ICCAP_ROOT> refers to the directory where you installed IC-CAP. The
default is
C:\Agilent\ICCAP_2002
-or-
C:\Agilent\ICCAP_2004
-or-
C:\Agilent\ICCAP_2006
1. If you are running ICCAP2002, copy icusercxx.dll to <ICCAP_ROOT>\bin. If you are running ICCAP2004, copy icusercxx62.dll to
<ICCAP_ROOT>\bin. If you are running ICCAP2006, copy icusercxx63.dll to
<ICCAP_ROOT>\bin.
2. Start IC-CAP and Rebuild the instrument list:
Under Instrument List, click Rebuild. IC-CAP will then rebuild the instrument list, a process that will take some time. During the process, any error messages shown on the 4200-SCS KXCI screen are normal.
3. You are now ready to use the 4200-SCS through IC-CAP.
Building for use with other drivers
If you need to activate the 4200-SCS IC-CAP driver and use it in conjunction with other custom instrument drivers, you will need to follow the source code compila tion instructions shown in Section 3 of this document.
-
4200ICCAP-903-01 Rev. C / May 2006
2-6 Using the Pre-Compiled IC-CAP Driver 4200-SCS IC-CAP Driver Quick Start Guide

System configuration

GPIB interfacing
WARNING Before configuring and using the 4200-SCS with IC-CAP, make
sure that the unit is properly interfaced to the GPIB interface of the workstation using a shielded IEEE-488 cable such as the Keithley Model 7007. Refer to Section 9 of the 4200-SCS Refer ence Manual for details.
Software configuration
KXCI configuration
Follow these steps to configure 4200-SCS KXCI using KCON:
1. Double-click on the KCON icon. The main KCON screen shown in
Figure 2-1 will be displayed.
Figure 2-1
Main KCON screen
-
KI 4200 SCS
4200ICCAP-903-01 Rev. C / May 2006
4200-SCS IC-CAP Driver Quick Start Guide Using the Pre-Compiled IC-CAP Driver 2-7
2. Click on KI 4200 SCS in KI System Configuration. The workspace will display the System Configuration screen shown in
Figure 2-2.
Figure 2-2
System Configuration screen
KXCI Settings Tab
4200ICCAP-903-01 Rev. C / May 2006
2-8 Using the Pre-Compiled IC-CAP Driver 4200-SCS IC-CAP Driver Quick Start Guide
3. Click on the KXCI Settings tab. The Workspace will display KXCI Settings, as shown in
Figure 2-3.
Figure 2-3
KXCI Settings screen
KXCI Settings
4. Set KXCI Settings as follows: GPIB Address: 0-30 GPIB Language: 4200 (Normal) Terminator: Comma EOI: ON Instrument Functions (SMU, VS, VM): system defaults
NOTE If 4145 emulation is selected, IC-CAP will use the 4145 driver, not the
4200-SCS driver.
If you change Instrument Function names after configuring IC-CAP, you must re-configure IC-CAP using the procedure in
on page 2-9.
5. Select File Save to save the modified KCON configuration, then exit KCON.
4200ICCAP-903-01 Rev. C / May 2006
“IC-CAP configuration”
4200-SCS IC-CAP Driver Quick Start Guide Using the Pre-Compiled IC-CAP Driver 2-9
IC-CAP configuration
After setting up KXCI with KCON, configure IC-CAP for use with the 4200-SCS as follows:
1. First, double-click the KXCI icon on the 4200-SCS to open the KXCI screen.
2. Run IC-CAP on the workstation.
3. Once in IC-CAP, select the Tools Hardware Setup menu. The main Hardware Setup screen shown in
Figure 2-4
IC-CAP Hardware Setup screen
Figure 2-4 will be displayed.
4200-SCS Semiconductor Characterization System
4. If no interface is shown in the HP-IB Interface window, click Add Interface, type in the name (usually “gpib0” for WIN32 and “/dev/gpib0” for SOLARIS), then click OK.
5. Verify that 4200-SCS Semiconductor System is shown in the Instrument Library list (see
Figure 2-4). If not, reinstall the driver as covered in
“Installation” on page 2-4.
4200ICCAP-903-01 Rev. C / May 2006
2-10 Using the Pre-Compiled IC-CAP Driver 4200-SCS IC-CAP Driver Quick Start Guide
6. Under Instrument List, click Rebuild. IC-CAP will then rebuild the instrument list, a process that will take some time. During the process, any error messages shown on the 4200-SCS KXCI screen are normal.
7. After rebuilding, KI4200 should appear in the Instrument List window (refer to
Figure 2-5). If not, check your driver installation, then repeat steps
2 through 6.
Figure 2-5
Hardware Setup screen after rebuild
KI4200
4200ICCAP-903-01 Rev. C / May 2006
4200-SCS IC-CAP Driver Quick Start Guide Using the Pre-Compiled IC-CAP Driver 2-11
8. Click on KI4200 in the Instrument List dialog box, then select the Instruments Self Test menu. IC-CAP will display the warning shown in
Figure 2-6.
Figure 2-6
IC-CAP self test warning
Click OK only after disconnecting all devices
CAUTION Remove all device connections prior to performing the self
test, or instrument damage may occur.
9. After disconnecting all devices, click OK to test the system, which will take a few minutes. During the process, the 4200-SCS will display test status.
Figure 2-7 shows a typical KXCI display screen after successful completion
of the test.
Figure 2-7
KXCI message screen after successful self test
Self test display messages
4200ICCAP-903-01 Rev. C / May 2006
2-12 Using the Pre-Compiled IC-CAP Driver 4200-SCS IC-CAP Driver Quick Start Guide
10. IC-CAP is now ready to use with the 4200-SCS. If desired, you can view or modify 4200-SCS configuration by clicking Configure in the IC-CAP Hardware Setup screen.
NOTE If you change 4200-SCS KXCI Settings, you must rebuild in IC-CAP
using the above procedure.
Figure 2-8
IC-CAP KI4200 configuration screen
Figure 2-8 shows typical hardware configuration.
GPIB Primary
Address

Limitations and exclusions

Conditions that cause switch to user sweep mode
More than 4096 total data points in VAR1 internal sweep.
First order LOG sweep with other than 10, 25, or 50 points per decade, or specified with points per octave.
SYNC sweep with master sweep not sweep order 1.
LIST or SEG sweep with sweep order 1.
No first order sweep on KI4200.
Hardware
Assignments
4200ICCAP-903-01 Rev. C / May 2006
4200-SCS IC-CAP Driver Quick Start Guide Using the Pre-Compiled IC-CAP Driver 2-13
Conditions that cause measurement to abort with error
Any GPIB communications error.
Mode other than V or I for SMU.
Mode other than V for VS/VM.
Invalid sweep type (valid types are CON, LIN, LOG, SYNC, LIST, SEG).
Single-point LIN or LOG sweeps.
Sweep limits out of range for unit.
Invalid compliance setting for sweep conditions.
SYNC sweep different mode than master sweep.
SYNC sweep ratio greater than 10.
SYNC sweep offset out of range. (V mode: 100, I mode: 1.0 for HPSMU, 0.1 for SMU).
SYNC sweep invalid master sweep type (valid types are LIN, LOG, LIST, SEG).
SYNC sweep limits out of range (sync sweep limits are based on master sweep range, with offset and ratio applied).
SMU used in output (measuring) without being used in an input (sourcing)
Measurement timeout.
Other error conditions
GPIB error getting unit information.
GPIB error setting instrument options.
Self test failure.
Self test timeout.
4200ICCAP-903-01 Rev. C / May 2006
2-14 Using the Pre-Compiled IC-CAP Driver 4200-SCS IC-CAP Driver Quick Start Guide
This page left blank intentionally.
4200ICCAP-903-01 Rev. C / May 2006
3
Using the 4200-SCS
IC-CAP Driver Source Code
4200ICCAP-903-01 Rev. C / May 2006
3-2 Using the 4200-SCS IC-CAP Driver Source Code 4200-SCS IC-CAP Driver Quick Start Guide

Introduction

This section contains information on installing, configuring, and testing the 4200-SCS IC-CAP driver source code.

Installation

NOTE Check the software release notes for any changes to the installation
procedure.
Supplied files
The 4200-SCS IC-CAP Driver CD contains compiled driver source code.
Ta bl e 3-1 summarizes supplied files.
Table 3-1
Supplied files
IC-CAP
VERSION
2002 Solaris Makefile Solaris\src\user_meas_ki.cxx Sun Workshop 3.0
2004 Solaris Makefile Solaris\src\user_meas_ki.cxx Sun Studio 11
2006 Solaris (As of March 2006, Agilent
IC-CAPOS4200-SCS IC-CAP DRIVER
MAKEFILE
had not yet released IC-CAP 2006 for Solaris)
4200-SCS IC-CAP DRIVER
SOURCE CODE FILE
AGILENT
RECOMMENED
COMPLIER
(compiler 4.2)
2002 WIN32 Makefile.2002 Win32\src\user_meas_ki.cxx MS DevStudio V6.0
2004 WIN32 Makefile.2004 Win32\src\user_meas_ki.cxx MS DevStudio V6.0
2006 WIN32 Makefile.2006 Win32\src\user_meas_ki.cxx MS DevStudio .NET 2003
Note The 4200-SCS IC-CAP driver cannot be built for
ICCAP 2002 and 2004 with Developer Studio
versions newer than .NET 2002 (this includes
.NET 2003 and .NET 2005). ICCAP 2006 supports the newer Microsoft Compiliers.
4200ICCAP-903-01 Rev. C / May 2006
4200-SCS IC-CAP Driver Quick Start Guide Using the 4200-SCS IC-CAP Driver Source Code 3-3
Building from source code
To build icusercxx.so from SOLARIS source files:
NOTE <ICCAP_ROOT> refers to the directory where you installed IC-CAP. The
default is /opt/iccap2002 or /opt/iccap2004.
1. Close IC-CAP if it is running.
2. Copy all source files from the source media for the 4200 driver to the new <ICCAP_ROOT>\src directory. These files are:
ki4200.cxx ki4200.hxx build_4200.cxx user_meas_ki.cxx Makefile
3. Change directory to the $(ICCAP_ROOT>/src directory.
4. Set the ICCAP_ROOT environment variable appropriately. This is usually /opt/iccap2002.
5. Edit user_meas.cxx to add the lines from user_meas_ki.cxx to the add_users_drivers() function. This enables the 4200 driver in IC-CAP.
For reference, the lines to add are:
extern instr* make_new_ki4200 (const char* name); add_user_driver ("KI4200", make_new_ki4200);
The user_meas_ki.cxx file is a copy of the Agilent-supplied user_meas.cxx with the appropriate changes already made.
6. Save user_meas.cxx.
7. Run make. This will build the libicusercxx.so file.
8. Copy libicusercxx.so to $(ICCAP_ROOT)\bin.
9. Start IC-CAP and 'Rebuild' the instrument list.
Under Instrument List, click Rebuild. IC-CAP will then rebuild the instru­ment list, a process that will take some time. During the process, any error messages shown on the 4200-SCS KXCI screen are normal.
10. You are now ready to use the 4200-SCS through IC-CAP.
4200ICCAP-903-01 Rev. C / May 2006
3-4 Using the 4200-SCS IC-CAP Driver Source Code 4200-SCS IC-CAP Driver Quick Start Guide
To build icusercxx.dll from WIN32 source files:
NOTE <ICCAP_ROOT> refers to the directory where you installed IC-CAP. The
default is C:\Agilent\ICCAP_2002 or C:\Agilent\ICCAP_2004 or C:\Agilent\ICCAP_2006.
1. Close IC-CAP if it is running.
2. Copy all source files from the source media for the 4200 driver to the new <ICCAP_ROOT>\src directory. These files are:
ki4200.cxx ki4200.hxx build_4200.cxx user_meas_ki.cxx
AND the appropriate makefile based on the ICCAP version you are running:
ICCAP Correct Makefile Agilent Recommended Compiler 2002 Makefile.2002 MS DevStudio V6.0
2004 Makefile.2004 MS DevStudio V6.0 2006 Makefile.2006 MS DevStudio .NET 2003
NOTE The ki4200 driver cannot be built for ICCAP 2002 and 2004 with
Developer Studio versions past .NET 2002 (this includes .NET 2003 and .NET 2005). ICCAP 2006 supports the newer Microsoft compilers.
Rename the makefile that you copied to Makefile.
3. Change directory to the <ICCAP_ROOT>\src directory.
4. Edit the file icbuild.bat to set ICCAP_ROOT to the value of your ICCAP_ROOT environment variable.
NOTE You must use forward slashes ("/") in the name. You only need to modify
the PATH, INCLUDE, and LIB variables if you plan to build the DLL with a version of DevStudio newer than that in the table above.
5. Edit user_meas.cxx to add the lines from user_meas_ki.cxx to the add_users_drivers() function. This enables the 4200 driver in IC-CAP.
For reference, the lines to add are:
extern instr* make_new_ki4200(const char* name); add_user_driver("KI4200", make_new_ki4200);
The user_meas_ki.cxx file is a copy of the Agilent supplied user_meas.cxx with the appropriate changes already made.
6. Save user_meas.cxx.
7. Run icbuild. This will build the icusercxx(6n).dll file.
4200ICCAP-903-01 Rev. C / May 2006
4200-SCS IC-CAP Driver Quick Start Guide Using the 4200-SCS IC-CAP Driver Source Code 3-5
8. If you are running ICCAP2002, copy icusercxx.dll to <ICCAP_ROOT>\bin.
If you are running ICCAP2004, copy icusercxx62.dll to
<ICCAP_ROOT>\bin.
If you are running ICCAP2006, copy icusercxx63.dll to
<ICCAP_ROOT>\bin.
9. Start IC-CAP and Rebuild the instrument list.
Under Instrument List, click Rebuild. IC-CAP will then rebuild the instru­ment list, a process that will take some time. During the process, any error messages shown on the 4200-SCS KXCI screen are normal.
10. You are now ready to use the 4200-SCS through IC-CAP.

System configuration

After compiling and building from source code, the system must be configured and tested as described in
“System configuration” on page 2-6
4200ICCAP-903-01 Rev. C / May 2006
3-6 Using the 4200-SCS IC-CAP Driver Source Code 4200-SCS IC-CAP Driver Quick Start Guide
This page left blank intentionally.
4200ICCAP-903-01 Rev. C / May 2006

Index

B
Building for use with other drivers 2-5 Building for use with the 4200-SCS driver only Building from source code
G
GPIB interfacing 2-6
H
Hardware
Name assignments Overview
2-2
I
IC-CAP configuration 2-9 Installation Instrument options
2-4
2-3
K
KXCI configuration 2-6
3-3
2-2
2-4
L
Limitations and exclusions 2-12
Cause measurement to abort Other error conditions Switch to user sweep mode
2-13
S
SOLARIS 2-4, 3-3 Supplied files System configuration
GPIB interfacing Software configuration
2-4, 3-2
2-6, 3-5
2-6
IC-CAP configuration 2-9 KXCI 2-6
W
WIN32 2-5, 3-4
2-13
2-12
Specifications are subject to change without notice.
All Keithley trademarks and trade names are the property of Keithley Instruments, Inc.
All other trademarks and trade names are the property of their respective companies.
A GREATER MEASURE OF CONFIDENCE
Keithley Instruments, Inc.
Corporate Headquarters • 28775 Aurora Road • Cleveland, Ohio 44139 • 440-248-0400 • Fax: 440-248-6168 • 1-888-KEITHLEY (534-8453) • www.keithley.com
12/04
Loading...