Information in this document is subject to change without notice. The software
described is this document is furnished under a license agreement. The software may
be used or copied only in accordance with the terms of the agreement.
SCIENTIFIC SOFTWARE TOOLS, INC. SHALL NOT BE LIABLE FOR ANY
SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES RELATED TO
THE USE OF THIS PRODUCT. THIS PRODUCT IS NOT DESIGNED WITH
COMPONENTS OF A LEVEL OF RELIABILITY SUITABLE FOR USE IN LIFE
SUPPORT OR CRITICAL APPLICATIONS.
This document may not, in whole or in part, be copied, photocopied, reproduced,
translated or reduced to any electronic medium or machine readable form without
prior written consent from Scientific Software Tools, Inc.
Keithley KPCI-3130 Series: Using DriverLINX with Your Hardware
Copyright 2000 by Scientific Software Tools, Inc.
All rights reserved.
Second Printing.
SST 32-1000-1
DriverLINX, SSTNET, and LabOBJX are registered trademarks and
DriverLINX/VB is a trademark of Scientific Software Tools, Inc.
MetraByte is a trademark of Keithley Instruments, Inc.
Microsoft and Windows are registered trademarks and Visual C++ and Visual Basic
are trademarks of Microsoft Corporation.
Borland is a registered trademark and Borland C++ and Delphi are trademarks of
Borland International, Inc.
All other brand and product names are trademarks or registered trademarks of their
respective companies.
Contents
Preface5
Software License and Software Disclaimer of Warranty............................................................5
About DriverLINX.....................................................................................................................7
About This User’s Guide...........................................................................................................7
Conventions Used in This Manual.............................................................................................9
Generating a DriverLINX Configuration Report......................................................................75
What is in the Report?................................................................................................75
How do I Generate the Report?..................................................................................75
Glossary of Terms77
4 • Keithley KPCI-3130 Series
Preface
Software License and Software Disclaimer of Warranty
This is a legal document which is an agreement between you, the Licensee, and S cientific Software Tools, Inc. By opening this
sealed diskette pack age, Licensee agrees to become bound by t he terms of this Agreement , which include the Software License and
Software Disclaimer of Warranty.
This Agreement constitutes the c omplete Agreement between Licensee and Scientific S oftware Tools, Inc. If Licensee does not
agree to the terms of this Agreement, do not open the diskette pack age. Promptly return t he unopened diskette pac kage and the other
items (including writt en materials, binders or ot her containers, and hardware, if any ) that are part of this product to Sc ientific Software
Tools, Inc. for a full refund. No ref unds will be given for products that have opened disk packages or missing components.
Licensing Agreement
Copyright. The software and documentation is owned by Scientific Software Tools, Inc . and is protected by both United States
copyright laws and internati onal treaty provisions. Scientif ic Software Tools, Inc. authorizes the original purchaser only (Licensee) to
either (a) make one copy of the s oftware solely f or backup or archival purpos es, or (b) transfer t he software to a single hard disk only.
The written materials acc om panying the software may not be duplicated or copied for any reason.
Trade Secret. Licensee understands and agrees that t he software is the proprietary and conf idential property of Scienti fic Soft ware
Tools, Inc. and a valuable trade secret. Licensee agrees t o use the soft ware only for the int ended use under this Lic ense, and shall not
disclose the soft ware or i t s contents to any third part y.
Copy Restrictions. The Licensee may not modify or translate the program or relat ed documentation without the prior written
consent of Scientific Software Tools, Inc. All modifications, adaptat ions, and merged porti ons of the sof tware consti tute the s oftware
licensed to the Licensee, and the terms and condit ions of this agreem ent apply to sam e. Licensee may not distribute c opies, inc luding
electronic transfer of copies, of the m odified, adapt ed or merged sof tware or accom panying writt en material s to others . Licens ee agrees
not to reverse engineer, decompil e or di sassemble any part of the s of tware.
Unauthorized copying of the s oftware, incl uding software that has been modified, merged, or included wit h other software, or of the
written materials is expressly forbidden. Licensee may not rent, trans fer or lease the software to any t hird parties. Licensee agrees to
take all reasonable steps to protect Scientific Software Tools’ software from theft, disclosure or use contrary to the terms of the Licens e.
License. Scientific Software Tools, Inc. grants the Licensee only a non-exclus ive right t o use the serializ ed copy of t he software on
a single terminal connected t o a single computer. The Licensee may not net work the software or use it on more than one com puter or
computer terminal at the s ame time.
Term. This License is eff ective until terminated. This License will terminate automatically without not ice from Scientific Software
Tools, Inc. if Lic ensee f ails to c ompl y wit h any t erm or c onditi on of thi s Lic ense. The Lic ens ee agrees upon s uch t erminat ion to ret urn or
destroy the written materials and all copies of the sof tware. The Licensee may t erminate the agreement by returning or des troying the
program and documentation and all copies thereof.
Keithley KPCI-3130 SeriesPreface • 5
Limited Warranty
Scientific Software Tools, Inc. warrants that the s oftware will perform subst antially in accordance wit h the written materials and t hat
the program disk, instruc tional manuals and ref erence materials are free f rom defects in materials and workmanship under normal use
for 90 days from the date of receipt. All express or im pl i ed warranties of the software and related materials are limited to 90 days.
Except as specifical ly set forth herein, the sof tware and accom panying writ ten material s (incl uding inst ructions for use) are prov ided
“as is” without warranty of any kind. Further, Sci entific Software Tools , Inc. does not warrant, guarantee, or make any represe ntations
regarding the use, or the results of the use, of the soft ware or writt en mat erials in t erms of correc tnes s , ac curac y, reliabi lit y, current ness ,
or otherwise. The entire risk as to the results and performance of the soft ware is assumed by Licens ee and not by Scientifi c Software
Tools, Inc. or its distributors, agents or employees.
EXCEPT AS SET FORTH HEREIN, THE RE ARE NO OTHER WARRANT IE S, EI THER EXPRESS OR IMPLIED, INCLUDING BUT
NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, WITH
RESPECT TO THE SOFTWARE, THE ACCOMPANYING WRITTEN MATERIALS, AND ANY ACCOMP ANYING HARDWARE.
Remedy. Scientific Soft ware Tools’ ent ire liability and t he Licens ee’s ex clus ive remedy s hall be, at Sc ientific S oftware Tools’ opt ion,
either (a) return of the price paid or (b) repair or replacement of the software or accompanying materials . In the event of a defect in
material or workmanship, t he item may be returned within the warranty period to S cientific Software Tools f or a replacement without
charge, provided the licensee prev iously sent in the limited warranty registration board to Sc ientific S oftware Tools, Inc ., or can furnis h
proof of the purchase of the program. This remedy is void if failure has resulted from accident, abuse, or misapplication. Any
replacement will be warranted for the remainder of the original warranty period.
NEITHER SCIENTIFIC SOFTWARE TOOLS, INC. NOR ANYONE ELSE WHO HAS BEEN INVOLVED IN THE CREATION,
PRODUCTION, SALE OR DELIV ERY OF THIS PRODUCT SHALL BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTI AL,
OR INCIDENTAL DAMAGES (INCLUDING DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF
BUSINESS INFORMATION AND THE LIKE) ARISING OUT OF THE USE OF OR THE INABILITY TO USE SUCH PRODUCT EVEN
IF SCIENTIFIC SOFTWARE TOOLS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. BECAUSE SOME
JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL
DAMAGES, OR LIMITATIONS ON DURATION OF AN IMPLI ED WARRANTY, THE ABOVE LIMITATIONS MAY NOT APPLY TO
LICENSEE.
This agreement is governed by the laws of the Commonwealth of Pennsylvania.
6 • PrefaceKeithley KPCI-3130 Series
About DriverLINX
Welcome to DriverLINX for Microsoft Windows, the high-performance realtime data-acquisition device drivers for Windows application development.
DriverLINX is a language- and hardware-indepe ndent applic ation programming
interface designed to support hardware manufacturers’ high-speed analog, digital,
and counter/timer data-acquisition boards in Windows. DriverLINX is a multi-user
and multitasking data-acquisition resource manager providing more than 100 services
for foreground and background data acquisition tasks.
Included with your DriverLINX package are the following items:
•The DriverLINX API DLLs and drivers supporting your data-
acquisition hardware
•Analog I/O Panel, a DriverLINX program that verifies the installation
and configuration of DriverLINX for your analog output board and
demonstrates several virtual bench-t op instruments
•Source code for the sample programs
•The DriverLINX Application Programming Interface files for your
compiler
•DriverLINX On-line Help System
•DriverLINX Analog I/O Programming Guide
•DriverLINX Technical Reference Manual
•Supplemental Documentation on DriverLINX and your data-acquisition
hardware
About This User’s Guide
The purpose of this manual is to help you quickly learn how to configure and use t he
hardware features of Keithley’s KPCI-3130 Series boards with DriverLINX.
•For more information on the DriverLINX API, please see the
DriverLINX Technical Reference Manual.
•For additional help programming your board, please examine the source
code examples on the Distribution Disks.
This manual contains the following chapters:
Configuring the KPCI-3130 Series
Shows how to configure the KPCI-3130 Series using the Configure DriverLINX
Device dialog box.
Using the KPCI-3130 Series with DriverLINX
Shows how to set up DriverLINX with the Edit Service Request dialog box to use
KPCI-3130 Series hardware features.
Uninstalling DriverLINX
Describes how to remove DriverLINX hardware drivers and other files.
Troubleshooting
Keithley KPCI-3130 SeriesPreface • 7
Gives troubleshooting tips for installing, configur ing, and loading D riverLINX
drivers.
8 • PrefaceKeithley KPCI-3130 Series
Conventions Used in This Manual
The following notational conventions are used in this manual:
•A round bullet (•) identifies itemized lists.
•Numbered lists indicate a step-by-step procedure.
•DriverLINX Application Programming Interface and Windows macro
and function names are set in bold when mentioned in the text.
•DriverLINX indicates the exported function name of the device driver
DLL while DriverLINX indicates the product as a whole.
•DriverLINX Application Programming Interface identifiers, menu
items, and Dialog Box names are italicized when mentioned in the text.
•Italics are used for emphasis.
•Source code and data structure examples are displayed in Courier
typeface and bounded by a box with a single line.
Code
•A box with a double line bound tables of information.
Tables
Concept
•Important concepts and notes are printed in the left margin.
Keithley KPCI-3130 SeriesPreface • 9
Configuring the KPCI-3130 Series
Introduction
The installation program provides general instructions for installing and configuring
DriverLINX. This manual explains the steps and special features that apply to
Keithley’s KPCI-3130 Series boards.
Installing and configuring DriverLINX for a Keithley KPCI-3130 Series board
requires three steps:
1. Install DriverLINX. Follow the instructions given by the installation
program. The Read Me First instructions explain the components and
drivers you can install.
2. Configure DriverLINX. This creates a Logical Device, which stores
configuration information for your board. See “Configure Dri verLINX
Device Dialog” on page 12 for configuration options specific to a
Keithley KPCI-3130 Series model.
Windows NT
3. Install yourKPCI-3130 hardware. Follow the instructions in your
hardware manual.
After configuring DriverLINX, instal l ing your board and restarting Windows, reopen
the DriverLINX Configuration Panel to make sure that DriverLINX loaded the
Logical Device for your board. If the Logical Device is not loaded, the Event Log
may have a message from the driver that explains why. You can check the Event Log
using the DriverLINX Event Viewer on the Windows Start Menu.
Under Windows NT 4.0, a Logical Device may not load because the operating
system does not always configure Plug-and-Play PCI devices properly. To work
around this, set your computer’s BIOS to configure Plug-and-Play devi ces before it
starts the operating system. On various computers the BIOS setting is called “Plugand-Play Aware OS – Disabled” or “Plug & Play OS – No”.
Keithley KPCI-3130 SeriesConfiguring the KPCI-3130 Series • 11
Configure DriverLINX Device Dialog
DriverLINX uses a standardized configuration protocol for all data-acquisition
hardware. Configur ation assigns an identi fying device number to a specific KPCI3130 Series board in your computer and allows you to set the emulated analog output
resolution and data format.
The installation program automatically starts the DriverLINX Configuration Panel.
To start it now, use the shortcut on the Windows Start Menu.
When you click the Configure… button on the DriverLINX Configuration Panel,
DriverLINX displays the Configure DriverLINX Device dialog. The dialog has a
page for each subsystem on the Keithley KPCI-3130 Series. The following sections
describe your choices in configuring DriverLINX to work with your board.
12 • Configuring the KPCI-3130 SeriesKeithley KPCI-3130 Series
Device Subsystem Page
Use the Device subsystem page to tell DriverLINX the model name of your KPCI3130 Series board, and, optionally, the emulated analog output resolution and data
format and to enable digital I/O testing.
Vendor
The Vendor property displays “Keithley Instruments, Inc.” It is a read-only property.
Device
Windows NT
Windows 2000
Windows 95/98
The Device property designates the Logical Device you are configuring. It is a readonly property. To change it, first save (OK) or quit (Cancel) the current
configuration. Then select or create a new Logical Device using the DriverLINX
Configuration Panel.
Model
The Model property selects or indicates the hardware model of the board you’re
configuring.
Select one of the following models:
KPCI-3130
KPCI-3132
Windows 95/98 automatically determines the model of your board so DriverLINX
disables Model selection.
Board Id
The Board Id property associates this Logical Device with a specific board.
DriverLINX automatically enters the KPCI-3130’s serial number in this field.
DriverLINX use s the board’s ser ial number to uniquely recognize boards if you have
installed multiple boards of the same model into your computer.
Keithley KPCI-3130 SeriesConfiguring the KPCI-3130 Series • 13
Windows NT
Windows 2000
Under Windows NT or Windows 2000, Board Id is initially blank. DriverLINX will
use the Model setting to match this Logical Device to the first available board and
then enter that board’s serial number.
Windows 95/98
Windows 95/98 automatically determines which board to associate with this Logical
Device. DriverLINX enters the serial number of the board when it starts the
configuration.
Detect
The Detect property enables and disables DriverLINX’s hardware detection and
testing algorithms. For maximum system reliability, always leave this check-box
marked.
Calibrate
The Calibrate property enables and disables hardware auto-calibration. This option is
grayed-out for the KPCI-3130 Series because it does not support automatic
calibration.
Special…
The Special… button displays the following dialog box of KPCI-3130 Series-specific
configuration options:
Enable walking bit test (Model KPCI-3130 only)
DriverLINX can perform a Walking-Bit Test when it next loads this Logical Device.
The Walking-Bit Test checks your KPCI-3130 Series board for internal digital
input/output line damage.
To perform the Walking-Bit Test:
1. Enable the test using the check box.
2. Remove the cable from your board
3. Restart your computer.
½ If the driver finds a damaged line, it makes an entry in the Event Log
and does not load the Logical Device.
½ If the test passes, the driver loads the Logical Device and clears the
check box so the test does not run again.
Important: You must remove the cable from your board for a successful test.
14 • Configuring the KPCI-3130 SeriesKeithley KPCI-3130 Series
DA Resolution
DA resolution determines the data coding format and data width of digital-to-analog
samples. For the KPCI-3130 Series, the normal resolution for analog-output data
coding is 20 bits. DriverLINX provides three options for analog-output resolutions
for compatibility with application written for other hardware.
ResolutionFormatWidthUsage
20 BitsRight-justified
two’s complement
16 BitsTwo’s complement 2 BytesCompatible with
12 BitsRight-justified
two’s complement
*You would need one of these settings only for applications that do not use
DriverLINX’s hardware-independent data conversion functions.
4 BytesNormal setting
applications that
assume samples
are two bytes
wide*
2 BytesCompatible with
applications that
assume a rightjustified, 12-bit,
two’s complement
format*
Keithley KPCI-3130 SeriesConfiguring the KPCI-3130 Series • 15
Analog Output Subsystem Page
Use the Analog Output subsystem page to set or view the initial output voltages.
Channels
Lists the analog output channels on the board and selects a channel for the Volts and
Initialize properties.
The KPCI-3130 Series has a single, fixed analog output range or +/-10V.
DriverLINX grays out this property in the configuration dialog.
16 • Configuring the KPCI-3130 SeriesKeithley KPCI-3130 Series
Volts
The Initialization Value property specifies the analog output value DriverLINX will
write to the selected Logical Channel upon hardware initialization. DriverLINX only
writes this value if you enable the Initialize check box.
Interrupt
Windows automatically determines the interrupt level for the KPIC-3130 Series
board. DriverLINX disables this property.
DMA
The KPCI-3130 Series does not use DMA channels for direct memory transfers.
DriverLINX disables this property.
Initialize
Checking the Initialize check box instructs DriverLINX to use the Volts property for
to initialize the selected analog output channel.
Keithley KPCI-3130 SeriesConfiguring the KPCI-3130 Series • 17
Digital Input Subsystem Page
Use the Digital Input subsystem page to set configurable digital channels as input or
output.
Channels
The Channels propert y allows you to select a Logi cal Channel for configuration or
viewing the channel’s range.
The KPCI-3130 Series supports both fixed and configurable digital channels.
DriverLINX defines the following Logical Channels for the KPCI-3130 Series
Digital Input Subsystem:
Model KPCI-3130
Logical
Channel
0Digital Input/OutputBit 0, DGND … Bit 7, DGND
1Digital Input/OutputBit 8, DGND … Bit 15, DGND
2Digital Input/OutputBit 16, DGND … Bit 23, DGND
3Digital Input/OutputBit 24, DGND … Bit 31, DGND
4Digital Input/Output
5Reserved
6External Clock
7External Trigger
Model KPCI-3132
DriverLINX
Function
(read DAC overload
flags)
(sample on DAC
overload)
(trigger on DAC
overload)
KPCI-3130 Series External
Connector
S1H,S1L … S8H, S8L
S1H,S1L … S8H, S8L
S1H,S1L … S8H, S8L
LogicalDriverLINXKPCI-3130 Series External
18 • Configuring the KPCI-3130 SeriesKeithley KPCI-3130 Series
The Range property specifies the supported digital input range for the selected
Logical Channel. This is a read-only property.
Interrupt
Windows automatically determines the interrupt level for the KPIC-3130 board.
DriverLINX disables this property.
DMA
The KPCI-3130 Series does not use DMA channels for direct memory transfers.
DriverLINX disables this property.
Configuration Setup
The Configuration Setup property specifies the hardware configuration of the digital
I/O ports. Logical Channels 0 through 3 are configurable as input or output. A setup
value of 1 initially configures the selected channel as input; 0 initially configures it as
output.
To specify an initial configuration:
1. Select the Channel to configure
2. Select Dec (decimal) or Hex (hexadecimal)
3. Enter a Setup value
4. Check the Initialize box
5. Repeat for each channel
After completing the device configuration, click OK and restart Windows to reload
the device with the new configuration.
Note: Channels configured as output can have initial output values other than the
hardware default. See “Initialization Value” on page 22.
Keithley KPCI-3130 SeriesConfiguring the KPCI-3130 Series • 19
Initialize
Checking the Initialize check box instructs DriverLINX to use the Configuration
Setup property to configure the selected digital I/O channel.
20 • Configuring the KPCI-3130 SeriesKeithley KPCI-3130 Series
Digital Output Subsystem Page
Use the Digital Output subsystem page to change the default digital output port
initialization values.
Channels
The Channels property allows you to select a Logical Channel for initialization or
viewing the channel’s range.
Models KPCI-3130
Logical
Channel
0Digital Input/OutputBit 0, DGND … Bit 7, DGND
1Digital Input/OutputBit 8, DGND … Bit 15, DGND
2Digital Input/OutputBit 16, DGND … Bit 23, DGND
3Digital Input/OutputBit 24, DGND … Bit 31, DGND
4Digital Input/Output
Keithley KPCI-3130 SeriesConfiguring the KPCI-3130 Series • 21
Range
The Range property specifies the supported digital output range for the selected
Logical Channel. This is a read-only property.
Interrupt
Windows automatically determines the interrupt level for the KPIC-3130 board.
DriverLINX disables this property.
DMA
The KPCI-3130 Series does not use DMA channels for direct memory transfers.
DriverLINX disables this property.
Initialization Value
The Initialization Value property specifies the digital output value DriverLINX will
write to the selected Logical Channel upon hardware initialization. DriverLINX only
writes this value if you enable the Initialize check box.
To specify an initial output value:
1. Select the Channel to initialize
2. Select Dec (decimal) or Hex (hexadecimal)
3. Enter an Initialization value
4. Check the Initialize box
5. Repeat for each channel
Initialize
Checking the Initialize check box instructs DriverLINX to use the Initialization
Value property for digital output port initialization.
Dec
This check box converts the Initialization Value property to decimal.
Hex
This check box converts the Initialization Value property to hexadecimal.
22 • Configuring the KPCI-3130 SeriesKeithley KPCI-3130 Series
Counter/Timer Subsystem Page
Use the Counter/Timer subsystem page to set the default clock source frequency.
Resolution
The KPCI-3130 Series does not have a clock. DriverLINX provides a counter/timer
subsystem so that changes in DAC overload conditions can pace sampling the DAC
overload status registers Therefore, DriverLINX disables the Resolution property.
Interrupt
Windows automatically determines the interrupt level for the KPIC-3130 Series
board. DriverLINX disables this property.
Keithley KPCI-3130 SeriesConfiguring the KPCI-3130 Series • 23
Loading...
+ 55 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.