REV. A
Information furnished by Analog Devices is believed to be accurate and
reliable. However, no responsibility is assumed by Analog Devices for its
use, nor for any infringements of patents or other rights of third parties
which may result from its use. No license is granted by implication or
otherwise under any patent or patent rights of Analog Devices.
a
SW-800 Series
One Technology Way, P.O. Box 9106, Norwood, MA 02062-9106, U.S.A.
Tel: 781/329-4700
World Wide Web Site: http://www.analog.com
Fax: 781/326-8703
Analog Devices, Inc., 1998
Software Drivers--
Windows
and DOS
INTERFACING AN APPLICATION PROGRAM
USER APPLICATION PROGRAM
(WRITTEN IN VISUAL BASIC FOR WINDOWS)
WINDOWS DLL INTERFACE
(LLWIN.DLL)
BOARD LIBRARIES
(WIN800.DLL)
RTI-800 BOARD
RTI-817 BOARD
PROCESS
FEATURES
Supports Popular Languages
Windows 3.1
Microsoft
Visual BASIC for Windows
Microsoft Visual C
++
for Windows
Borland Turbo C
++
for Windows
Borland Turbo Pascal for Windows
MS-DOS
Microsoft Interpreted GWBASIC
IBM Interpreted BASIC
Microsoft QuickBASIC
Microsoft C/C
++
Borland Turbo C
++
Borland C
++
Borland Turbo Pascal
Callable Subroutine Libraries
Analog and Digital l/O
Frequency and Event Counting
Pulse Output
Interrupt Servicing
GENERAL DESCRIPTION
The SW-800 Series of Windows and DOS Drivers are software
packages that provide subroutine calls to access the I/O func-
tions of the RTI-800 Series Analog and Digital boards. There
are four hardware-specific packages. Each package includes
support for high level languages in both Windows 3.X and
DOS. (See list of supported languages in the features chart.)
The driver software packages provide a high level interface to
the RTI-800 Series Analog and Digital boards. Complex analog,
digital, and counter/timer I/O operations are simplified with key-
words such as SCAN, AOT, FINSTART. In order to use the
driver software, experience with a programming language such
as BASIC or VISUAL BASIC for Windows and familiarity with
the application is required.
Each SW-800 Series driver software package consists of all
language libraries and a board library for the specific hardware
supported. The language libraries include a language binding
that handles the different parameter passing conventions used
by the languages, as well as calls to the hardware libraries.
Board libraries contain the low level subroutines that perform
the I/O routines. Common language-specific packages within
the SW-800 Series can be merged to run in one system. For
example, if a user wants to operate an RTI-815 and RTI-827
board in the same system and wants to develop an application
in Microsoft C
++
, the SW-800 and SW-827 packages can be
combined using the LINK facility.
All trademarks are the property of their respective holders.
An error-processing system checks for argument errors in
every setup and I/O subroutine. Attempts to operate in
illegal modes are trapped, and error codes are reported.
Run-time errors such as "Overrun error detected" are also
reported.
Table I lists the I/O routines in the SW-800 Series of
MS-DOS and Windows Driver Software packages. The
target system for the SW-800 Series of Driver Software is
an IBM PC/AT or 100% compatible system with PC-DOS,
MS-DOS (Version 3.3 or higher), or Windows 3.1, and one
floppy disk drive and one hard disk drive.
Table II lists application software packages, available from
third party vendors, which require little or no programming
on the part of the user prior to configuring and running an
application. Applications range from simple data collection
and analysis to real-time control and high speed streaming
of data to disk.
SW-800 Series
2
REV. A
UTILITIES DISK
A 3.5" utilities disk (SW-UTIL-D3) is shipped with each RTI-
800 Series board. This disk contains the programs listed below.
EXER--Self-documenting, menu-driven program that allows
access to all the RTI-800 Series board's functionality through
software. EXER can be used as a diagnostic tool or as a means
of becoming familiar with the capabilities of the board prior to
developing an application program.
DMACONF, MLTDLOAD--Used to configure and allocate
DMA buffers. If RTI-800 Series boards have unique DMA
channels, then multiple boards can perform DMA-based opera-
tions at the same time.
CONF--Creates a table containing RTI-800 Series hardware
configuration information that is used by the SW-800 Series
Driver Software and some application-specific software
packages.
CAL800, CAL835, CAL860--Calibrates the analog I/O cir-
cuitry of RTI-800 Series boards.
The following sample is a fragment of a Microsoft C program using
the SW-860 Driver package that simultaneously samples two channel
groups on the RTI-860 board and stores the data in on-board memory.
Channel Group 3 is read first (Group 3 consists of Channels 12, 13,
14 and 15); Channel Group 0 (consisting of Channels 0, 1, 2 and 3)
is read next. This sequence repeats until the sample count is satisfied.
CHECK verifies that the operation is complete. When the data is
required. RBUF transfers it from on-board memory to the user-
defined array in system memory.
{
INITIALIZE (&erstat);
if (erstat) printf ("\n\tINITIALIZE error: %2d\n'',erstat);
else
{
lchan=5;
board=7;
chanarr[0]=2: /*two groups in channel sequence*/
chanarr[1]=3; /*group 3 is first group in sequence*/
chanarr[2]=0: /*group 0 is second group in sequence*/
range=1000;
mult =10; /*pacing interval = range times mult microseconds*/
count=400;
simul=1; /*enables simultaneous sampling*/
brdbuf=1000; /*starting location in on-board memory*/
BSCAN860 (lchan,board,chanarr,range,mult,count,simul,&erstat);
if (erstat) printf ("\n\tBSCAN setup error: %2d\n",erstat);
else
{
BSCAN(lchan,brdbuf,&erstat);
CHECK(lchan,&erstat);
while (!erstat) CHECK (lchan,&erstat};
if (erstat!=117) printf ("mn\tRBUF error: %2d\n",erstat);
else
{
RBUF (lchan,dest,&erstat);
if (erstat) printf ("\n\tRBUF error: %2d\n",erstat);
else
{
printf ("\n\n\tBSCAN values: \n\n");
for (lp=0; lp<< count; lp++) printf ("%8d",dest[lp]);
}
}
}
}
}
Sample Program Using SW-860
SW-800 Series
3
REV. A
Table I. RTI Series Driver Software Routines
Operation/
Routine
800 802 815 817 820 827 834 835 850 860 Description
ANALOG INPUT
(X)AIN
Acquires data from a single analog input channel.
(X)AING
Acquires data (polled) from a group of analog input channels.
(X)COLLECT
Use DMA (paced) to acquire data from a single input channel.
(X)CCOL
Collects data (paced) from a single analog channel and continuously
transfers the data to system memory.
BCOL
Acquires data (paced) from an input and stores it in on-board memory.
(X)SCAN
Uses DMA to acquire data from a group of inputs (paced).
(X)CSCAN
A
cquires data (paced) from a user-specified sequence of channels and
and continuously transfers the data to system memory using interrupts.
BSCAN
Acquires data (paced) from a user-specified sequence of channels
into on-board memory.
(X)AVG
Uses DMA to acquire data from an analog input channel and averages
the data.
(X)CAVG
Acquires data from an analog input channel, continuously transferring
the data to system memory (paced) and returns the average value.
RBUF
Transfers data from on-board memory into system memory.
ANALOG OUTPUT
(X)AOT
Writes a value to a single analog output channel.
(X)AOTG
Writes multiple values to a single analog output channel or a group of
analog output channels.
DIGITAL INPUT
DINB
Reads one bit from a digital I/O port.
DIN
Reads eight bits from a digital I/O port.
DIGITAL OUTPUT
DOTB
Writes one bit from a digital I/O port.
DOT
Writes eight bits from a digital I/O port.
DOTR
Reads back last value written to output port.
FREQUENCY INPUT
FINSTART
Starts a frequency input operation.
(X)FINREAD
Returns the frequency measured.
FINSTOP
Stops a frequency input operation.
EVENT COUNTING
EVINIT
Initializes counter/timer for event counting.
EVSTART
Starts the event counting operation.
EVSTOP
Stops the event counting operation.
EVREAD
Reads the number of events counted.
PULSE OUTPUT
PULSE
Outputs a pulse.
PULSTART
Starts a pulse train with a user-specified period and duty cycle.
PULSTOP
Stops the pulse output train operation.
CONVERSION AND LINEARIZATION
CONV
Converts counts to engineering units or engineering units to counts.
SETSCALE
Defines linear relationships used for scaling analog inputs.
MISCELLANEOUS
DEB
Sets debounce time.
TRIG
Defines triggering parameters.
GATE
Defines gate parameters.
ACTIO
Activates a specified function upon receipt of an interrupt.
CLRIO
Disables an interrupt enabled by ACTIO.
SETOUT
Defines a user-specified value that is written to a counter/timer, digital
or analog output channel upon program termination.
CLCHAN
Clears the specified logical channel.
DELAY*
Postpones execution of the code for up to one hour.
INITIALIZE
System routine that resets all RTI-800 series boards in system.
An (X) indicates that the value can be expressed as an integer (raw counts from A/D or D/A) or as a real number in engineering units, i.e., volts, amps, psi, Hz.
*Not available in windows.
SW-800 Series
4
REV. A
C1834a04/98
PRINTED IN U.S.A.
Table II. Guide to Third Party Software
Analog Devices Hardware
Operating
6B
Vendor
Package
Environment
Series
800
802
815
817
820
827
834
835
850
860
DSP Development Corp.
DADiSP
Windows & DOS
One Kendall Square
Cambridge, MA 02139
617-577-1133
HEM Data Corporation
Snap-Master
Windows
17336 12 Mile Road
Snap-Series
DOS
Southfield, MI 48076
248-559-5607
Iconics Inc.
Genesis
DOS
100 Foxborough Blvd.
Foxborough, MA 02035
508-543-8600
Intellution
The Fix
DOS
One Edgewater Drive
Norwood, MA 02062
617-769-8878
LABTECH
Notebook
Windows & DOS
400 Research Drive
Notebookpro
Windows & DOS
Wilmington, MA 01887
Control
Windows & DOS
978-657-5400
Controlpro
Windows & DOS
NemaSoft Inc.
Paragon 500/550 DOS
55 West Street
Walpole, MA 02081
508-668-7741
TA Engineering Co., Inc.
AIMAX
Windows
1150 Moraga Way
for Windows
Moraga, CA 94556
510-376-8500
ORDERING INFORMATION
Each SW-800 Series driver software package is shipped with all
language libraries (Windows and MS-DOS) on 3.5", 720K
double sided, double density diskettes; a software manual; and
Analog Devices End-User Software License. OEM and redistri-
bution licenses are available; please consult factory.
SW-800
Supports the RTI-800/RTI-802/RTI-815/RTl-817/RTI-820
SW-827
Supports the RTI-827
SW-835
Supports the RTI-834/RTI-835
SW-860
Supports the RTI-850/RTI-860
MANUALS
A software manual is supplied with each Driver Software pack-
age. Additional Manuals are available.
AC1938
RTI-827 Software Manual
AC1940
RTI-834, RTI-835 Software Manual
AC1941
RTI-800, RTI-802, RTI-815, RTI-817, RTI-820 Software
Manual
AC1942
RTI-850, RTI-860 Software Manual
PDF 
ZIP