DAPIO32 Reference Manual DAPIO32 function and structure reference Version 5.00 Microstar Laboratories, Inc. This manual contains proprietary information, which is protected by copyright. All rights are reserved. No part of this manual may be photocopied, reproduced, or translated to another language without prior written consent of Microstar Laboratories, Inc. Copyright © 1996-2011 Microstar Laboratories, Inc. 2265 116th Avenue N.E. Bellevue, WA 98004 Tel: (425) 453-2345 Fax: (425) 453-3199 http: // www.mstarlabs.com Microstar Laboratories, DAPIO, DAPIO32, DAPcell, Accel32, Data Acquisition Processor, DAP, DAP 5200a, iDSC, iDSC 1816, DAPL, DAPL 2000, DAPL 3000, DAPstudio, DAPtools, and DAPview are trademarks of Microstar Laboratories, Inc. Microstar Laboratories requires express written approval from its President if any Microstar Laboratories products are to be used in or with systems, devices, or applications in which failure can be expected to endanger human life. Microsoft, MS, and MS-DOS are registered trademarks of Microsoft Corporation. Windows is a trademark of Microsoft Corporation. IBM is a registered trademark of International Business Machines Corporation. Intel is a registered trademark of Intel Corporation. Novell and NetWare are registered trademarks of Novell, Inc. Other brand and product names are trademarks or registered trademarks of their respective holders. Part Number MSDAPIO32M500 Contents 1. Introduction .....................................................................................................................7 About this Document ....................................................................................................8 2. DAPIO32 Overview..........................................................................................................9 Communication Pipes ...................................................................................................9 Buffered Data Transfers..............................................................................................10 UNC (Universal Naming Convention) Pipe Names ......................................................11 Basic Communication.................................................................................................12 Advanced Data I/O .....................................................................................................14 Linux Support.............................................................................................................15 Functions Supported .............................................................................................15 Functions Not Supported.......................................................................................15 Functions Modified...............................................................................................15 Unix style Accel32 device names ..........................................................................16 3. C++ Application Programming......................................................................................17 Software Components.................................................................................................17 Installation..................................................................................................................18 Install your Microsoft compiler software..........................................................18 Install your DAPtools Development software...................................................18 Configure your compiler environment ...................................................................19 Determine your onboard processing configuration..................................................19 Configure for your application build......................................................................19 The DAP Connection Life Cycle .................................................................................19 Initialization ...................................................................................................20 Clearing prior operations.................................................................................21 Downloading a DAP configuration..................................................................21 Efficient Run-Time Processing....................................................................................23 One Value At A Time .....................................................................................23 One Block At A Time .....................................................................................24 Take Everything Available – the TDapBufferGetEx structure...........................24 Don’t Wait, Take What You Need...................................................................26 Take Block If Available ..................................................................................27 Take All Blocks Available ..............................................................................28 Take Most Recent Block .................................................................................28 Data Access Considerations ........................................................................................29 Application Termination and Cleanup..........................................................................31 Summary of Basic DAPIO Functions...........................................................................32 4. DAPIO32 Interface Reference .......................................................................................33 DAPIO32 Structure Reference.....................................................................................34 Structure Reference...............................................................................................34 Structure Usage ....................................................................................................34 Structure Initialization...........................................................................................34 Binary Compatibility.............................................................................................34 Alphabetical Structure Reference...........................................................................35 TDapBufferGetEx...........................................................................................36 TDapBufferPeek.............................................................................................37 TDapBufferPutEx...........................................................................................40 TDapCommandDownload...............................................................................41 TDapHandleQuery..........................................................................................43 TDapIoInt64...................................................................................................46 TDapPipeDiskFeed.........................................................................................47 Contents iii TDapPipeDiskLog ..........................................................................................50 DAPIO32 Function Reference.....................................................................................53 Function Reference...............................................................................................53 Function Overview ...............................................................................................53 Data I/O Time-out.................................................................................................54 Alphabetical Function Reference...........................................................................54 DapBufferGet .................................................................................................55 DapBufferGetEx.............................................................................................56 DapBufferPeek ...............................................................................................58 DapBufferPut..................................................................................................60 DapBufferPutEx .............................................................................................61 DapCharGet....................................................................................................62 DapCharPut....................................................................................................63 DapCommandDownload.................................................................................64 DapComPipeCreate.........................................................................................65 DapComPipeDelete.........................................................................................68 DapConfig......................................................................................................69 DapConfigParamsClear...................................................................................71 DapConfigParamSet........................................................................................72 DapConfigRedirect .........................................................................................73 DapHandleClose.............................................................................................74 DapHandleOpen .............................................................................................75 DapHandleQuery............................................................................................77