Tektronix Using Keithley DriverLINX with DDA-08 or DDA-16 (200KB) User manual
Keithley DDA-08/16
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 DDA-08/16: Using DriverLINX with Your Hardware
Copyright 1998, Scientific Software Tools, Inc.
All rights reserved.
Second Printing.
SST 19-1098-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 DDA-08/16 11
Introduction..............................................................................................................................11
Configure DriverLINX Device Dialog.....................................................................................11
Using the DDA-08/16 with DriverLINX 20
Introduction..............................................................................................................................20
DriverLINX Hardware Model for DDA-08/16........................................................................20
Connecting Signals to the DDA-08/16 .....................................................................................24
Device Subsystem....................................................................................................................25
Analog Output Subsystem........................................................................................................26
Digital Input Subsystem...........................................................................................................37
Device Subsystem Page.............................................................................................13
Analog Output Subsystem Page.................................................................................16
Digital Input Subsystem Page....................................................................................18
Counter/Timer Subsystem Page.................................................................................19
DriverLINX Subsystems............................................................................................20
DriverLINX Modes ...................................................................................................21
DriverLINX Operations and Events..........................................................................22
Logical Channels.......................................................................................................23
Buffers.......................................................................................................................23
Analog Output Subsystem Signals .............................................................................24
Digital Input Subsystem Signals................................................................................24
Counter/Timer Subsystem Signals.............................................................................25
Device Modes............................................................................................................25
Device Operations .....................................................................................................25
Analog Output Modes................................................................................................26
Analog Output Operations.........................................................................................26
Analog Output Timing Events...................................................................................26
Analog Output Start Events .......................................................................................30
Analog Output Stop Events........................................................................................31
Analog Output Channels............................................................................................32
Analog Output Buffers...............................................................................................34
Analog Output Data Coding ......................................................................................35
Analog Output Messages...........................................................................................36
Digital Input Modes...................................................................................................37
Digital Input Operations............................................................................................37
Using DriverLINX With Your Hardware Contents • 3
Digital Input Timing Events.......................................................................................37
Digital Input Channels...............................................................................................37
Counter/Timer Subsystem........................................................................................................38
Glossary of Terms 43
4 • Contents Using DriverLINX With Your Hardware
Preface
Software License and Software Disclaimer of Warranty
This is a legal document which is an agreement between you, the Licensee, and Scientific 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 Warrant y.
This Agreement constitutes the c omplete Agreement between Licensee and Scientific Software Tools, Inc. If Licensee does not
agree to the terms of this Agreement, do not open the diskette pack age. Promptly ret urn the 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 refunds 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, I nc. 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 the s oftware to a single hard disk only.
The written materials acc ompanying the software may not be dupl i cated or copied for any reason.
Trade Secret. Licensee understands and agrees that the software is the proprietary and c onfidential propert y of Sci entific S oftware
Tools, Inc. and a valuable trade secret. Licensee agrees t o use the soft ware only for the i ntended use under this Li cense, 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 rel ated documentation without the prior written
consent of Scientific Software Tools, Inc. All modifications, adaptations, and merged portions of t he software cons titute t he soft ware
licensed to the Licensee, and the terms and condit ions of this agreem ent apply to s ame. Licensee may not distribute c opies, inc luding
electronic transfer of copies, of t he modified, adapted or merged sof tware or acc ompanying writ ten mat erials to ot hers. Li censee agrees
not to reverse engineer, decompil e or di sassemble any part of the s oftware.
Unauthorized copying of the s oftware, incl uding software that has been modified, merged, or included wi th other soft ware, 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 t o
take all reasonable steps to protect Scientific Software Tools’ software from theft, disclosure or use contrary to the terms of the License.
License. Scientific Software Tools, Inc. grants the Licensee only a non-excl usive right t o use the serial ized copy of the software on
a single terminal connect ed to a single computer. The Licensee may not net work the software or us e it on more than one c omputer or
computer terminal at the s ame time.
Term. This License is ef fective until terminated. This License will terminate automatically wit hout notice from Scientific Software
Tools, Inc. if Lic ensee f ails to c ompl y wit h any t erm or c ondit ion of thi s Lic ense. The Lic ensee agrees upon suc h termi nation t o ret urn or
destroy the written materials and all copies of the s oftware. The Licensee may t erminate the agreement by returni ng or destroying the
program and documentation and all copies thereof.
Using DriverLINX With Your Hardware Preface • 5
Limited Warranty
Scientific Software Tools, Inc . warrants that the software will perform s ubstantially in ac cordance with the writt en materials and that
the program disk, instruc tional manuals and ref erence materials are free f rom defects in materials and workmanshi p under normal use
for 90 days from the date of receipt. All express or implied warranties of the soft ware and rel at ed materials are limited to 90 days.
Except as specifical ly set forth herein, the sof tware and accom panying writ ten materi als (incl uding inst ructions for use) are p rovided
“as is” without warranty of any kind. Further, Sc ientific Software Tool s, Inc. does not warrant, guarantee, or make any repres entations
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, acc uracy , rel iabil ity, 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 Scientif ic Software
Tools, Inc. or its di stributors, agents or employees.
EXCEPT AS SET FORTH HERE IN, THE RE ARE NO OTHE R WARRANTIE S , E IT HER 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 ACCOM P ANYING HARDWARE.
Remedy. Scientific Sof tware Tools’ ent ire liability and the Licens ee’s ex clus ive remedy s hall be, at S cient ific Sof tware Tools’ option,
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 S cientific 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 DELI VERY OF THIS PRODUCT S HALL BE LIABLE FOR ANY DI RECT, INDIRECT, CONS EQUENTIAL,
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 INABILI TY TO USE SUCH P RODUCT 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 IMP LIED WARRANTY, THE ABOVE LIMITATIONS MAY NOT APPLY TO
LICENSEE.
This agreement is governed by t he l aws of the Commonwealth of Pennsyl vania.
6 • Preface Using DriverLINX With Your Hardware
About DriverLINX
Welcome to DriverLINX for Microsoft Windows, the high-performance realtime data-acquisition device drivers for Windows application develop ment.
DriverLINX is a language- and hardware-independent 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 demonstrates sever al 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 the
hardware features of Keithley’s DDA-08/16 boards with DriverLINX.
•
For help installing and configuring your hardware 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 DDA-08/16
Shows how to configure the DDA-08/16 using the Configure DriverLINX Device
dialog box.
Using DriverLINX With Your Hardware Preface • 7
Using the DDA-08/16 with DriverLINX
Shows how to set up DriverLINX with the Edit Service Request dialog box to use
DDA-08/16 hardware features.
8 • Preface Using DriverLINX With Your Hardware
Conventions Used in This Manual
The following notational conventions are used in this manual:
•
A round bullet (•) identifies itemized lists.
•
Numbered lists indicate step-by-step procedures.
•
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 bounds a table of information.
Tables
Concept
•
Important concepts and notes are printed in the left margin.
Using DriverLINX With Your Hardware Preface • 9
Configuring the DDA-08/16
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 DDA-08/16 boards.
Installing and configuring DriverLINX for the Keithley DDA-08/16 boards 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 DDA-08/16
model.
3. Install your DDA-08/16 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 resour ces and a
DriverLINX Logical Device number to a specific DDA-08/16 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
.
Using DriverLINX With Your Hardware Configuring the DDA-08/16 • 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 DDA-08/16 model. The following sections
describe your choices in configuring Dr iverLINX to work with your board.
12 • Configuring the DDA-08/16 Using DriverLINX With Your Hardware
Device Subsystem Page
Use the Device Subsystem page to tell DriverLINX the model name and address of
your DDA-08/16 board.
Vendor
The Vendor property displays “Keithley Instruments, Inc.” It is a read-only property.
Device
Windows NT
Windows 95/98
Windows NT
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:
DDA-08
DDA-16
Under Windows 95/98, DriverLINX displays the model you chose during
installation. To install a different model, cancel the configuration and run Add New
Hardware from the Windows Control Panel.
Address
The Address property records the I/O port address for the board. The default address
used by DriverLINX is 768 decimal or 0x300 hex. If you have another peripheral
board at that address, select a different base address. Note: you need a block of eight
free addresses for a DDA-08/16 board.
Windows 95/98
Using DriverLINX With Your Hardware Configuring the DDA-08/16 • 13
Under Windows 95/98, Add New Hard ware automatically selects an appropriate
address. To change the address, see “Using the Windows 95/98 Device Manager” on
page 14.
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 DDA-08/16 because it does not support automatic calibration.
Special…
The Special… button displays a dialog for configuring any special, hardware-specific
settings. For the DDA-08/16, Logical Device c onfiguration does not r equire any
special settings so DriverLINX disables the Special… button.
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 Device Manager:
1. Start the Device Manger by right-clicking 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.
next to , if necessary to expand the
next to it.)
9. When you are done, click OK to close the board’s property page.
14 • Configuring the DDA-08/16 Using DriverLINX With Your Hardware
Loading...