ME-94, ME-95, ME E

Transcription

1 Meilhaus Electronic Manual ME-94, ME-95, ME E ISA-, PCI- and CompactPCI versions Opto-isolated Digital I/O-Boards

2 Imprint Manual ME-94, ME-95, ME-96 Revision 4.7E Revised: 23. April 2002 Meilhaus Electronic GmbH Fischerstraße 2 D Puchheim/Munich Germany Copyright 2002 Meilhaus Electronic GmbH All rights reserved. No part of this publication may be reproduced or distributed in any form whether photocopied, printed, put on microfilm or be stored in any electronic media without the expressed written consent of Meilhaus Electronic GmbH. Important note: The information contained in this manual has been reviewed with great care and is believed to be complete and accurate. Meilhaus Electronic assumes no responsibility for its use, any infringements of patents or other rights of third parties which may result from use of this manual or the product. Meilhaus Electronic assumes no responsibility for any problems or damage which may result from errors or omissions. Specifications and instructions are subject to change without notice. IBM and IBM PC AT/XT are trademarks of the International Business Machines (IBM) Corporation Borland Delphi is a trademark of Borland International Inc. Turbo/Borland C is a trademark of Borland International Inc. Visual C++ and Visual Basic are trademarks of the Microsoft Corporation. VEE Pro and VEE OneLab are trademarks of Agilent Technologies. ME-VEC is a trademark of Meilhaus Electronic GmbH Other company names and product names found in the text of this manual are also trademarks of the companies involved.

3 Manual ME-94, ME-95, ME-96 Rev. 4.7E Table of Contents 1 Introduction Package Contents Features System Requirements Important note for ISA Models Installation Hardware Installation ISA-Models Positions of the Jumpers Settings of the Jumpers Base Address Interrupts (ME-94, ME-96 ISA) Polarity of Output Lines (ME-95 ISA) Default Settings Hardware Block Diagram General Notes Modes of Operation ME ME ME Switching Optocouplers External Switching Registers of the ISA Models Test Program Programming High Level Language Programming Example Programs Agilent VEE Programming User Objects Example Programs The "ME Board" Menu LabVIEW Programming Virtual Instruments Example Programs Register programming (ISA models) Meilhaus Electronic Page 3 Table of Contents

4 Rev. 4.7E Manual ME-94, ME-95, ME-96 5 Function Reference General Naming Conventions Description of the API Functions General Functions Digital Input Digital Output Interrupt Handling Error Handling Appendix A Specifications B Pinout B1 ME B2 ME B3 ME B4 External Power Connector C Accessories D Technical Questions D1 Hotline D2 Service address D3 Driver Update E Index Table of Contents Page 4 Meilhaus Electronic

5 Manual ME-94, ME-95, ME-96 Rev. 4.7E 1 Introduction Valued customer, Thank you for purchasing a Meilhaus data acquisition board. You have chosen an innovative high technology board that left our premises in a fully functional and new condition. Take the time to carefully examine the contents of the package for any loss or damage that may have occurred during shipping. If there are any items missing or if an item is damaged, contact Meilhaus Electronic immediately. Before you install the board in your computer, read this manual carefully, especially the chapter describing board installation. On the ISA bus versions of the boards pay careful attention to the sections describing how to set the jumpers. This will save having to open the computer case again. 1.1 Package Contents We take great care to make sure that the package is complete in every way when it is shipped. We do ask, that you take the time to examine the contents of the box. The package will contain the following items: Electrically isolated digital I/O board (depending on the package an ISA, PCI or cpci board of ME-94, ME-95 or ME-96) Manual in PDF format on CD-ROM (optional as printed version) Driver software on CD-ROM For the ISA and PCI versions only: one DIN connector for supplying the optocoupler power. For ME-94 and ME-95: one DB25 female connector For ME-96: two DB15 female connectors Meilhaus Electronic Page 5 Introduction

6 Rev. 4.7E Manual ME-94, ME-95, ME Features Model Overview Model Bus Opto isolated inputs and outputs ME-94 ISA ME-94 PCI ME-94 cpci ME-95 ISA ME-95 PCI ME-95 cpci ME-96 ISA ME-96 PCI ME-96 cpci ISA-8 bit Standard-PCI Compact-PCI ISA-8 bit Standard-PCI Compact-PCI ISA-8 bit Standard-PCI Compact-PCI 18 input channels (24 V). Two of the inputs can be used as interrupt channels 16 output channels, (24 V). Defined levels (tristate) at power-up 10 input channels, (24 V). 1 input can be used as interrupt channel 8 output channels (24 V). Defined levels (tristate) at powerup Table 1: Models overview ME-9x family The ME-9x board family includes electrically isolated digital I/O boards for the ISA, PCI, and cpci system buses. The same boards on different buses are functionally equivalent, pin compatible, and software compatible (Not valid for register programming). The electrical isolation on the boards prevents interference and high voltages (e. g. voltage peaks on the ground lines) from reaching the PC electronics. The inputs have been designed for the usual voltage of typical 24 V. On the ME-94 and ME-95 there are 2 modes of operation: with or without interrupt control. The desired interrupt channel can be selected by jumpers on the ISA models. The PCI and cpci models interrupt channel is configured by the operating system. The software supplied with the board allows quick and easy installation of the board for a wide range of control and data acquisition applications under Windows. Drivers are available for Introduction Page 6 Meilhaus Electronic

7 Manual ME-94, ME-95, ME-96 Rev. 4.7E Agilent VEE (formerly HP VEE) and LabVIEW (National Instruments) on request. For the ISA versions, drivers are available for DOS and Windows 3.1 upon request. 1.3 System Requirements The boards can be installed into IBM PC/XT/AT/Pentium and compatible computers with a free expansion slot for 8 bit ISA or PCI resp. CompactPCI (depending on the version). 1.4 Important note for ISA Models For computers with a PCI bus and a BIOS which supports Plug&Play make sure to reserve the interrupt lines for the ISA bus in the BIOS for any boards requiring the interrupt functions. The BIOS menu will vary depending on the manufacturer (consult the motherboard documentation on how to do this). If the interrupt lines are not reserved in the BIOS, the interrupt function will not be guaranteed!! Also note that on some newer computers the frequency on the ISA bus will be more than the specified 8 MHz. Proper functioning of the boards is not guaranteed if this is the case. Check the BIOS setup of your computer to make sure. Available Software For the newest versions and latest software releases, please consult the README files. System Drivers ME-Software-Developer-Kit (ME-SDK): For all common operating systems (see README files) Support for all common programming languages, demos, tools und test programs Meilhaus Electronic Page 7 Introduction

8 Rev. 4.7E Manual ME-94, ME-95, ME-96 Graphical programming tools Meilhaus VEE Driver System for HP VEE V 4.0 or higher, HP VEE Lab, Agilent VEE Pro and Agilent VEE OneLab Driver System for LabVIEW 4.0 or higher Introduction Page 8 Meilhaus Electronic

9 Manual ME-94, ME-95, ME-96 Rev. 4.7E 2 Installation Important Note: First read your computer manual instructions on how to install new hardware components. An installation guide how to install the driver software can be found on CD-ROM. Basically use the following procedure for installing the board: If you have got the driver software as an archive file please unpack the software before installing the board. Choose an directory on your computer (e. g. C:\temp). Now insert the board into your computer and then install the driver software. This order of operation is important to guarantee the Plug&Play operation under Windows 95*/98/Me/2000/XP. Windows 95 and NT 4.0 need an analogous order of operation however the installation procedure differs slightly. *If the Windows version is supported by the appropriate board type (see readme files). Note: If you want to run the PCI/cPCI versions with application software already written take care of the notes in the proper README file included with the driver software. If you are using an ISA board please do the jumper settings on the board first (see the following chapters). 2.1 Hardware Installation ISA-Models Make sure that the computer is turned off. Caution: some of the more sensitive components can be damaged by static electricity! That s why: Make sure to ground yourself by touching an exposed metal part of the PC case before handling the board. Unplug the power cable from your computer. Open the computer case. Meilhaus Electronic Page 9 Installation

10 Rev. 4.7E Manual ME-94, ME-95, ME Positions of the Jumpers The ISA versions of the ME-9x family require that jumpers be checked/set before the board is installed into the computer. It must also be determined if the settings match the available resources in the computer before installation. Make sure the computer is turned off before installing the board. On the ME-94 ISA, ME-95 ISA, and ME-96 ISA the address is set by a 4 position jumper. On the ME-94 ISA and ME-96 ISA there is additionally a 7 position jumper to set the interrupt channel (IRQ2 7). The locations of the jumpers are shown in the diagrams below. Descriptions of the jumper settings are described in the next chapters. Base address S1 S2 S3 S4 Interrupt IRQ Diagram 1: Picture of ME-94 ISA Installation Page 10 Meilhaus Electronic

11 Manual ME-94, ME-95, ME-96 Rev. 4.7E Base address S1 S2 S3 S4 F1 S5 Diagram 2: Picture of ME-95 ISA Base address S1 S2 S3 S4 Interrupt OUT IRQ IN Diagram 3: Picture of ME-96 ISA Meilhaus Electronic Page 11 Installation

12 Rev. 4.7E Manual ME-94, ME-95, ME Settings of the Jumpers Base Address The base address (BA) of the board is set by the jumpers S1 S4 in 10 byte increments. Starting with the base address, the ME-95 ISA requires 2 bytes while the ME-94 ISA and ME-96 ISA require 4 bytes of I/O address space. The address is set by inserting or removing jumpers. Make sure that there are no address conflicts with other boards in the system before installing the board in the computer! The following assignment is valid: S1 S2 S3 S4 Base Address (Hex) A B C D E F0 Table 2: Setting of base address (Default: 300Hex) ( corresponds to Jumper set ) Installation Page 12 Meilhaus Electronic

13 Manual ME-94, ME-95, ME-96 Rev. 4.7E S1 S2 Diagram 4: Jumper for base address (Default: 300Hex) Note that for the ISA models, like most ISA boards, only the lower 10 address bits are decoded. This means that the addresses will be mirrored at BA+400Hex, BA+800Hex, BA+C00Hex, BA+1000Hex etc Interrupts (ME-94, ME-96 ISA) S3 S4 For boards with interrupt control (ME-94/96 ISA), an interrupt request channel between IRQ2...7 must be chosen and set with the jumpers on the board. Make sure there are no resource conflicts with other interrupt sources in your system. The following diagram shows how to set the jumper to select IRQ 5 for example: Jumper IRQ Diagram 5: Jumper setting for IRQ Polarity of Output Lines (ME-95 ISA) The ME-95 ISA gives you the possibility to invert the polarity of the output lines by the jumper S5. By default the setting is not inverting (i.e. no jumper set). Meilhaus Electronic Page 13 Installation

14 Rev. 4.7E Manual ME-94, ME-95, ME Default Settings Model Function Jumper Setting ME-94 ISA Base address S Hex (all jumpers set) IRQ channel IRQ2 7 IRQ 5 ME-95 ISA Base address S Hex (all jumpers set) Polarity of output lines S5 not inverting ME-96 ISA Base address S Hex (all jumpers set) IRQ channel IRQ2 7 IRQ 5 Table 3: Default settings of the ISA models by factory Installation Page 14 Meilhaus Electronic

15 Manual ME-94, ME-95, ME-96 Rev. 4.7E 3 Hardware 3.1 Block Diagram 25pin sub D male V+, V- 8 V+, V- 8 V+, V- 2 ISAinterface Optocouplers Optocouplers Optocouplers PA PB PC PIO 8255A Businterfacelogic ME-94 Diagram 6: Block diagram of ME-94 PCI-, cpcior 25pin sub D male V+, V- 8 V+, V- 8 Optocouplers ISAinterface Optocouplers 8 8 PA PB Businterfacelogic Databuffer and latch PCI-, cpcior ME-95 Diagram 7: Block diagram of ME-95 15pin sub D male 15pin sub D male V+, V- 8 V- 8 2 Businterfacelogic Optocoupler Optocoupler Optocoupler PA PB PC PIO 8255A PCI-, cpcior ISAinterface ME-96 Diagram 8: Block diagram of ME-96 Meilhaus Electronic Page 15 Hardware

16 Rev. 4.7E Manual ME-94, ME-95, ME General Notes Important Note: The external connections to the board should only be made in a powered down state. The pin configuration of the external connectors is the same for the ISA, PCI, and cpci versions for boards of the same type (see chapter "B Pinout" on page 51). 3.3 Modes of Operation ME-94 The ME-94 and ME-96 use an 8255 compatible PIO device. The two boards use 2 operational modes of the device which will be described in the following chapters. For further information on the 8255 device consult the manufacturers data sheet. The digital I/O ports on the ME-95 are using a data buffer (latch). This board does not support interrupt operation. The ME-94 uses 2 operational modes of the 8255 device which are configured by software (see chapter "3.5 Registers of the ISA Models" on page 20): Operation without interrupt : 18 digital inputs In this operation mode data input can be done. The data is read in from the chosen port and no handshaking is required. By configuring the 8255 PIO device for mode 0 operation, 2 input ports 8 bits wide (port A and B) and 1 port 2 bits wide (PC2 and PC4) are available for data input Operation with interrupt : 16 digital inputs and 2 interrupt channels In this operation mode the 8255 is configured in mode 1. There are 2 groups (group A and group B) each containing an 8 bit data port and a 4 bit control/data port. The 8 bit ports are used for data input. The ME-94 uses only the PC4 (interrupt input for port A) and PC2 (interrupt input for port B) control port lines. All input ports are latched. Hardware Page 16 Meilhaus Electronic

17 Manual ME-94, ME-95, ME-96 Rev. 4.7E ME ME-96 Ports A and B of the ME-95 are using a data buffer (latch) for simple data output (16 outputs). There is no interrupt control available on the ME-95 board. The ME-96 operation is configured by software. There are 2 operational modes of the 8255 device which are used by the ME-96 (see chapter "3.5 Registers of the ISA Models" on page 20): Operation without interrupt : 8 outputs and 10 inputs In this operation mode port A is used for data output and ports B and C are used for data input. Data is written to or read from the chosen port and no handshaking is required. By configuring the 8255 in mode 0 there is 1 output port (port A: 8 bit wide) and 2 input ports (port B: 8 bit wide, port C: 2 bit wide) available. Operation with interrupt : 8 outputs, 8 inputs and 1 interrupt channel In this operation mode port A of the 8255 is configured in mode 0 and port B is configured in mode 1. Port A (8 bit output) and port B (8 bit input) are used as data ports. The PC2 line of port C is used as interrupt control line for port B. The PC4 input is not used. 3.4 Switching The inputs and outputs of the various boards are electrically isolated by optocouplers. There is no electrical connection between the hardware connected to the board and the PC. For pin out diagrams, see chapter "B Pinout" on page 51. Meilhaus Electronic Page 17 Hardware

18 Rev. 4.7E Manual ME-94, ME-95, ME Optocouplers Output wiring ME-95, ME-96 optocoupler V+ line diode output line R L Input wiring ME-94, ME-96 optocoupler +5 V TTL R C AME (C and AME only for ISA models) input line line diode Diagram 9: Switching of the input and output optocouplers External Switching In order to run the ME-9x boards properly, an external power supply is required for the optocouplers. The power supply must be connected to the D-sub connector of the boards (pins ext. GND resp. ext. Input-GND and ext.v+, see chapter "B Pinout" on page 51 ff). Alternativly, for the ISA and standard PCI versions, the external power can be supplied via a low voltage connector (DIN 45323) available on the mounting bracket. The power supply is connected to the D-sub connector(s) on the board (Attention: no common GND between input and output port of the ME-96 ISA). The interrupt inputs of the ME-94 and ME-96 triggers on a falling edge. The external supply voltage can be anywhere from 20V to 28V so small variations in the voltage will have no effect on the board. Hardware Page 18 Meilhaus Electronic

19 Manual ME-94, ME-95, ME-96 Rev. 4.7E Low level voltage jack for external power supply (only for ISA and standard PCI models) + 24 V IN Digital inputs PC2 + PC4 Without interrupt operation : With interrupt operation : digital inputs interrupt channels Diagram 10: Switching of the inputs of ME-94 low level voltage jack for external power supply (only for ISA- and standard PCI-models) + 24 V OUT Digital outputs Diagram 11: Switching of the outputs of ME-95 Meilhaus Electronic Page 19 Hardware

20 Rev. 4.7E Manual ME-94, ME-95, ME-96 Low level voltage jack for external power supply (only for ISA and standard PCI models) + 24 V OUT Digital outputs IN only PCI version Digital inputs PC2 Without interrupt operation : With interrupt operation : digital input interrupt channel Diagram 12: Switching of the inputs and outputs of ME Registers of the ISA Models The ISA models of the ME-9x family can be programmed at the register level (e. g. in DOS). The registers are briefly described in this section. We recommend use of the driver software for Windows 95/98 and Windows NT shipped with the board; if not the software compatibility is not given!. On the ME-94 and ME-96 four registers of the PIO device are user accessible. The mode of operation is set by an 8 bit control register. Data is exchanged by 3 ports each 8 bits wide (for ports A, B, and C). The boards occupy consecutive memory locations in the I/O address space starting at the base address (BA) set by the jumpers on the board. (W= write, R= read) Hardware Page 20 Meilhaus Electronic

21 Manual ME-94, ME-95, ME-96 Rev. 4.7E Offset 8 bit registers of the ME-94 BA+00H R Input port A b7..b0 PA7..0: Input register (Port A) BA+01H R Input port B b7..b0 PB7..0: Input register (Port B) BA+02H R Input port C (only PC2 and PC4 used) b7..b5: reserved b4 PC4: Operation without interrupt : Input register bit PC4 of port C Operation with interrupt : Interrupt input of port A b3 reserved b2 PC2: Operation without interrupt : Input register bit PC2 of port C Operation with interrupt : Interrupt input of port B b1, b0 reserved BA+03H W Control register of PIO Operation without interrupt : Write 9BHex to this register Operation with interrupt : Write B7Hex to this register Table 4: Address space of the ME-94 Meilhaus Electronic Page 21 Hardware

22 Rev. 4.7E Manual ME-94, ME-95, ME-96 Offset BA+00H BA+01H 8 bit registers of the ME-95 W Output port A b7 b0 PA7..0: Output register (Port A) W Output port B b7..b0 PB7..0: Output register (Port B) Table 5: Address space of the ME-95 Offset BA+00H 8 bit registers of the ME-96 W Output port A b7 b0 PA7..0: Output register (Port A) BA+01H R Input port B b7..b0 PB7..0: Input register (Port B) BA+02H R Input port C (only PC2 and PC4 used) b7..b5 reserved b4 PC4 Operation without interrupt : Input register bit PC4 of port C Operation with interrupt : not in use b3 reserved b2 PC2 Operation without interrupt : Input register bit PC2 of port C Operation with interrupt : Interrupt input of port B b1, b0 reserved BA+03H W Control register of PIO Operation without interrupt : Write 8BHex to this register Operation with interrupt : Write 87Hex to this register Table 6: Address space of the ME-96 Hardware Page 22 Meilhaus Electronic

23 Manual ME-94, ME-95, ME-96 Rev. 4.7E 3.6 Test Program For test issues a test program is provided. The appropriate test program can be found in a corresponding subdirectory of C:\MEILHAUS\ (Default) and can be run by double clicking on the file. (Condition: system driver correctly installed). Meilhaus Electronic Page 23 Hardware

24 Rev. 4.7E Manual ME-94, ME-95, ME-96 Hardware Page 24 Meilhaus Electronic

25 Manual ME-94, ME-95, ME-96 Rev. 4.7E 4 Programming Without changing your software the ME-9x Driver System offers you the possibility to use an equivalent PCI board instead of an old ISA board of the ME-9x family. This may be possible without recompilation because the functionallity and syntax are identical. (Assumption: your old ISA board and the new PCI board are using the same value in parameter <iboardnumber>). See the appropriate README-file of the ME-9x driver for proper order of operation. It only works, if you used the function library of the ME-9x Driver System for the old ISA board! 4.1 High Level Language Programming The following high level languages are supported by standard: Visual C++ (version 4.0 or higher). Delphi (version 2.0 or higher). Visual Basic (version 4.0 or later).. For further infos see the appropriate README files on the ME-Power-CD. Note: The compilers and linkers require the correct paths to be set to the corresponding files in the high level languages. By linking the high level language specific definition files into your project you can pass many macros and parameters in the form of predefined constants. As an alternative, you can pass the matching Hex value at any time Example Programs We have provided simple demo programs and small projects with source code to help understanding of the functions and how to include them into your project. These demo programs can be found within the ME Software Developer Kit (ME-SDK), which is installed to directory C:Meilhaus\me-sdk by default. Please read the notes in the appropriate README files. Meilhaus Electronic Page 25 Programming

26 Rev. 4.7E Manual ME-94, ME-95, ME Agilent VEE Programming The Agilent VEE components for your board are included with the ME-Power-CD or for download under The Meilhaus VEE Driver System supports the HP VEE full versions 4.x and 5.x, HP VEE Lab, Agilent VEE Pro and Agilent VEE OneLab. For installation of VEE components and for further informations please note the documentation included with the VEE driver system. For basics of VEE programming please use your VEE documentation and the VEE online help index User Objects For convenient use of the driver, predefined User Objects have been developed which internally call API functions. They can be called by the additional menu item ME Board and be included in the VEE development environment. They can be placed and wired in your application the same as standard VEE objects. The User Objects are self descriptive and based on the API functions documented in the chapter Function Reference. Additionally there are some Expanded User Objects for making programming as easy as possible for you. A short description of every UO is also available under the item Description, if you move the cursor over the UO and push the right mouse button. The UOs can be changed any time for user requirements and can be saved as a user specific object Example Programs For demonstration purposes and for easier understanding, demo programs using the important UOs have been written. They can be called by the menu item ME Board Demos. The VEE demo programs contain partial additions to the normal UOs and for differentiation from the normal UOs the prefix "x " in their file name is used. Programming Page 26 Meilhaus Electronic

27 Manual ME-94, ME-95, ME-96 Rev. 4.7E The "ME Board" Menu The installation program automatically expands the VEE menu by the ME Board entry. It enables a convenient use of all driver functions available in VEE. From the ME Board menu you can call the driver and demo User Objects sorted by board families. Note: The UOs installed, depend on the selected board family at the beginning of your VEE driver installation. If you call UOs under the ME Board menu which are not installed, an error message occures: File filename was not found. Error number: 700 If necessary, you can install the additional VEE components any time (see ME-Power-CD ). 4.3 LabVIEW Programming The LabVIEW components for your board are included with the ME-Power-CD or for download under The Meilhaus LabVIEW drivers support the LabVIEW full versions 4.x or higher. For installation of LabVIEW driver components please see the documentation deliverd with the appropriate Lab- VIEW driver. For basics of LabVIEW programming please use your LabVIEW documentation and the LabVIEW online help Virtual Instruments For convenient use of the driver, predefined Virtual Instruments have been developed. They can be called by the additional menu item File - Open and be included in the LabVIEW development environment. They can be placed and wired in your appli-cation the same as standard LabVIEW objects. The source VIs are self descriptive and based on the API functions documented in the chapter Function Reference. Additionally there are some Expanded Virtual Instruments for making programming as easy as possible for you. Meilhaus Electronic Page 27 Programming

28 Rev. 4.7E Manual ME-94, ME-95, ME-96 A short description of every VI is also available in the VI Function Tree. This VI is only for documentation purposes and can be opened by the menu File - Open. Under Description you find a short description of every Virtual Instrument. The VIs can be changed any time for user requirements and can be saved as a user specific VI Example Programs For demonstration purposes and for easier understanding, demo programs using the important virtual instruments (VIs) have been written. They can be called by the menu item File - Open Register programming (ISA models) Note: The ISA models can be programmed with high level language port input and output commands directly (in case of software already exists). Consult the manuals for the high level language of your choice for the proper commands and syntax. We recommend use of the drivers for Windows, supplied with the board, else the software compatibility is not given! Use the following order of operation: Simple I/O Operation without interrupt : ME-94: Write control word 9BHex into the control register (BA+03Hex) Read in port A (BA+00Hex), port B (BA+01Hex) or port C (BA+02Hex) ME-95: Write data word to port A (BA+00Hex) or port B (BA+01Hex ME-96: Write control word 8BHex into the control register (BA+03Hex) Write data word to port A (BA+00Hex) or read in port B (BA+01Hex) or port C (BA+02Hex) After reading in the values from port C (ME-94 or ME-96) the unused bits from port C must be masked out by the user so that only the bits PC2 and PC4 remain. Programming Page 28 Meilhaus Electronic

29 Manual ME-94, ME-95, ME-96 Rev. 4.7E Input Operation with interrupt and simple output: In order to use the interrupt capability of the ME-94 or ME-96, the interrupt controller 8259 in the computer must be initialised. For detailed information over interrupt operation consult the documentation for the particular high level language being used or the 8259 interrupt controller data sheets. The board itself must also be initialised for interrupt operation. The 8255 device on the board must be configured (see chapter "3.5 Registers of the ISA Models" on page 20). Ports A and B remain as data ports while the lines PC2 and PC4 (ME-94) or PC2 (ME-96) serve as interrupt inputs. PC2 as interrupt input Eingang for port B (ME-94 and ME-96): Write control word (ME-94: B7Hex, ME-96: 87Hex) into the control register (BA+03Hex) Write control word 0FHex into the control register (BA+03Hex) Write control word 0DHex into the control register (BA+03Hex) Write control word 05Hex into the control register (BA+03Hex); PC2 is now enabled To disable interrupt operation (PC2), write control word 04Hex into the control register (BA+03Hex) PC4 as interrupt input for port A (ME-94): Write control word B7Hex into the control register (BA+03Hex) Write control word 0FHex into the control register (BA+03Hex) Write control word 0DHex into the control register (BA+03Hex) Write control word 09Hex into the control register (BA+03Hex); PC4 is enabled Meilhaus Electronic Page 29 Programming

30 Rev. 4.7E Manual ME-94, ME-95, ME-96 To disable interrupt operation (PC4), write control word 08Hex into the control register (BA+03Hex) PC2 and PC4 as interrupt input (ME-94): Write control word B7Hex into the control register (BA+03Hex) Write control word 0FHex into the control register (BA+03Hex) Write control word 0DHex into the control register (BA+03Hex) Write control word 05Hex into the control register (BA+03Hex); PC2 is enabled Write control word 09Hex into the control register (BA+03Hex); PC4 is enabled To disable interrupt operation (PC2 and PC4), write control word 04Hex and 08Hex into the control register (BA+03Hex) Programming Page 30 Meilhaus Electronic

31 Manual ME-94, ME-95, ME-96 Rev. 4.7E 5 Function Reference 5.1 General The driver concept for the ME-9x family includes common drivers for ISA- and PCI/cPCI boards. Exception: WDM drivers for PCI/cPCI boards under Windows 98/Me/2000. The funcitons of the API-DLL (ME9x_32.DLL) for the ME-9x are supported by the following 32 bit drivers: - VxD driver (ME9x_32.VXD) for Windows 95/98/Me. - Kernel driver (ME9x_32.SYS) for Windows 2000/NT4.0. further on required: dialogue DLL (MEDLG32.DLL). The funcitons of the API-DLL (ME1400.DLL) for the ME-1400 are supported by the following 32 bit drivers: - VxD driver (ME9x_32.VXD) for Windows Kernel driver (ME9x_32.SYS) for Windows NT WDM driver (ME9x.SYS) for Windows 98/Me/2000 After the driver is successfully loaded, the API functions allow convenient access to the hardware. Every function that accesses a ME-9x board requires an integer value for identification of the board. In the following description of the functions this parameter is referred to as <iboardnumber>. Specifing the proper board keep the following in mind: - Value range ISA versions: Value range PCI/cPCI versions: Value for the 1 st board: 0 - Value for the 2 nd board: 1 - Value for n th board : n-1 Meilhaus Electronic Page 31 Function Reference

32 Rev. 4.7E Manual ME-94, ME-95, ME Naming Conventions These functions were written specifically for the ME-9x board family. For Visual C and Delphi (Pascal) every API function starts with an underscore _ (not so in Borland C and BASIC). The function names were selected to be as descriptive as possible. Each function name consists of a board type specific prefix and several elements which stand for the corresponding sections (e. g. "DI" for "Digital In"). _me94 Function valid for board ME-94 _me95 Function valid for board ME-95 _me96 Function valid for board ME-96 _me9x Function valid for the boards ME-94, ME-95, ME-96 For the description of the functions, the following standards will be used: function name will be italic in body text e. g. _me9xgetboardversion <parameters> will be in brackets as shown and in font Courier <variables> will indicate a predefined constant and will be written in italic text and in brackets as shown [square brackets] will indicate optional variables FILE NAMES or PATHS will be capitalized in font Courier me9x () parts of programs will be in Courier type To identify data types, the following letters will be used: i or dw 32 bit integer value s or w 16 bit short value c or b 8 bit character value p pointer of data type (i, s, l or c) Function Reference Page 32 Meilhaus Electronic

33 Manual ME-94, ME-95, ME-96 Rev. 4.7E 5.3 Description of the API Functions The functions will be described by functional group as listed below. Within each functional group, the individual functions will be described in alphabetical order: General Functions on page Digital Input on page Digital Output on page Interrupt Handling on page Error Handling on page 46 Function Short description Page General Functions _me9xgetboardversion Determine board version 34 _me9xgetdllversion Determine DLL version number 35 Digital Input _me94digetbit _me96digetbit _me94digetbyte _me96digetbyte Digital Output _me95dosetbit _me96dosetbit _me95dosetbyte _me96dosetbyte Interrupt Handling _me94disableint _me96disableint _me94enableint _me96enableint Read bit Read byte (8 bits) Write bit Write byte (8 bit) Disable interrupt control Enable interrupt control _me9xgetirqcnt Determine number of interrupts 45 Error Handling _me9xgetdrverrmess Error string corresponding to error code 46 Table 7: Overview of library functions Meilhaus Electronic Page 33 Function Reference

34 Rev. 4.7E Manual ME-94, ME-95, ME General Functions _me9xgetboardversion Description Determines the board version number of an installed board of the board family ME-9x. Definitions C: int _me9xgetboardversion (int iboardnumber, int *pidevices;) Delphi: Function _me9xgetboardversion (iboardnumber: integer; Var idevices: integer): integer; Basic: Declare Function me9xgetboardversion Lib "me9x_32" Alias (ByVal iboardnumber As Long, idevices As Long) As Long Parameter <BoardNumber>Board number for 1., 2., 3. or 4. installed ME-94, ME-95 or ME-96; possible values: 0 3 <Version> Pointer to an integer value returning the board version. Possible values: 94Hex: for ME-94 ISA, PCI, cpci 95Hex: for ME-95 ISA, PCI, cpci 96Hex: for ME-96 ISA, PCI, cpci Return Value If the function is successfully executed, a '1' is returned. If an error occurs, a '0' is returned. The cause of the error can be determined with the function _me9xgetdrverrmess. Function Reference Page 34 Meilhaus Electronic

35 Manual ME-94, ME-95, ME-96 Rev. 4.7E _me9xgetdllversion Description Returns the version number of the board DLL for the board family ME-9x. Definitions C: int _me9xgetdllversion(); Delphi: Function _me9xgetdllversion: integer; Basic: Declare Function me9xgetdllversion Lib "me9x_32" Alias () As Long Parameters none Return Value Version number. This 32 bit value has the main version in the upper 16 bits and the sub version in the lower 16 bits. For example a return value: 0x for the version Digital Input _me94digetbit Description This function is only for the ME-94. This function determines the status of a single input line. Definitions C: int _me94digetbit (int iboardnumber, int ibitno, int *pibitvalue); Delphi: Function _me94digetbit (iboardnumber, ibitno: integer; Var ibitvalue: integer): integer; Basic: Declare Function me94digetbit Lib "me9x_32" Alias "_VBme94DIGetBit@12" (ByVal iboardnumber As Long, ByVal ibitno As Long, ByRef ibitvalue As Long) As Long Meilhaus Electronic Page 35 Function Reference

36 Rev. 4.7E Manual ME-94, ME-95, ME-96 Parameters <BoardNumber>Board number for 1., 2., 3. or 4. installed ME-94, ME-95 or ME-96; possible values: 0 3 <BitNo> Input line (number); possible values: 0 7: for port A : for port B 16, 17: for bits C2 and C4 of port C <BitValue> Pointer to an integer value which corresponds with the line status: Possible return values: 0: Line is set to '0' 1: Line is set to '1' Return Value If the function is successfully executed, a '1' is returned. If an error occurs, a '0' is returned. The cause of the error can be determined with the function _me9xgetdrverrmess. _me94digetbyte Description This function is only for the ME-94. This function reads a byte (8 bits) from a input port. Definitions C: int _me94digetbyte (int iboardnumber, int iportno, int *pivalue); Delphi: Function _me94digetbyte (iboardnumber, iportno: integer; Var ivalue: integer): integer; Basic: Declare Function me94digetbyte Lib "me9x_32" Alias "_VBme94DIGetByte@12" (ByVal iboardnumber As Long, ByVal iportno As Long, ByRef ivalue As Long) As Long Parameters <BoardNumber>Board number for 1., 2., 3. or 4. installed ME-94, ME-95 or ME-96; possible values: 0 3 Function Reference Page 36 Meilhaus Electronic

37 Manual ME-94, ME-95, ME-96 Rev. 4.7E <PortNo> <Value> Return Value Port name; possible values: <PortNo> Description PORTA (00hex) Input port A PORTB (01hex) Input port B PORTC (02hex) (only bits C2 and C4 significant; the other bits of port C are not available) Pointer to an integer value which contains the input byte; for port A only the lower 8 bits are significant; for port C only the bits C2 and C4 are significant. If the function is successfully executed, a '1' is returned. If an error occurs, a '0' is returned. The cause of the error can be determined with the function _me9xgetdrverrmess. _me96digetbit Description This function is only for the ME-96. This function determines the status of a single input line. Definitions C: int _me96digetbit (int iboardnumber, int ibitno, int *pibitvalue); Delphi: Function _me96digetbit (iboardnumber, ibitno: integer; Var ibitvalue: integer): integer; Basic: Declare Function me96digetbit Lib "me9x_32" Alias "_VBme96DIGetBit@12" (ByVal iboardnumber As Long, ByVal ibitno As Long, ByRef ibitvalue As Long) As Long Parameter <BoardNumber>Board number for 1., 2., 3. or 4. installed ME-94, ME-95 or ME-96; possible values: 0 3 <BitNo> Input line (number); possible values: 0 7: for port B 8, 9: for bits C2 and C4 of ports C Meilhaus Electronic Page 37 Function Reference

38 Rev. 4.7E Manual ME-94, ME-95, ME-96 <BitValue> Return Value Pointer to an integer value which corresponds with the line status: Possible return values: 0: Line is set to '0' 1: Line is set to '1' If the function is successfully executed, a '1' is returned. If an error occurs, a '0' is returned. The cause of the error can be determined with the function _me9xgetdrverrmess. _me96digetbyte Description This function is only for the ME-96. This function reads a byte (8 bits) from a input port. Definitions C: int _me96digetbyte (int iboardnumber, int iportno, int *pivalue); Delphi: Function _me96digetbyte (iboardnumber, iportno: integer; Var ivalue: integer): integer; Basic: Declare Function me96digetbyte Lib "me9x_32" Alias "_VBme96DIGetByte@12" (ByVal iboardnumber As Long, ByVal iportno As Long, ByRef ivalue As Long) As Long Parameters <BoardNumber>Board number for 1., 2., 3. or 4. installed ME-94, ME-95 or ME-96; possible values: 0 3 <PortNo> Port name; possible values: <PortNo> Description PORTB (01hex) Input port B PORTC (02hex) only the bits C2 and C4 are significant; the other bits of port C are not available <Value> Pointer to an integer value which contains the input byte; only the lower 8 bits are significant; for port C only the bits C2 and C4 are significant. Function Reference Page 38 Meilhaus Electronic

39 Manual ME-94, ME-95, ME-96 Rev. 4.7E Return Value If the function is successfully executed, a '1' is returned. If an error occurs, a '0' is returned. The cause of the error can be determined with the function _me9xgetdrverrmess Digital Output _me95dosetbit Description This function is only for the ME-95. Sets a single digital output line to 0 or 1. Definitions C: int _me95dosetbit (int iboardnumber, int ibitno, int ibitvalue); Delphi: function _me95dosetbit (iboardnumber, ibitno, ibitvalue: integer): integer; Basic: Declare Function me95dosetbit Lib "me9x_32" Alias "_VBme95DOSetBit@12" (ByVal iboardnumber As Long, ByVal ibitno As Long, ByVal ibitvalue As Long) As Long Parameters <BoardNumber>Board number for 1., 2., 3. or 4. installed ME-94, ME-95 or ME-96; possible values: 0 3 <BitNo> Output line (number) to be set; possible values: 0 7 (for port A) 8 15 (for port B) <BitValue> Bit value for output line to be set; possible values: = 0: bit set to '0' > 0: bit set to '1' Return Value If the function is successfully executed, a '1' is returned. If an error occurs, a '0' is returned. The cause of the error can be determined with the function _me9xgetdrverrmess. Meilhaus Electronic Page 39 Function Reference

40 Rev. 4.7E Manual ME-94, ME-95, ME-96 Description This function is only for the ME-95. Writes a byte to a digital output port. Definitions C: int _me95dosetbyte (int iboardnumber, int iportno, int ivalue); Delphi: function _me95dosetbyte (iboardnumber, iportno, ivalue: integer): integer; Basic: Declare Function me95dosetbyte Lib "me9x_32" Alias "_VBme95DOSetByte@12" (ByVal iboardnumber As Long, ByVal iportno As Long, ByVal ivalue As Long) As Long Parameters _me95dosetbyte <BoardNumber>Board number for 1., 2., 3. or 4. installed ME-94, ME-95 or ME-96; possible values: 0 3 <PortNo> Port name; possible values: <PortNo> Description PORTA (00hex) Output port A PORTB (01hex) Output port B <Value> Output value, possible values: 00Hex FFHex (decimal: 0 255); Return Value If the function is successfully executed, a '1' is returned. If an error occurs, a '0' is returned. The cause of the error can be determined with the function _me9xgetdrverrmess. Function Reference Page 40 Meilhaus Electronic

41 Manual ME-94, ME-95, ME-96 Rev. 4.7E _me96dosetbit Description This function is only for the ME-96. Sets a single digital output line to 0 or 1. Definitions C: int _me96dosetbit (int iboardnumber, int ibitno, int ibitvalue); Delphi: Function _me96dosetbit (iboardnumber, ibitno, ibitvalue: integer): integer; Basic: Declare Function me96dosetbit Lib "me9x_32" Alias "_VBme96DOSetBit@12" (ByVal iboardnumber As Long, ByVal ibitno As Long, ByVal ibitvalue As Long) As Long Parameters <BoardNumber> Board number for 1., 2., 3. or 4. installed ME-94, ME-95 or ME-96; possible values: 0 3 <BitNo> Output line (number) to be set; possible values: 0 7 (for port A) <BitValue> Bit value for output line to be set; possible values: = 0: bit set to '0' > 0: bit set to '1' Return Value If the function is successfully executed, a '1' is returned. If an error occurs, a '0' is returned. The cause of the error can be determined with the function _me9xgetdrverrmess. _me96dosetbyte Description This function is only for the ME-96. Writes a byte to a digital output port. Definitions C: int _me96dosetbyte (int iboardnumber, int iportno, int ivalue); Meilhaus Electronic Page 41 Function Reference

42 Rev. 4.7E Manual ME-94, ME-95, ME-96 Delphi: Basic: Parameters Function _me96dosetbyte (iboardnumber, iportno, ivalue: integer): integer; Declare Function me96dosetbyte Lib "me9x_32" Alias (ByVal iboardnumber As Long, ByVal iportno As Long, ByVal ivalue As Long) As Long <BoardNumber> Board number for 1., 2., 3. or 4. installed ME-94, ME-95 or ME-96; possible values: 0 3 <PortNo> Port name; the constant PORTA (00Hex) must be passed <Value> Output value, possible values: 00Hex FFHex (decimal: 0 255); Return Value If the function is successfully executed, a '1' is returned. If an error occurs, a '0' is returned. The cause of the error can be determined with the function _me9xgetdrverrmess Interrupt Handling _me94disableint Description This function is only for the ME-94. This function disables the interrupt control. It stops an interrupt processing started by _me94enableint. Important Note! This function can be used with Agilent VEE! Definitions C: int _me94disableint (int iboardnumber); Delphi: Function _me94disableint (iboardnumber: integer): integer; Basic: not implemented Parameters <BoardNumber> Board number for 1., 2., 3. or 4. installed ME-94, ME-95 or ME-96; possible values: 0 3 Function Reference Page 42 Meilhaus Electronic

43 Manual ME-94, ME-95, ME-96 Rev. 4.7E Return Value If the function is successfully executed, a '1' is returned. If an error occurs, a '0' is returned. The cause of the error can be determined with the function _me9xgetdrverrmess. _me94enableint Description This function is only for the ME-94. This function enables the interrupt control. If an interrupt occurs a user defined interrupt routine will be processed. Important Note! This function can be used with Agilent VEE! As interrupt source, you can use one of the both interrupt inputs PC2 or PC4 of the ME-94. Make sure, that the channel an interrupt signal was switched on first remains the interrupt input. Definitions C: int _me94enableint (int iboardnumber, pservice_proc IrqFunc); Delphi: Function _me94enableint (iboardnumber: integer; IrqFunc: Pointer): integer; Basic: not implemented Parameters <BoardNumber> Board number for 1., 2., 3. or 4. installed ME-94, ME-95 or ME-96; possible values: 0 3 <IrqFunc> Address of a user defined function of type (void SERVICE_PROC (void)) in C resp. of type pointer in Delphi, which is processed if an interrupt occures. Return Value If the function is successfully executed, a '1' is returned. If an error occurs, a '0' is returned. The cause of the error can be determined with the function _me9xgetdrverrmess. Meilhaus Electronic Page 43 Function Reference

44 Rev. 4.7E Manual ME-94, ME-95, ME-96 _me96disableint Description This function is only for the ME-96. This function disables the interrupt control. It stops an interrupt processing started by _me96enableint. Important Note! This function can be used with Agilent VEE! Definitions C: int _me96disableint (int iboardnumber); Delphi: Function _me96disableint (iboardnumber: integer): integer; Basic: not implemented Parameters <BoardNumber> Board number for 1., 2., 3. or 4. installed ME-94, ME-95 or ME-96; possible values: 0 3 Return Value If the function is successfully executed, a '1' is returned. If an error occurs, a '0' is returned. The cause of the error can be determined with the function _me9xgetdrverrmess. _me96enableint Description This function is only for the ME-96. This function enables the interrupt control. If an interrupt occurs an user defined interrupt routine will be processed. Important Note! This function can be used with Agilent VEE! As interrupt source, you can use one of the both interrupt inputs PC2 or PC4 of the ME-94. Make sure, that the channel an interrupt signal was switched on first remains the interrupt input. Function Reference Page 44 Meilhaus Electronic

45 Manual ME-94, ME-95, ME-96 Rev. 4.7E Definitions C: int _me96enableint (int iboardnumber, pservice_proc IrqFunc); Delphi: Function _me96enableint (iboardnumber: integer; IrqFunc: Pointer): integer; Basic: not implemented Parameters <BoardNumber> Board number for 1., 2., 3. or 4. installed ME-94, ME-95 or ME-96; possible values: 0 3 <IrqFunc> Address of a user defined function of type (void SERVICE_PROC (void)) in C resp. of type pointer in Delphi, which is processed if an interrupt occures. Return Value If the function is successfully executed, a '1' is returned. If an error occurs, a '0' is returned. The cause of the error can be determined with the function _me9xgetdrverrmess. _me9xgetirqcnt Description Function is used for: ME-94 and ME-96. This function acquires the number of interrupts since the device is running. Use this function to provide interrupt control for graphic programming languages like HPVEE or LabView. As usual the interrupt control must be enabled resp. disabled by the functions EnableInt and DisableInt. By reading the value of the parameter picnt it is possible to determine whether an interrupt was initiated or not, relative to a previous request. Definitions C: int _me9xgetirqcnt (int iboardnumber, int* picnt); Delphi: Function _me9xgetirqcnt (iboardnumber: integer; Var iirqcnt: integer): integer; Basic: Declare Function me9xgetirqcnt Lib "me9x_32" Alias "_VBme9xGetIrqCnt@8" (ByVal iboardnumber As Long, ByRef iirqcnt As Long) As Long Meilhaus Electronic Page 45 Function Reference

46 Rev. 4.7E Manual ME-94, ME-95, ME-96 Parameter <BoardNumber> Board number for 1., 2., 3. or 4. installed ME-94, ME-95 or ME-96; possible values: 0 3 <IrqCnt> Number of interrupts since the device is running Example ierrorcode = _me94enableint(0, 0, 1); ierrorcode = _me9xgetirqcnt(0, &iirqcntbefore); Sleep(1000); //waiting for interrupts ierrorcode = _me9xgetirqcnt(0, &iirqcntafter); ierrorcode = _me94disableint(0, 1); IrqCnt = (iirqcntafter-iirqcntbefore); Return value If the function is successfully executed, a '1' is returned. If an error occurs, a '0' is returned. The cause of the error can be determined with the function _me9xgetdrverrmess Error Handling _me9xgetdrverrmess Description This function is for the ME-94, ME-95, ME-96. If an error occurs during the processing of one of the API functions of the ME-9x driver, this routine returns the matching error code and text. Important Note! This function can only be called, if the previously called API function of the ME9x.DLL returned an error code (i. e. error code 0)! Definitions C: int _me9xgetdrverrmess (char *pcerrortext); Delphi: Function _me9xgetdrverrmess (Var errortext: errorstring): integer; Basic: Declare Function me9xgetdrverrmess Lib "me9x_32" Alias "_VBme9xGetDrvErrMess@4" (ByVal errortext As String) As Long Function Reference Page 46 Meilhaus Electronic

47 Manual ME-94, ME-95, ME-96 Rev. 4.7E Parameters <Errortext> Return Value Pointer to a string; the return value is the error code. 0, if there was no error or matching error code. Meilhaus Electronic Page 47 Function Reference