Full-service, independent repair center -~ ARTISAN® with experienced engineers and technicians on staff. TECHNOLOGY GROUP ~I We buy your excess, underutilized, and idle equipment along with credit for buybacks and trade-ins. Custom engineering Your definitive source so your equipment works exactly as you specify. for quality pre-owned • Critical and expedited services • Leasing / Rentals/ Demos equipment. • In stock/ Ready-to-ship • !TAR-certified secure asset solutions Expert team I Trust guarantee I 100% satisfaction Artisan Technology Group (217) 352-9330 | [email protected] | artisantg.com All trademarks, brand names, and brands appearing herein are the property o f their respective owners. Find the DynamicSignals / GaGe Compuscope 220 at our website: Click HERE CompuScope Drivers for the CompuScope 6012 CompuScope 1012 CompuScope 250 CompuScope 225 CompuScope 220 CompuScope LITE DOS Driver and Windows DLL Documentation for Borland C 3.1 + Microsoft C 5.1 + Watcom C 9.0 + Turbo Pascal for Windows 1.0 + Visual Basic 1.0 + Quick Basic 4.5 Protected Mode Pascal 7.0 LabWindows / CVI Copyright (C) 1994 by Gage Applied Sciences Inc. Phone (514) 337-6893 Fax (514) 337-8411 BBS (514) 337-4317 Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com © Copyright Gage Applied Sciences Inc. 1994 5465 Vanden Abeele, Montreal, Quebec, Canada H4S 1S1 Tel: 1-800-567-GAGE or (514) 337-6893. Fax: (514) 337-8411. BBS: (514) 337-4317 GAGESCOPE, COMPUSCOPE, COMPUSCOPE LITE, COMPUSCOPE 220, COMPUSCOPE 250, COMPUSCOPE 1012, COMPUSCOPE 6012 AND MULTI-CARD are registered trademarks of Gage Applied Sciences Inc. MS-DOS, Microsoft Windows, Quick Basic, Visual Basic and Visual C++ are trademarks of Microsoft Incorporated. Borland C++, Borland Pascal and Turbo Pascal for Windows are trademarks of Borland International. IBM, IBM PC, IBM PC/XT, IBM PC AT and PC-DOS are trademarks of International Business Machines Corporation. LabWindows and LabWindows / CVI are trademarks of National Instruments Corporation. Watcom C/C++ is a trademark of Watcom International Corporation. Changes are periodically made to the information herein; these changes will be incorporated into new editions of the publication. Gage Applied Sciences may make improvements and/or changes in the products described in this publication at any time. You can address your comments or queries to: Product Manager - CompuScope Gage Applied Sciences Inc., 5465 Vanden Abeele Montreal, Quebec Canada H4S 1S1 Tel: (514) 337-6893 Fax: (514) 337-8411 BBS : (514) 337-4317 Copyright © 1994 Gage Applied Sciences Inc. All Rights Reserved, including those to reproduce this publication or parts thereof in any form without permission in writing from Gage Applied Sciences Inc. Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com CompuScope Driver Documentation Table of Contents. Preface. Page 1. How to use the CompuScope Drivers. Page 2. CompuScope C Drivers for DOS. Page 3. CompuScope Quick Basic Driver. Page 4. Name Changes. Page 4. Driver Definitions and the Driver Library File. Page 4. Quick Basic and the CompuScope Libraries. Page 6. Quick Basic and Command Line Compiling. Page 6. CompuScope Protected Mode Pascal Driver. Page 8. CompuScope DLL Basics: C. Page 9. CompuScope DLL Basics: Turbo Pascal for Windows. Page 11. CompuScope DLL Basics: Visual Basic. Page 12. CompuScope Driver: types, structures and definitions. Page 13. Memory Organization of the CompuScope. Page 21. Memory Architecture. Page 21. Memory: Programmer’s View. Page 24. Application Development. Page 27. A simple application using the CompuScope C drivers. Page 31. Global Routines: Group One. Page 36. gage_32k_to_buffer Page 37. gage_abort_capture Page 39. gage_busy Page 40. gage_calculate_addresses Page 41. gage_calculate_mr_addresses Page 43. gage_capture_mode Page 45. gage_detect_multiple_record Page 48. gage_driver_initialize Page 49. gage_driver_remove Page 52. gage_forced_trigger_capture Page 53. gage_get_boards_found Page 54. gage_get_config_filename Page 55. gage_get_current_drv_structure Page 56. gage_get_driver_info Page 57. gage_get_driver_info_structure Page 58. gage_get_error_code Page 60. gage_get_interpolate_trigger Page 62. gage_get_records Page 63. gage_get_trigger_view_offset Page 65. gage_initialize_start_capture Page 66. Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com gage_input_control Page 67. gage_make_error_code Page 69. gage_mem_read_chan_a Page 70. gage_mem_read_chan_b Page 71. gage_mem_read_dual Page 72. gage_mem_read_single Page 73. gage_multiple_record Page 74. gage_need_ram Page 76. gage_normalize_address Page 77. gage_read_config_file Page 78. gage_read_master_status Page 80. gage_reset_interpolate_trigger Page 81. gage_select_board Page 82. gage_select_current_board Page 83. gage_set_ext_clock_variables Page 84. gage_set_records Page 85. gage_set_trigger_view_offset Page 87. gage_software_clock Page 88. gage_software_trigger Page 89. gage_start_capture Page 90. gage_trigger_control Page 91. gage_trigger_view_transfer Page 93. gage_triggered Page 95. gage_update_driver_info Page 96. Global Routines: Group Two. Page 97. gage_abort Page 98. gage_fast_set_block_number Page 99. gage_get_data Page 100. gage_get_data_high Page 101. gage_get_data_low Page 102. gage_init_clock Page 103. gage_ram_full Page 104. gage_set_block_number Page 105. gage_trigger_address Page 107. gage_trigger_aux Page 108. Global Routines: Group Three. Dos Specific Routines. Page 109. gage_channel_enable Page 109. gage_set_coupling Page 110. gage_set_gain Page 111. gage_set_segment Page 112. gage_set_trigger_depth Page 113. gage_set_trigger_level Page 114. gage_set_trigger_slope Page 115. gage_set_trigger_source Page 116. Global Routines: Group four. Board Specific Routines. Page 117. CompuScope 1012 and 6012. Page 118. cs1012_enable_test_memory Page 118. cs1012_test_memory_chan Page 118. cs1012_offset_adjust Page 119. cs1012_trigger_control_2 Page 120. CompuScope 250. Page 122. cs250_enable_ets Page 122. Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com cs250_ets_average_capture Page 123. cs250_ets_average_capture_2 Page 125. cs250_ets_capture Page 127. cs250_ets_capture_2 Page 128. cs250_ets_detect Page 129. cs250_mem_read_ets_data Page 130. cs250_set_ets_delay Page 131. cs250_set_ets_rate Page 132. CompuScope 225. Page 133. CompuScope 220. Page 134. CompuScope LITE. Page 135. Sample Routines. Page 136. Variable Definitions for Examples: C. Page 137. Sample Routines: C. Page 139. Variable Definitions for Examples: Pascal. Page 149. Sample Routines: Pascal. Page 151. Variable Definitions for Examples: Basic. Page 160. Sample Routines: Basic. Page 162. Sample Programs. Page 171. Sample Programs for C. Page 172. GAGETSTx Page 172. GAGEA2Dx Page 173. Software Multiple Record Page 175. Sample Program for Protected Mode Pascal. Page 176. GAGETSTP Page 176. Sample Programs for Quick Basic. Page 178. SIMPLE.BAS Page 178. TEST.BAS Page 180. Sample Program for Windows: C. Page 182. Sample Program: Turbo Pascal for Windows. Page 186. Sample Program: Visual Basic. Page 190. Extra Support. Page 193. Interpolated Trigger Support Routines. Page 193. The DISKFILE.H GageScope signal file header definition. Page 194. Common Problems. Page 196. Appendix A: Recompiling the CompuScope Drivers. Page 199. Appendix B: Customizing the CompuScope Drivers. Page 201. Appendix C: Converting Borland C++ to Microsoft C. Page 203. Appendix D: Converting Borland C++ to Turbo C++. Page 204. Appendix E: CompuScope LabWindows / CVI Driver. Page 205. Preface. Page 205. Sample Programs. Page 206. GAGE_DRV Page 206. GAGE_MULT Page 207. Rebuilding the Driver. Page 209. Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com Appendix F: CS6012 / 1012 register functionality. Page 210. Appendix G: CS250 / 225 register functionality. Page 215. Appendix H: CS220 register functionality. Page 220. Appendix I: CSLITE register functionality. Page 224. Appendix J: Hardware / Software Data Translation. Page 228. Appendix K: GageScope binary file format (.SIG). Page 230. Reading GageScope signal files. Page 236. Appendix L: GageScope setup file format (.SET). Page 238. Appendix M: CompuScope Data Transfer Benchmarks. Page 245. Appendix N: Trigger View Transfer Benchmarks. Page 250. Appendix 0: Resolving Memory Conflicts. Page 265. Technical Support. Page 268. Version:2.85 Dated:November 28, 1994. Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com Preface This manual is designed to describe the routines included in the CompuScope 6012/1012/250/225/ 220/LITE Drivers for the Microsoft DOS or Microsoft Windows environment. It is assumed that the programmer is familiar with the concept of DLLs, Windows 3.x programming (for DLL development) and the programming language in use. No description is included for these topics. If the programmer is not comfortable with any one of these topics, it is strongly recommended that a relevant reference manual be referred to before starting. Throughout this manual, the term CompuScope drivers will be used to refer to both the DOS drivers and the Windows DLL. Any differences between the two drivers will be discussed in the relevant sections This manual describes the use of the driver routines for application program development. The routine descriptions,