Keithley Instruments, Inc. warrants this product to be free from defects in material and workmanship for a period of
one (1) year from date of shipment.
Keithley Instruments, Inc. warrants the following items for 90 days from the date of shipment: probes, cables,
software, rechargeable batteries, diskettes, and documentation.
During the warranty period, Keithley Instruments will, at its option, either repair or replace any product that proves
to be defective.
To exercise this warranty, write or call your local Keithley Instruments representative, or contact
Keithley Instruments 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 Instruments’ express
written consent, or misuse of any product or part. This warranty also does not apply to fuses, software,
non-rechargeable batteries, damage from battery leakage, or problems arising from normal wear or failure to follow
instructions.
THIS WARRANTY IS IN LIEU OF ALL OTHER WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING 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: COST 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
The following safety precautions should be observed before using this product and any associated instrumentation. Although some
instruments an d access ories would n ormally be used with non-h azardous voltag es, there are situ ations where h azardous condition s may
be present.
This product is inte nded for us e by qual ified person nel who recognize s hock haz ards and are famili ar with the s afety prec autions requ ired
to avoid possible in jury. Rea d and fo llow all inst a llatio n, opera tion, an d mai ntenanc e info rmatio n carefu lly b efore us ing the product. Ref er
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 inten ded function. T hey must be trained in e lectrical safe ty procedures a nd proper us e of the inst rument.
They must be protected from electric shock and contact with hazardous live circuits.
Maintenance personnel perform routine procedures on the product to keep it op era tin g p r op erly, fo r e xam pl e, se tting the line voltage or
replacing consuma ble ma terials . Main tenanc e proc edures are descri bed in t he u ser docum ent ation. The proced ures expl icitly st ate if th e
operator may perform them. Otherwise, they should be performed only by service personnel.
Safety Precautions
Service personnel are trained to wor k on live circuits, perform safe installations, and repair products. Only properly trained service
personnel may perform installation and service procedures.
Keithley Instruments 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 Ca tegory I and must not be dire ctly connected to ma ins voltag e or to voltage sourc es with high transient
over-voltages. Measurement Category II connections require protection for high transient over-voltages often a s sociated with local AC
mains connect ions. Assume all measurement, co ntrol, and dat a I/O connec tions are for conn ection to Cate gory I sources u nless otherwise
marked or described in the user documentation.
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 acces s and/or insul ated from ev ery connect ion point . In some c ases, conne ctions mus t be expos ed to potenti al human c ontact.
Product operators in th ese ci rcu ms t ances must be train ed t o p r otec t themselves from the ri sk of electric shock. If the ci rcu it is capable of
operating at or above 1000V, no conductive part of the circuit may be exposed.
Do not connect switc hing cards direc tly to unlim ited power circui ts. They ar e intended to b e used with im pedance-lim ited 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.
11/07
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.
AL W AYS remove powe r from the entire te st system and d ischarge an y capa citors befo re: connecting or disconne cting cab les or jumpers,
installing or removing switching cards, or making internal changes, such as installing or removing jumpers.
Do not touch any o bject that could pro vide a c urrent p ath to the com mon sid e of the c ircuit under t est or p ower line (e arth) ground . Always
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 maxi mum s ignal levels of the ins tru ment s and acces sories , as defi ned in th e spec ifica tion s and op erating information,
and as shown on the instrument or test fixture panels, or switching card.
When fuses are used in a product, replace with the same type and rating for continued 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 user documentation.
The symbol on an instrument shows that it can source or measure 1000V 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 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 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 th e u se r do cu me ntation explains ha za rds th at could damage the i nstrument. Such dama ge ma y inv al idate the
warranty.
Instrumentation and accessories shall not be connected to humans.
Before performing any maintenance, disconnect the line cord and all test cables.
T o main tain protecti on from electric sho ck and fire, replacem ent component s in mains circu its - includi ng the power trans former, tes t leads,
and input jacks - must be purchased from Keithley Instruments. Standard fuses with applicable national safety approvals 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 function ality of the product). If you ar e unsure about the applicabi lity of a replacement co mponent, call a Keithley Ins truments
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 instrumen t or allow liqui ds to enter or spi ll on the inst rument. Produ cts tha t consist of a circuit board wi th 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.
This section contains information about Keithley Command Compatible Functions. Refer to Section 2
for information on the National Instruments™ (NI)1 command compatible functions.
NOTERefer to Section 2 for NI Command Compatible Functions.
If you have any questions after reviewing this information, please contact your local Keithley
representative or call one of our Applications Engineers at 1-800-KEITHLEY (US only) or visit our
website at www.keithley.com.
Using Keithley Command Compatible functions
Microsoft® Visual Basic (Version 6.0)
To create a Windows® XP/2000/Vista Keithley Command Compatible application using the API and
Microsoft Visual Basic, follow these steps:
Step 1: Enter Visual Basic and open or create a project to use the Keithley Command
Compatible functions
To create a new project, select New Project from the File menu.
To use an existing project:
1.Open the file by selecting Open Project from the File menu. The Open Project dialog box
appears (Figure 1-1).
Figure 1-1
Open Project dialog box
2.Load the project by finding and double-clicking the project file name in the applicable directory.
Step 2: Include function declarations and constants file (IEEEVB.BAS)
If it is not already included in the project, add the IEEEVB.BAS file as a module to your project. All
Keithley Command Compatible function declarations and constants are contained in this file. These
function declarations and constants are used to develop user self-measurement applications.
1. National Instruments™ and NI are trademarks of the National Instruments Corporation.
1-2Return to Section TopicsKPCI-488LPA-900-01 Rev. A / December 2008
Add elements, such as a command button, list box, or text box, etc., on the Visual Basic form used to
design the interface. These elements are standard controls from the Visual Basic Toolbox. To place a
needed control on the form:
1.Select the needed control from the Toolbox.
2.Draw the control on the form. Alternatively, to place the default-sized control on the form, click
the form. Use the Select Objects tool to reposition or resize controls.
Step 4: Set control properties
Set control properties from the properties list. To view the properties list, select the desired control and
do one of the following:
•Press F4
•Select the Properties command in the View menu
or
•Click the Properties button on the Toolbar.
Step 5: Write the event codes
The event codes define the action desired when an event occurs. To write the event codes:
1.Double-click the control or form needing event code (the code module will appear).
2.Add new code as needed. All functions that are declared in IEEEVB.BAS can be called to
perform data acquisition operations (refer to Keithley Command Compatible function reference).
Step 6: Run your application
To run the application, either:
•Press F5
•Select Start from the Run menu
or
•Click the Start icon on the Toolbar
KPCI-488LPA-900-01 Rev. A / December 2008Return to Section Topics1-3
To create a Windows XP/2000/Vista Keithley command compatible library application using the
Keithley Command Compatible function library (which is CEC command-compatible) and Microsoft
Visual C/C++, follow these steps:
Step 1: Enter Visual C/C++ and open or create a project in which you wish to use
Keithley Command Compatible functions
NOTEThe project can be a new or existing one.
Step 2: Include function declarations and constants file (IEEE-C.H)
Include IEEE-C.H in the C/C++ source files that call Keithley Command Compatible functions by
adding the following statement in the source file:
#include "IEEE-C.H"
NOTEKeithley Command Compatible function declarations and constants are contained in IEEE-
C.H. Use the functions and constants to develop user self data-acquisition applications.
Step 3: Build your application
1.Set suitable compile and link options.
2.Select Build from the Build menu (Visual C/C++ 4.0 and higher).
3.Remember to link the Keithley Command Compatible library ieee_32m.lib.
1-4Return to Section TopicsKPCI-488LPA-900-01 Rev. A / December 2008
This section contains a detailed description of Keithley Command Compatible library functions,
including the compatible library data types and function reference. The following functions are
arranged alphabetically:
GPIBBOARDPRESENT
DescriptionThis function checks if a GPIB board is present in the GPIB system.
SyntaxMicrosoft C/C++ and Borland C++
char gpib_board_present(void)
Visual Basic
GpibBoardPresent( ) As Long
Return Value0: if no GPIB is installed
1: if a GPIB board is installed
BOARDSELECT
DescriptionThis function selects a board to be the active board.
SyntaxMicrosoft C/C++ and Borland C++
Parametersboard: the board number. The valid value is from 0 to 3
DMACHANNEL
DescriptionThis function sets the DMA channel. This function is ignored for the
SyntaxMicrosoft C/C++ and Borland C++
Parameterschan: DMA channel number
ENTER
void boardselect (long int bd)
Visual Basic
call boardselect (ByVal board As Long)
Model KPCI-488LPA.
void dmachannel (long int c)
Visual Basic
call dmachannel (ByVal chan As Long)
DescriptionThis function reads data from a specified device.
SyntaxMicrosoft C/C++ and Borland C++
long int enter (char *buf, unsigned long maxlen,
unsigned long *len, long int addr,
long int *status)
KPCI-488LPA-900-01 Rev. A / December 2008Return to Section Topics1-5
call enter(buf As String, maxlen As Integer,
len As Integer, addr As Integer, status As Integer)
Parametersbuf: the buffer storing the received data
maxlen: the maximum bytes of data to receive. The valid value is from 0 to 65535
len:returns the actual number of received data bytes
addr: the GPIB address of the Talker
status: 0: read data successfully; 8: timeout error
FEATURE
DescriptionThis function returns the GPIB board settings or hardware features.
SyntaxMicrosoft C/C++ and Borland C++
long int feature (long int f)
Visual Basic
GPIBFeature (ByVal f As Long) As Long
Parametersf: the feature or setting information desired. Valid FEATURE values are contained in
Table 1-1.
Table 1-1
FEATURE parameters
Feature
(Constants)
IEEEListener0Checking if ListenerPresent function is supported by
IEEEIOBASE100the I/O base address of the board
IEEETIMEOUT200the I/O timeout setting of the board
IEEEINPUTEOS201the current setting of the input EOS character
IEEEOUTPUTEOS1202the current setting of the output EOS character 1
IEEEOUTPUTEOS2203the current setting of output EOS character 2
IEEEBOARDSELECT204the current active board number
Return ValueThe value of the feature or setting
INITIALIZE
DescriptionThis function opens and initializes a GPIB board.
SyntaxMicrosoft C/C++ and Borland C++
Features
(Values) Returned Information
the GPIB board; this information value is always 1.
void initialize (long int addr,
long int level)
Visual Basic
call initialize (ByVal addr As Long,
ByVal level As Long)
Parametersaddr :GPIB address assigned to the board
level:0: specifies the board as a system controller
1: specifies the board as a device
1-6Return to Section TopicsKPCI-488LPA-900-01 Rev. A / December 2008
values following LISTEN are the GPIB
addresses of the listeners.
TALKSets the address of the talker. The
values following TALK are the GPIB
addresses of the talker. There is only
one talker at a time.
SECSets the second address of the talker or
listener. This command should follow
TALK or LISTEN.
UNTUntalk."UNT"
UNLUnlisten."UNL"
MTAMy Talk Address. Assigns the active
GPIB board as the talker.
MLAMy Listen Address. Assigns the active
GPIB board as the listener.
DATAStarts the data part. Before the DATA
command, the GPIB board has to be set
as the talker. Strings are enclosed by
quotes(') and sent as characters.
"LISTEN 1 2 3"
meaning: config devices whose GPIB
address are 1, 2 and 3, as listeners.
"TALK 0"
meaning: config device whose GPIB
address is 0, as talker.
"TALK 0 SEC 1"
meaning: config device whose primary GPIB
address is 0 and secondary address is 1 as
talker.
"MTA"
"MLA"
"DATA 'hello' 13 10"
ENDSends terminator characters. DATA
command should be called before this
command.
RENRemote Enable"REN"
EOIEnd-or-Identify. The data bytes following
EOI are the last bytes to transmit. The
last byte is sent with the EOI signal.
GTLGo To Loc al"GTL "
SPESerial Poll Enable"SPE"
SPDSerial Poll Disable"SPD"
PPCParallel Poll Configure"PPC"
PPDParallel Poll Disable"PPD"
PPUParallel Poll Unconfigure "PPU"
DCLDevice Clear"DCL"
LLOLocal Lockout"LLO"
CMDStarts GPIB command. The values