Tektronix Using Keithley DriverLINX with DAS-TC/B (500KB) User manual
Keithley DAS-TC/B
Using DriverLINX with Your
Hardware
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 DAS-TC/B: Using DriverLINX with Your Hardware
Copyright 1999 by Scientific Software Tools, Inc.
All rights reserved.
First Printing.
SST 22-0599-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.
2
Contents
Preface 5
Software License and Software Disclaimer of Warranty............................................................5
About DriverLINX.....................................................................................................................7
About This User’s Guide...........................................................................................................7
Conventions Used in This Manual.............................................................................................9
Configuring the DAS-TC/B 11
Introduction..............................................................................................................................11
Configure DriverLINX Device Dialog.....................................................................................11
Using the DAS-TC/B with DriverLINX 19
Introduction..............................................................................................................................19
DriverLINX Hardware Model for DAS-TC/B.........................................................................19
Connecting Signals to the DAS-TC/B......................................................................................23
Device Subsystem....................................................................................................................24
Analog Input Subsystem ..........................................................................................................25
Counter/Timer Subsystem........................................................................................................43
Device Subsystem Page.............................................................................................13
Analog Input Subsystem Page ...................................................................................17
Counter/Timer Subsystem Page.................................................................................18
DriverLINX Subsystems............................................................................................19
DriverLINX Modes ...................................................................................................20
DriverLINX Operations and Events..........................................................................21
Logical Channels.......................................................................................................21
Buffers.......................................................................................................................22
Analog Input Subsystem Signals................................................................................23
Device Modes............................................................................................................24
Device Operations .....................................................................................................24
Analog Input Modes..................................................................................................25
Analog Input Operations............................................................................................25
Analog Input Timing Events......................................................................................26
Analog Input Start Events..........................................................................................31
Analog Input Stop Events..........................................................................................31
Analog Input Channels...............................................................................................33
Analog Input Buffers .................................................................................................40
Analog Input Data Coding.........................................................................................40
Analog Input Messages..............................................................................................42
Uninstalling DriverLINX 45
How do I uninstall DriverLINX? .............................................................................................45
Keithley DAS-TC/B Contents • 3
Troubleshooting 47
Solving Problems.....................................................................................................................47
Solving Problems Installing Drivers..........................................................................47
Solving Problems Configuring the Drivers................................................................47
Solving Problems Loading Drivers............................................................................48
Generating a DriverLINX Configuration Report.....................................................................51
What is in the Report? ...............................................................................................51
How do I Generate the Report?.................................................................................51
Glossary of Terms 52
4 • Contents Keithley DAS-TC/B
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 DAS-TC/B Preface • 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 furnish
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 US E 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 • Preface Keithley DAS-TC/B
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 dataacquisition hardware
•
Analog I/O Panel, a DriverLINX program that verifies the installation
and configuration of DriverLINX for your analog input/output board
and demonstrate s several virtual bench-top instruments
•
Learn DriverLINX, an interactive learning and demonstration program
for DriverLINX that includes a Digital Storage Oscilloscope
•
Source code for the sample programs
•
The DriverLINX Application Programming Interface files for your
compiler
•
DriverLINX On-line Help System
•
DriverLINX 4.0 Installation and Configuration Guide
•
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 DAS-TC/B with DriverLINX.
•
For help instal l ing and configuring your ha rdware and DriverLINX,
please see the manual that accompanied your hardware and the
DriverLINX 4.0 Installation and Configuration Guide for your version
of Windows.
•
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 DAS-TC/B
Shows how to configure the DAS-TC/B using the Configure DriverLINX Device
dialog box. All users need to understand this information.
Keithley DAS-TC/B Preface • 7
Using the DAS-TC/B with DriverLINX
Shows how to set up DriverLINX with the Edit Service Request dialog box to use
DAS-TC/B hardware features. Only developers need this information but should first
be familiar with programming DriverLINX in general. See the DriverLINX
Technical Reference Manual or DriverLINX/VB Technical Reference Manual.
Uninstalling DriverLINX
Describes how to remove DriverLINX hardware drivers and other files.
Troubleshooting
Gives troubleshooting tips for installing, configur ing, and loading D riverLINX
drivers.
8 • Preface Keithley DAS-TC/B
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 DAS-TC/B Preface • 9
Configuring the DAS-TC/B
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 DAS-TC/B.
Installing and configuring DriverLINX for the Keithley DAS-TC/B 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. See “Configure DriverLINX Device Dialog”
on page 11 for configuration options specific to a Keithley DAS-TC/B
board.
3. Install your DAS-TC/B hardware, read and follow the instructions in
your hardware manual.
Configure DriverLINX Device Dialog
DriverLINX uses a standardized configuration protocol for all data-acquisition
hardware. Configuration assigns a port address, interrupt resources a nd a
DriverLINX Logical Device number to a specific DAS-TC/B board in your
computer.
The installation program automatically starts the DriverLINX Configuration Panel.
To start it again later, use the shortcut on the Windows Start Menu or click here
.
Keithley DAS-TC/B Configuring the DAS-TC/B • 11
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 a Keithley DAS-TC/B board. The following sections
describe your choices in configuring DriverLINX to work with your board.
12 • Configuring the DAS-TC/B Keithley DAS-TC/B
Device Subsystem Page
Use the Device subsystem page to tell DriverLINX the address and, optionally,
configure the channels on your DAS-TC/B board.
Vendor
The Vendor property displays “Keithley Instruments, Inc.” It is a read-only property.
Device
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 indicates the hardware model of the board you’re configuring. The DAS-TC/B driver supports only the following model:
DAS-TC/B
Address
The Address property records the I/O port address for the board. The default address
used by DriverLINX is 0x300 hexadecimal or 768 decimal.
The DAS-TC/B has a 7-bit dipswitch that sets its base address. Each switch
corresponds to a binary digit in the address. When a switch is up, or in the ON
position, its digit is 0. When it’s down, its digit is 1.
The switches select the value of the 1
address are 0. That is, there are three zeros to the right of the bits represented by the
switches.
For example, the following dipswitch shows the setting for 11 0000 0000
(0x300 hexadecimal or 768 decimal).
st
to the 7th digits. The 8th to the 10th digits of the
Keithley DAS-TC/B Configuring the DAS-TC/B • 13
Windows NT
Enter your board’s base I/O address. Note: you need a block of four free addresses.
Windows 95/98
Under Windows 95/98, Add New Hardware automatically selects an appropriate
address. To change the setting, see “Using the Windo ws 95/98 Device Ma nager” on
page 16.
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. The DASTC/B can automatically calibrate its analog-to-digital converter—Use the setting on the Analog Input page.
Special…
The Special… button displays the following dialog box of DAS-TC/B-specific
configuration options:
14 • Configuring the DAS-TC/B Keithley DAS-TC/B
Normal Mode Rejection Frequency
You can select a Normal Mode Rejection Frequency for your DAS-TC/B.
DriverLINX uses this NMRF for all sampling unless an application requests a
different frequency for its tasks. Select one of the following NMRFs:
•
50 Hz
•
60 Hz
•
400 Hz
You would usually select t he NMRF to match you power supply frequency to reduce
the effects of some types of noise. See your DAS-TC/B User’s Guide for more
information.
Channel Configuration
You can configure your DAS-TC/B board with default settings for the analog input
channels. Each voltage/thermocouple channel has default settings for type,
engineering units, cold-junctio n compensation, and gain or thermocouple type. The
CJC channel has a fixed default setting of Volts at unity gain.
To change a channel’s default configuration:
1. Under Type, select the type of data you want from the channel:
•
VOLTS—the board returns channel data in Volts
•
TC—the board returns channel data in degrees using linearization
parameters for the thermocouple’s type
2. Under Gain, select the voltage gain or thermocouple type.
3. Under C/F, select the units for a thermocouple channel:
•
C—the board returns channel data in degrees Celsius
•
F—the board returns channel data in degrees Fahrenheit
4. Under AVG, enter the number of samples you want the board to average
for each data value it returns for the channel. See “Sample Averaging
on the DAS-TC/B” on page 39 or your hardware manual for more
information.
5. Under CJC, enable or disable cold-junction compensation:
•
ON—the board offsets the channel data to account for the voltage
produced by the connection at the screw terminals
•
OFF—the board returns uncompensated channel data
6. Click OK to save these settings or Cancel to quit.
Any application can use these configuration defaults. Applications designed
specifically for the DAS-TC/B can select other settings using special gain codes (see
“Analog Input Gain Codes” on page 36).
Keithley DAS-TC/B Configuring the DAS-TC/B • 15
Using the Windows 95/98 Device Manager
Under Windows 95/98, DriverLINX uses the address and interrupt settings
maintained by the Windows Device Manager.
To view or change the settings for your board using the Devi ce Manager:
1. Start the Device Manger by right-clic king on My Computer and
selecting Properties or click here
2. Click the Device Manger tab.
.
3. Click the
list.
4. Under DriverLINX drivers, select the entry for your board. (It may or
may not have
5. Click the Properties button.
6. On the board’s property page, click the Resources tab.
7. To configure the board with an interrupt, use Setting based on “Basic
configuration 0.” Or, to configure the board without an interrupt, use
Setting based on “Basic configuration 1.”
8. To change a setting, select it under Resource Type and click the Change
Setting button. Windows will guide you in selecting an appropriate
value.
9. When you are done, click OK to close the board’s property page.
10. The board’s a ddress switches must match the address setting you select.
If necessary shut down your computer and reposition them as described
in “Address” on page 13.
next to , if necessary to expand the
next to it.)
11. Restart Windows to load the Logical Device for your board using the
new settings.
16 • Configuring the DAS-TC/B Keithley DAS-TC/B
Analog Input Subsystem Page
Use the Analog Input subsystem page to set or view your board’s interrupt request
level. To configure individual Analog Input channels, use the “Special…” button on
the “Device Subsystem Page.”
Channels
The DAS-TC/B has 16 voltage/thermocouple channels and one CJC channel. Each
channel has a programmable range.
Windows NT
Windows 95/98
Range
The analog input ranges for the DAS-TC/B are fully software programmable.
DriverLINX grays out this property in the configuration dialog. Use the “Special…”
button on the “Device Subsystem Page” to configure individual Analog Input
channels.
Interrupt
For Windows NT, select a free interrupt request level to support interrupt-mode
transfers. Valid IRQ settings are: 3, 5, 7, 10, 11, 12, 15 and None.
Under Windows 95/98, Add New Hardware automatically selects an appropriate
interrupt. To change the sett ing, see “Using the Wind ows 95/98 Device Manager” on
page 16.
DMA
The DAS-TC/B does not support DMA. DriverLINX disables this property and
displays it as blank.
Calibrate
The Calibrate property enables and disables hardware auto-calibration.
Keithley DAS-TC/B Configuring the DAS-TC/B • 17
Loading...