cover.frm Black 1 DAS-800 Series Function Call Driver User’s Guide 1 titlepgfrm Black 1 DAS-800 Series Function Call Driver User’s Guide Revision A - December 1993 Part Number: 66770 noticep.frm Black 1 +b The information contained in this manual is believed to be accurate and reliable. However. the manufacturer assumes no responsibility for its use; nor for any infringements or patents or other rights of third parties that may result from its use. No license is granted by implication or otherwise under any patent rights of the manufacturer. THE MANUFACTURER 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 THAT IS SUITED FOR USE IN LIFE SUPPORT OR CRITICAL APPLICATIONS. All brand and product names are trademarks or registered trademarks of their respective companies. 0 Copyright Keithley Instruments, Inc., 1993. All rights reserved. Reproduction or adaptation of any part of this documentation beyond that permitted by Section I I7 of the 1976 United States Copyright Act without permission of the Copyright owner is unlawful. 800fcd.toc Black iii Table of Contents Preface 1 Getting Started Installing the Software.. 1-2 Installing the DAS-800 Series Standard Software Package 1-2 Installing the ASO- Software Package 1-3 DOS Installation.. 1-3 Windows Installation 1-4 Setting Up the Boards . l-5 Getting Help.. l-6 2 Avallable Operations Analog Input Operations .......................... ,.,2-l Operation Modes. ............................. 2-2 Memory Allocation and Management ............. .2-3 Input Range Qpe ............................. 2-5 Gains ....................................... 2-5 Channels .................................... .2-6 Single Channel, ............................ .,.2-x Multiple Channels Using a Group of Consecutive Channels ................................ .2-9 Multiple Channels Using a Channel-Gain List .... .2-9 Conversion Clocks ............................ .2-13 Buffering Mode. .............................. .2-16 Triggers ..................................... .2-16 Analog Triggers ............................ .2-17 Digital Triggers ............................ .2-20 Hardware Gates. .............................. .2-22 Digital I/O Operations ............................ ,2-24 Counternimer I/O Operations. ..................... System Operations. .............................. : : 2-262-27 Initializing the Driver. ......................... .2-28 Initializing a Board ............................ .2-29 Retrieving the Revision Level. ................... : : 2-30 Handling Errors. .............................. 8OOfcd.toc Black iv 3 Programming with the Function Call Driver How the Driver Works ................................ ,3-l Programming Overview ............................... .3-5 Preliminary Tasks. ................................... .3-6 Operation-Specific Programming Tasks ,3-6 Analog Input Operations. .3-6 Single Mode, .................................. .3-7 Synchronous Mode ............................. .3-7 Interrupt Mode. ................................ .3-9 Digital I/O Operations............................. .3-12 Language-Specific Programming Information ............ (3-12 Microsoft C/C++. ................................ .3-13 Borland C/C++ .................................. .3-14 Microsoft QuickC for Windows ..................... .3-I5 Microsoft Visual C++ ............................. .3-16 Borland Turbo Pascal ............................. .3-16 Borland Turbo Pascal for Windows .................. .3-17 Specifying the Buffer Address (Pascal) ............... .3-1X Specifying the Channel-Gain List Starting Address (Pascal). ............................... .3-19 Microsoft QuickBASIC (Version 4.0) ................ .3-20 Microsoft QuickBasic (Version 4.5). ................. .3-21 Microsoft Professional Basic (Version 7.0) ............ .3-22 Microsoft Visual Basic for DOS ...................... 3-23 Microsoft Visual Basic for Windows .................. 3-24 Specifying the Buffer Address (All BASIC Languages) .. .3-25 4 Function Reference DASXOO-DevOpen ........ ........ .4-6 DAS800-GetADGainMode. ........ .4-9 DAS800-GetDevHandle . ... ........ .4-II DAS800-Get8254 : ........ ........ .4-13 DAS800&SetADGainMode . ........ .4-15 DAS800-Set8254 ......... ........ .4-17 K-ADRead. .............. ........ .4-19 K-BufListAdd ............ ........ .4-22 K-BufListReset ........... ........ .4-24 K-ClearFrame ............ ........ ,4-26 K-CloseDriver ............ ........ ,4-28 K-ClrConiRun ............ ........ .4-30 K-DASDevInit ........... ........ 4-32 K-DIRead ............... ........ .4-33 iv 800fcd.toc Black v K-DOWrite .............. .4-35 K-FormatChanGAry .4-37 K-FreeDevHandle ......... .4-3x K-FreeFrame ............. .4-39 K-GetADFrame. .......... .4-40 KGetADTrig ............ .4-42 K-GetBuf. ............... .4-44 K-GetChn ............... ,446 K-GetChnGAry . ..4-48 K-GetClk ................ .4-50 K-GetClkRate ............ .4-52 K-GetContRun ........... .4-54 K-GetDevHandIe. ......... .4-56 K-GetDITrig ............. ..4-58 K-GetErrMsg. ............ .4-60 K-GetG ................. .4-61 K-GetGate ............... .4-63 K-GetStartStopChn ........ .4-65 KGetStartStopG .......... ,4-67 K-GetTrig ............... .4-70 K-GetTrigHyst. ........... .4-72 K-GetVer ................ ,4-14 K-InitFrame. ............. .4-76 K-IntAlloc ............... .4-7x K-IntFree ................ ,4-80 K-IntStart. ............... .4-81 K-IntStatus .............. .4-x3 KJntStop. ............... .4-X6 K-MoveBuffoArray ....... 4-88 K-OpenDriver ............ .4-x9 K-RestoreChanGAry ....... .4-92 K-SetADTrig. ............ .4-93 K_SetBuf ................ .4-95 K-SetBufI ............... .4-97 K-SetChn. ............... .4-99 K-SetChnGAry ........... ,4-101 K-SetClk ................ .4-103 K-SetClkRate ............ .4-I05 K-SetContRun. ........... .4-107 K-SetDITrig. ............. .4-109 K-SetG. ................. ..4-111 K-SetGate ............... .4-113 SOOfcd.toc Black vi K-SetStartStopChn ............................ .4-115 K-SetStartStopG .............................. .4-l I7 K-SetTrig .................................... .4-120 K-SetTrigHyst ................................ 4-122 K-SyncStart .................................. 4-124 A Error/Status Codes B Data Formats Converting Raw Counts to Voltage B-2 Converting Voltage to Raw Counts .B-3 Specifying an Analog Trigger Level. .B-3 Specifying a Hysteresis Value. .B-5 Index List of Figures Figure 2-l. Analog Input Channels .2-x Figure 2-2. Channel-Gain List (C or Pascal) .2-IO Figure 2-3. Sample Channel-Gain List (C or Pascal). .2-I1 Figure 2-4. Channel-Gain List (BASIC) .2-I2 Figure 2-5. Sample Channel-Gain List (BASIC). .2-12 Figure 2-6. Initiating Conversions .2-I5 Figure 2-7. Analog Trigger Conditions .2-I7 Figure 2-8. Using a Hysteresis Value. 2-19 Figure 2-Y. Initiating Conversions with an External Analog Trigger .2-20 Figure 2-10. Initiating Conversions with an External Digital Trigger. 2-21 Figure 2-l I. Hardware Gate. : : 2-23 Figure 2-12. Digital Input Bits. .2-24 Figure 2-13. Digital Output Bits. .2-25 vi SOOfcd.toc Black vii List of Tables Table 2-l. Supported Operations .2-l Table 2-2. Analog Input Ranges., .2-6 Table 2-3. Channels in Maximum Configuration. .2-7 Table 3-l. A/D Frame Elements. .3-3 Table 3-2. Setup Functions for Synchronous-Mode Operations.. .3-7 Table 3-3. Setup Functions for Interrupt-Mode Operations .3-IO Table 4-1. FCD Functions. .4-2 Table 4-2. Default Configuration .4-7 Table A- I. Error/Status Codes. A-l vii 800fcd.toc Black viii preface.frm Black ix +b Preface The DAS-BOO Series Function Call Driver User’s Guide describes how to write application programs for DAS-800 Series boards using the DA.%800 Series Function Call Driver. The DAS-X00 Series Function Call Driver supports the following DOS-based languages: . Microsoft@ QuickBASIC (Version 4.0) l Microsoft QuickBasicm (Version 4.5 and higher) . Microsoft Professional Basic (Version 7.0 and higher) . Microsoft Visual BasicTMfor DOS (Version 1.0) . Microsoft C/C++ (Version 4.0 and higher) . Borland@ C/C++ (Version I.0 and higher) l Borland Turbo Pascal@for DOS (Version 6.0 and higher) The DAS-800 Series Function Call Driver also supports the following WindowsTM-basedlanguages: l Microsoft Visual Basic for Windows (Version 2.0 and higher) . Microsoft QuickC@ for Windows (Version 1.0) l Microsoft Visual C++TM(Version I .O) . Borland Turbo Pascal for Windows (Version 1.0 and higher) preface.frm Black x f@ The manual is intended for application programmers using a DAS-800, DAS-801, or DAS-802 board in an IBM’ PC/XY, ATa or compatible computer, It is assumedthat users have read the DAS-800 Series User’s Guide to familiarize themselveswith the boards’ functions, and that they have completed the appropriate hardware installation and configuration. It is also assumedthat users are experienced in programming in their selected language and that they are familiar with data acquisition principles. The DAS-800 Series Function Call Driver User’s Guide is organized as follows: Chapter I contains the information needed to install the DAS-800 Series Function Call Driver and to set up DAS-800 Series boards. Chapter 2 contains the background information needed to use the functions included in the DAS-800 Series Function Call Driver. Chapter 3 contains programming guidelines and language-specific information related to using the DA.5800 Series Function Call Driver. Chapter 4 contains