Tektronix Using Keithley DriverLINX with DAS-1800 Series (500KB) User manual
Keithley DAS-1800 Series
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-1800 Series: Using DriverLINX with Your Hardware
Copyright 1999 by Scientific Software Tools, Inc.
All rights reserved.
First Printing.
SST 20-0599-2
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
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-1800 Series 11
Introduction..............................................................................................................................11
Configure DriverLINX Device Dialog.....................................................................................11
Using the DAS-1800 Series with DriverLINX 27
Introduction..............................................................................................................................27
DriverLINX Hardware Model for DAS-1800 Series...............................................................27
Connecting Signals to the DAS-1800 Series............................................................................33
Device Subsystem....................................................................................................................37
Analog Input Subsystem ..........................................................................................................38
Device Subsystem Page.............................................................................................13
Analog Input Subsystem Page ...................................................................................19
Analog Output Subsystem Page.................................................................................20
Digital Input Subsystem Page....................................................................................22
Digital Output Subsystem Page .................................................................................24
Counter/Timer Subsystem Page.................................................................................26
DriverLINX Subsystems............................................................................................27
DriverLINX Modes ...................................................................................................28
DriverLINX Operations and Events..........................................................................30
Logical Channels.......................................................................................................32
Buffers.......................................................................................................................32
Analog Input Subsystem Signals................................................................................33
Analog Output Subsystem Signals .............................................................................35
Digital Input Subsystem Signals................................................................................36
Digital Output Subsystem Signals..............................................................................36
Counter/Timer Subsystem Signals.............................................................................36
Device Modes............................................................................................................37
Device Operations .....................................................................................................37
Analog Input Modes..................................................................................................38
Analog Input Operations............................................................................................38
Analog Input Pacing, Triggering and Gating Options................................................38
Analog Input Timing Events......................................................................................40
Analog Input Start Events..........................................................................................49
Analog Input Stop Events..........................................................................................51
Analog Input Channels...............................................................................................53
Analog Input Expansion Channels.............................................................................58
Keithley DAS-1800 Series Contents • 3
Analog Input Buffers .................................................................................................60
Analog Input Data Coding.........................................................................................61
Analog Input Messages..............................................................................................63
Analog Output Subsystem........................................................................................................64
Analog Output Modes................................................................................................64
Analog Output Operations.........................................................................................64
Analog Output Pacing, Triggering and Gating Options.............................................64
Analog Output Timing Events...................................................................................66
Analog Output Start Events .......................................................................................72
Analog Output Stop Events........................................................................................76
Analog Output Channels............................................................................................77
Analog Output Channel Gains...................................................................................79
Analog Output Buffers...............................................................................................80
Analog Output Data Coding ......................................................................................81
Analog Output Messages...........................................................................................83
Digital Input Subsystem...........................................................................................................84
Digital Input Modes...................................................................................................84
Digital Input Operations............................................................................................84
Digital Input Pacing, Triggering and Gating Options................................................84
Digital Input Timing Events ......................................................................................85
Digital Input Start Events...........................................................................................87
Digital Input Stop Events...........................................................................................87
Digital Input Channels...............................................................................................88
Digital Input Buffers..................................................................................................90
Digital Input Messages..............................................................................................91
Digital Output Subsystem ........................................................................................................93
Digital Output Modes................................................................................................93
Digital Output Operations..........................................................................................93
Digital Output Pacing, Triggering and Gating Options..............................................93
Digital Output Timing Events....................................................................................94
Digital Output Start Events........................................................................................97
Digital Output Stop Events........................................................................................97
Digital Output Channels............................................................................................. 97
Digital Output Buffers.............................................................................................100
Digital Output Messages..........................................................................................101
Counter/Timer Subsystem......................................................................................................102
Uninstalling DriverLINX 105
How do I uninstall DriverLINX? ...........................................................................................105
Troubleshooting 107
Solving Problems...................................................................................................................107
Solving Problems Installing Drivers........................................................................107
Solving Problems Configuring the Drivers..............................................................107
Solving Problems Loading Drivers..........................................................................108
Generating a DriverLINX Configuration Report ................................................................... 111
What is in the Report? .............................................................................................111
How do I Generate the Report?...............................................................................111
Glossary of Terms 112
4 • Contents Keithley DAS-1800 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 DAS-1800 Series 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 INABILIT Y 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 • Preface Keithley DAS-1800 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 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
•
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-1800 Series boards 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-1800 Series
Shows how to configure the DAS-1800 Series using the Configure DriverLINX
Device dialog box.
Using the DAS-1800 Series with DriverLINX
Keithley DAS-1800 Series Preface • 7
Shows how to set up DriverLINX with the Edit Service Request dialog box to use
DAS-1800 Series hardware features.
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-1800 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 DAS-1800 Series Preface • 9
Configuring the DAS-1800 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 DAS-1800 Series boards.
Installing and configuring DriverLINX for a Keithley DAS-1800 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 11 for configuration options specific to a
Keithley DAS-1800 Series model.
3. Install your DAS-1800 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.
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-1800 Series board in your
computer.
The installation program automatically starts the DriverLINX Configuration Panel.
To start it now, use the shortcut on the Windows Start Menu.
Keithley DAS-1800 Series Configuring the DAS-1800 Series • 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-1800 Series model. The following
sections describe your choices in configuring DriverLINX to work with your board.
12 • Configuring the DAS-1800 Series Keithley DAS-1800 Series
Device Subsystem Page
Use the Device subsystem page to tell DriverLINX the model name, address and,
optionally, the expansion accessories connected to your DAS-1800 Series board.
Vendor
The Vendor property displays “Keithley MetraByte” It is a read-only property.
Device
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:
DAS-1801ST
DAS-1802ST
DAS-1802HR
DAS-1801HC
DAS-1802HC
DAS-1801AO
DAS-1802AO
DAS-1801ST-DA
DAS-1802ST-DA
DAS-1802HR-DA
Keithley DAS-1800 Series Configuring the DAS-1800 Series • 13
Windows 95/98
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 0x300 hexadecimal or 768 decimal.
The DAS-1800 has a 6-bit DIP switch 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 four zeros to the right of the bits represented by the
switches.
For example, the following DIP switch shows the setting for 11 0000 0000
(0x300 hexadecimal or 768 decimal).
st
to the 6th digits. The 7th to the 10th digits of the
Windows NT
Windows 95/98
Enter your board’s base I/O address. Note: you need a block of sixteen free
addresses. AO models use an additional block of ten addresses starting at
base + 0x400.
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 17.
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 DAS-1800 Series because it does not support automatic
calibration.
14 • Configuring the DAS-1800 Series Keithley DAS-1800 Series
Special…
The Special… button displays the following dialog box of DAS-1800 Series-specific
configuration options:
Common-mode reference
The DAS-1800 has two grounding options for single-ended analog inputs. They
determine the ground reference for the ADC input amplifier.
•
LL GND — references the analog ground connection.
•
U_CM MD — re ferences the user-c ommon mode ground connection.
Use the U_CM MD setting to eliminate ground loops. See your DAS-1800 User’s
Guide for more details.
Number of EXP-1800s
You can expand the number of single-ended analog input channels connected to your
DAS-1800 board by using one to sixteen EXP-1800 expansion boards. Each EXP1800 is 1-to-16 multiplexer that replaces one onboard channel with sixteen expansion
channels. Configure your DriverLINX Logical Device to use the additional channels
by entering the number of EXP-1800s here. See “Analog Input Expansion Channels”
on page 58 for details on accessing multiplexer channels.
Simultaneous sample and hold configuration
You can provide for simultaneous analog input sampling using external Simultaneous
Sample and Hold (SSH-8) units. A DAS-1800HC model can have up to eight SSH-8
units. Other models can have up to two SSH-8 units. In the Configure DAS-1800
Options dialog box, enter the number of SSH-8s connected.
Keithley DAS-1800 Series Configuring the DAS-1800 Series • 15
For each SSH-8 unit, select its number in the SSH # list box and enter the following
configuration parameters:
•
Base channel — Each SSH-8 replaces 8 DAS-1800 channels
determined by which accessory and SSH-8 connectors you use and the
offset jumper settings on the SSH-8. You can connect two SSH-8 units
to one accessory connector by daisy chaining them together using the
connectors inside the units. See the SSH-8 User’s Guide for details.
Select the base channel corresponding to the connectors you are using
for this SSH-8 unit:
Accessory Base Channel
Connector Directly
connected
SSH-8
STA-1800U
J3 0 0
STA-1800HC
J1 0 24
J2 8 32
J3 16 40
J4 24 48
Daisy-chain
connected
SSH-8
•
Channel offset — click on an SSH-8 channel in the list and then select
the channel offset that corresponds to the position of the Output
Channel Jumper on the SSH-8. The list displays the number of the
DAS-1800 channel that the SSH-8 channel replaces.
Usually, you would configure all channels on a directly connected SSH8 to the lower offset channels (0-7) and all channels on a daisy-chain
connected SSH-8 to the higher offset channels (8-15).
•
Channel gain — click on an SSH-8 channel in the list and then select its
SSH-8 external amplifier gain. SSH-8FG models have a fixed gain of
0.5. SSH-8SG models have switches to set the gain of each channel.
For information on programming a task for simultaneous sampling, see “Rate
Generator: Internal Clocki ng” on page 41 o r “Rate Generator: External Clocking” on
page 43.
Disable AO recycle mode
For the DAS-1800AO hardware, DriverLINX can automatically promote AO tasks
meeting certain criteria to run from the DAC FIFO buffer in recycle mode. If the
Disable AO recycle mode box is checked, DriverLINX will not use recycle mode. If
the box is not checked, DriverLINX will use recycle mode for applicable tasks.
In recycle mode, DriverLINX automatically promotes AO tasks meeting the
following criteria as specified in the Service Request to run from the DAC FIFO
buffer in re -cycle mode:
16 • Configuring the DAS-1800 Series Keithley DAS-1800 Series
Service Request Property Value
Request mode Interrupt
Stop event type Command
Buffer notify flag False
Buffer samples × Number of buffers
The advantages of using the DAC FIFO buffer for free-run, re-cycle mode analog
output are:
•
The DAS-1800AO’s digital trigger operates in retrigger mode, enabling
you to synchronize analog output with a recurring external signal.
•
Traffic on the memory bus is significantly reduced at high output rates.
•
The system response latency will be noticeably shortened.
•
The analog output timing will be immune to traffic on the memory and
I/O buses.
The disadvantages are:
•
You can’t change the analog output values while the analog output task
is running.
•
There is a delay while DriverLINX loads the FIFO.
< 2048
•
Buffer-filled notification messages cannot be posted, as the hardware
does not permit detection of end-of-buffer conditions.
•
The STATUS operation cannot provide the “number of buffers
processed” report.
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
next to , if necessary to expand the
next to it.)
.
Keithley DAS-1800 Series Configuring the DAS-1800 Series • 17
5. Click the Properties button.
6. On the board’s property page, click the Resources tab.
7. To change the number and type of resources, select a different Basic
Configuration und er Setting based on.
8. To change a resource 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 your hardware manual.
11. Restart Windows to load the Logical Device for your board using the
new settings.
18 • Configuring the DAS-1800 Series Keithley DAS-1800 Series
Analog Input Subsystem Page
Use the Analog Input subsystem page to choose between single-ended or differential
analog input connections and to set or view your board’s interrupt request level.
Channels
On the DAS-1800HC, Analog Input channel configuration is software programmable
for 64 single-ended or 32 differential analog inputs. On all other DAS-1800 boards,
Analog Input channel configuration is software programmable for 16 single-ended or
8 differential analog inputs.
Windows NT
Windows 95/98
When configuring the Analog Input Subsystem, you choose a default configuration
for all channels. Applications can use the default configuration or specify the
connection type for each channel it uses. This scheme supports applications that use
KPCI-1800-specific features as well as those that use only generic features. For
programming information, see “Analog Input Channels” on page 53.
Range
The analog input ranges for the DAS-1800 Series are fully software programmable.
DriverLINX grays out this property in the configuration dialog.
Interrupt
Configure the board with an interrupt for full support of the board’s capabilities.
For Windows NT, select a free interrupt request level to support interrupt or DMA
mode transfers. Valid IRQ settings are: 3, 5, 7, 10, 11, 15 and None.
Under Windows 95/98, Add New Hard ware automatically selects an appropriate
interrupt. To change the sett ing, see “Using the Wind ows 95/98 Device Manager” on
page 17.
DMA
Configure the board with a DMA channel for full support of the board’s capabilities.
For Windows NT, select a free DMA channel to support DMA mode transfers. Valid
DMA settings are: 5, 6, 7 and None.
Keithley DAS-1800 Series Configuring the DAS-1800 Series • 19
Under Windows 95/98, Add New Hard ware automatically selects an appropriate
DMA channel. To change the setting, se e “Using the Windows 95/98 Device
Manager” on page 17.
Analog Output Subsystem Page
Note: The Configure DriverLINX Device dialog shows the Analog Output
Subsystem Page only for applicable models.
Use the Analog Output subsystem page to set or view the subsystem’s DMA channel
and initial output voltages.
Windows NT
Channels
Lists the analog output channels on the board and selects a channel for the Volts and
Initialize properties.
Range
The analog output ranges for the DAS-1800 Series are fully software programmable.
DriverLINX grays out this property in the configuration dialog.
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
The DAS-1800 Series uses the same interrupt for analog output as for analog input.
Go to the Analog Input subsystem page to view or set it.
DMA
DMA applies only to the DAS-1801AO and DAS-1802AO models. Configure the
board with a DMA channel for full support of the board’s capabilities.
For Windows NT, select a free DMA channel to support DMA mode transfers. Valid
DMA settings are: 5, 6, 7 and None.
20 • Configuring the DAS-1800 Series Keithley DAS-1800 Series
Windows 95/98
Under Windows 95/98, Add New Hard ware automatically selects an appropriate
DMA channel. To change the setting, se e “Using the Windows 95/98 Device
Manager” on page 17.
Initialize
Checking the Initialize check box instructs DriverLINX to use the Volts property to
initialize the selected analog output channel.
Keithley DAS-1800 Series Configuring the DAS-1800 Series • 21
For the DAS-1800 Series,
there are no configurable
options on the Digital Input
subsystem page.
Digital Input Subsystem Page
Channels
The Channels prop erty allows you to select a Logical Channel for configuration or
viewing the channel’s range. The DAS-1800 Series digital channels have fixed
configurations.
DriverLINX defines the following Logical Channels for the DAS-1800 Series digital
inputs:
Logical
Channel
0 Standard Digital Input DI 0 … DI 3
1 External Clock XPCLK
2 External Trigge r TGIN
DriverLINX Function DAS-1800 Series
External Connector
Range
The Range property specifies the supported digital input range for the selected
Logical Channel. This is a read-only property.
Interrupt
The DAS-1800 Series does not use interrupts for the digital input subsystem.
DriverLINX disables this property and displays it as blank.
DMA
The DAS-1800 Series does not use system DMA channels. DriverLINX disables this
property and displays it as blank.
22 • Configuring the DAS-1800 Series Keithley DAS-1800 Series
Configuration Setup
The Configuration Setup property specifies the hardware configuration of the digital
I/O ports. The DAS-1800 Series has a fixed digital I/O configuration. Therefore,
DriverLINX disables this field.
Initialize
Checking the Initialize check box instructs DriverLINX to use the Configuration
Setup property to configure the digital I/O ports. The DAS-1800 Series has a fixed
digital I/O configuration. Therefore, DriverLINX disables this field.
Keithley DAS-1800 Series Configuring the DAS-1800 Series • 23
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 . DriverLINX defines the follo wing Logical Channels for
the DAS-1800 Series digital outputs:
Logical Channel DriverLINX
Function
0 (HC models) Standard Digital Output DO 0 … DO 7
0 (except HC models) Standard Digital Output DO 0 … DO 3
1 (except HC models) Standard Digital Output MUX4 … MUX7, GEXT
The Analog Input subsystem uses the MUX outputs to control an EXP-1800
expansion accessory. If you are not using an EXP-1800, you can use the MUX
outputs as anot her Digital Output channel. However, you can change its value onl y
while the Analog Input subsystem is inactive.
DAS-1800 Series
External Connector
Range
The Range property specifies the supported digital output range for the selected
Logical Channel. This is a read-only property.
Interrupt
The DAS-1800 Series does not use interrupts for the digital output subsystem.
DriverLINX disables this property and displays it as blank.
DMA
The DAS-1800 Series does not use system DMA channels for Digital Output.
DriverLINX disables this property and displays it as blank.
24 • Configuring the DAS-1800 Series Keithley DAS-1800 Series
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.
By default, DriverLINX uses the hardware-defined initialization values if the
Initialize check box is not checked. For the DAS-1800 Series, the default digital
output value is zero.
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.
Keithley DAS-1800 Series Configuring the DAS-1800 Series • 25
For the DAS-1800 Series,
there are no configurable
options on the Counter/Timer
subsystem page.
Counter/Timer Subsystem Page
Resolution
The Resolution property specifies the clock frequency of the master oscillator. All
models have a 5.0 MHz clock source for pacing analog input. AO models also use
the 5.0 MHz clock source for pacing analog output.
Interrupt
The DAS-1800 Series does not support interrupts from counter/timers. DriverLINX
disables this property and displays it as blank.
26 • Configuring the DAS-1800 Series Keithley DAS-1800 Series
Using the DAS-1800 Series with DriverLINX
Introduction
See the Analog I /O
Programming Guide for an
overview of DriverLINX
programming.
This chapter shows you how to set up and use DAS-1800 Series hardware features
with DriverLINX.
The descriptions here use the Edit Service Request dialog for language and API
independence. For the corr ect syntax with the language you’re using, p lease see the
DriverLINX Technical Reference Manuals. For DriverLINX examples in your
programming language, p lease see the sourc e code examples in the subdirectories of
your DriverLINX installation directory or on the original distribution media.
DriverLINX Hardware Model for DAS-1800 Series
DriverLINX provides a portable, hardware-independent API for data-acquisition
boards while still allowing applications to access unique or proprietary hardware
features of specific products. To achieve this goal, DriverLINX maps a hardwareindependent, or abstract, data-acquisition model onto DAS-1800 Series hardware
capabilities.
The following sections describe how DriverLINX implements DAS-1800 Series
hardware features as Subsystems, Modes, Operations, Events, Logical Channels,
Buffers, and Messages.
DriverLINX Subsystems
The DAS-1800 Series supports the following DriverLINX subsystems:
1. Device—refers to a DAS-1800 board as a whole.
2. Analog Input—refers to the analog input channels, clocks, and control
signals.
3. Analog Output—refers to the analog output channels, clocks, and
control signals. DA, HC and AO models only.
Keithley DAS-1800 Series Using the DAS-1800 Series with DriverLINX • 27
4. Digital Input—refers to the digital input port as well as 1-bit digital
input (TTL) control signals, such as TGIN.
5. Digital Output—refers to the digital output port and control signals.
6. Counter/Timer—refers to the input/output subsystem-specific internal
clock channels for pacing analog input/output.
DriverLINX Modes
Applications use modes in Service Requests to advise DriverLINX on their preferred
hardware data transfer technique. The DriverLINX modes fall into two general
classes:
•
Foreground or synchronous modes. The calling application doesn’t
regain control until DriverLINX completes the Service Request.
DriverLINX supports this mode for simple, single value I/O operations
or software housekeeping functions that DriverLINX can complete
without a significant delay.
•
Background or asynchronous modes. The calling application regains
control as soon as DriverLINX initiates the task. The calling application
must synchronize with the data-acquisition task using status polling or
DriverLINX’s messages (preferred). DriverLINX supports this mode
for buffered data transfers or for commands that require a significant
time to complete.
DriverLINX supports four modes with the DAS-1800 Series for its commands
(Service Requests).
•
Polled Mode—T his is a foreground or synchronous operation.
DriverLINX supports this mode for simple, single-value I/O operations
that the data-acquisition board can complete without significant delay.
•
Interrupt Mode—Thi s is a background or asynchronous operation.
DriverLINX transfers data between the computer’s memory and the
data-acquisition board using hardware interrupts and programmed I/O
transfers.
•
DMA Mode—This is a background or asynchronous operation.
DriverLINX programs the data-acquisition board to transfer data
between the computer’s memory and the board.
•
Other Mode—This is a foreground or synchronous opera tion.
DriverLINX supports this mode for initialization, configuration,
calibration, data conversion, and timebase operations.
28 • Using the DAS-1800 Series with DriverLINX Keithley DAS-1800 Series
The following table summarizes the data acquisition modes that DriverLINX
supports for each subsystem with the Keithley DAS-1800 Series.
Subsystem Polled Interrupt DMA Other
Analog Input
Analog Ou tput
(DA and HC
models)
Analog Ou tput
(AO models)
Digital Input
Digital Output
Counter/Timer
Device
√√√√
√√ √
√√√√
√√ √
√√ √
√
√
DAS-1800 Series Supported DriverLINX Modes.
Keithley DAS-1800 Series Using the DAS-1800 Series with DriverLINX • 29
DriverLINX Operations and Events
Applications construct DriverLINX data-acquisition tasks by combining a small
number of DriverLINX operations and events in many possible ways. The following
table summarizes the operations and events that DriverLINX supports for the
Keithley DAS-1800 Series. Later sections for each DriverLINX subsystem will
describe the operations and events in more detail.
Note: In addition to the operations shown in the table below, all subsystems allow
the MESSAGE operation in any Mode.
30 • Using the DAS-1800 Series with DriverLINX Keithley DAS-1800 Series