Addi-Data ADDINUM CPCI-1500 Parts list manual

DIN EN ISO 9001
certified
Technical support:
+49 (0)7223 / 9493-0
Technical description
ADDINUM APCI-/CPCI-1500
Digital inputs and outputs
for the PCI / CompactPCI bus
9
th edition 04/2002

Copyright
All rights reserved. This manual is intended for the manager and its personnel.
No part of this publication may be reproduced or transmitted by any means.
Offences can have penal consequences.
Guarantee and responsibility
Basically are effective our "general terms of delivery and payment". The manager receives
them at the latest with the invoice. Claims for guarantee and responsibility in case of injuries
and material damages are excluded, if they are due to one or some of the following causes:
- if the board has not been used for the intended purpose
- improper installation, operation and maintenance of the board
- if the board has been operated with defective safety devices or with not appropriate or
non-functioning safety equipment
- non-observance of the instructions concerning: transport, storage, inserting the board, use,
limit values, maintenance, device drivers
- altering the board at the user's own initiative
- altering the source files at the user's own initiative
- not checking properly the parts which are subject to wear
- disasters caused by the intrusion of foreign bodies and by influence beyond the user's
control.
Licence for ADDI-DATA software products
Read carefully this licence before using the standard software. The right for using this
software is given to the customer, if he/she agrees to the conditions of this licence.
- this software can only be used for configuring ADDI-DATA boards.
- copying the software is forbidden (except for archiving/ saving data and for replacing
defective data carriers).
- deassembling, decompiling, decoding and reverse engineering of the software are forbidden.
- this licence and the software can be transferred to a third party, so far as this party has
purchased a board, declares to agree to all the clauses of this licence contract and the
preceding owner has not kept copies of the software.
Trademarks
Borland C and Turbo Pascal are registered trademarks of Borland International, INC.
Intel is a registered trademark of Intel Corporation
AT, IBM, ISA and XT are registered trademarks of International Business Machines
Corporation
Microsoft, MS-DOS, Visual Basic and Windows are registered trademarks of
Microsoft Corporation
The original version of this manual is in German. You can obtain it on request.

i
WARNING
In case of improper handling and if the board is not
used for the purpose it is intended for:
people may be the board, PC and the environment
injured peripheral devices may be may be
damaged polluted
 Protect yourself, other people and the environment
•Read the yellow safety leaflet carefully !
If this leaflet is not with the documentation, please contact us.
•Observe the instructions in the manual !
Make sure that you do not forget or skip any step. We are not liable for damage resulting
from a wrong use of the board.
•Symbols used
WARNING!
designates a possibly dangerous situation.
If the instructions are ignored the board, PC and/or
peripheral devices may be damaged.
IMPORTANT!
designates hints and other useful information.
•Do you have any questions?
Our technical support is at your disposal

iii
Declaration of Conformity
This declaration is valid for the following product:
ADDINUM APCI-/CPCI-1500
PCI-board for 32-bit data bus
16 digital inputs, (14 interruptible)
16 digital outputs, 24V, opto-isolated
It is made by
ADDI-DATA GmbH
Meß- und Steuerungstechnik
Dieselstraße 3
D-77833 Ottersweier
in sole responsibility and is valid on the understanding that the product is competently installed, used and
maintained, according to the respective security regulations as well as to the manufacturer's instructions
regarding its intended use.
This declaration states that the product complies with following EC Directives:
zEWGRL 336/89 of 3.05.1989
zEWGRL 31/92 of 28.04.1992
zEWGRL 68/93 of 22.07.1993
This declaration is valid for all units manufactured according to the manufacturing references
listed in the form TDI1500.020.
Following norms have been applied to test the product regarding electromagnetic compatibility:
zEN55011/1998
zEN55022/1998
zEN61000-6-2/1999
We point out that
zthe conformity and herewith the permission of use expire if the user alters the product without
consulting with the manufacturer.
znon-skilled users are to have the operational area of the product and the requirements
resulting from it checked prior to putting into operation.
zby using this product in appliances coming under the EC EMC Directive, the user is to make
sure they are conform to its regulations prior to putting into operation.
zby using this product in machines / installations coming under the EU Machine Directive,
the user is to make sure they are conform to its regulations prior to putting into operation.
A copy of the EMC tests is at your disposal on request.
APCI-1500: 10th June 1998
CPCI-1500: 27th July 2000
Antonio Agnetti
Legally valid signature of the manufacturer

Table of contents APCI-/CPCI-1500
I
1INTENDED PURPOSE OF THE BOARD.....................................................1
1.1 Limits of use..........................................................................................................1
2USER ...................................................................................................2
2.1 Qualification ........................................................................................................2
2.2 Personal protection..............................................................................................2
3HANDLING THE BOARD ........................................................................3
4TECHNICAL DATA.................................................................................4
4.1 Electromagnetic compatibility (EMC) ..................................................................4
4.2 Physical set-up of the board................................................................................4
4.3 Options .................................................................................................................5
4.4 Limit values...........................................................................................................5
4.5 Component scheme.............................................................................................8
5INSTALLATION....................................................................................10
5.1 Installing an APCI-1500 board...........................................................................11
5.1.1 Selecting a free slot ...................................................................................................11
5.1.2 Plugging the board into the slot.................................................................................12
5.1.3 Closing the PC...........................................................................................................12
5.2 Installing a CPCI-1500 board ............................................................................13
6SOFTWARE.........................................................................................15
6.1 Board configuration with ADDIREG.....................................................................15
6.1.1 Installing ADDIREG .....................................................................................................15
6.1.2 Program description ..................................................................................................16
6.1.3 Registering a new board ...........................................................................................20
6.1.4 Changing the registration of a board........................................................................20
6.2 Driver installation ...............................................................................................21
6.2.1 Driver installation under MS-DOS ................................................................................21
6.2.2 Driver installation under Windows 3.11 und Windows NT ............................................21
6.2.3 Driver installation under Windows XP/2000/98 ............................................................22
6.3 Installation of the software samples ..................................................................23
6.3.1 Installation under DOS ...............................................................................................23
6.3.2 Installation under Windows 3.11 and Windows NT/XP/2000/98...................................23
6.4 The ADDI-UNINSTALL program.............................................................................24
6.4.1 Installation of ADDI-UNINSTALL ....................................................................................24
6.4.2 Software uninstalling with ADDI-UNINSTALL..................................................................24
Uninstall ADDIREG ......................................................................................................25
6.5 Software downloads from the Internet ...............................................................25

APCI-/CPCI-1500 Table of contents
II
7CONNECTING THE PERIPHERAL..........................................................26
7.1 Connector pin assignment.................................................................................26
7.2 Connection principle .........................................................................................27
7.3 Connection examples........................................................................................27
8FUNCTIONS OF THE BOARD ...............................................................29
8.1 Description of the board ....................................................................................29
8.1.1 Block diagrams..........................................................................................................29
8.1.2 Description.................................................................................................................30
8.2 Functions ............................................................................................................30
8.2.1 Digital input s .............................................................................................................30
Special input functions ..............................................................................................31
1) Interrupt:............................................................................................................................... 31
2) Counter................................................................................................................................. 31
8.2.2 Digital outputs............................................................................................................32
Special functions: ......................................................................................................32
8.2.3 Interrupt .....................................................................................................................33
8.2.4 Counter/timer ............................................................................................................34
Input frequencies ......................................................................................................35
Data ..........................................................................................................................35
Option (only implemented for the APCI-1500)...........................................................35
9STANDARD SOFTWARE .......................................................................36
9.1 Introduction........................................................................................................36
9.2 DIN 66001- Graphical symbols ..........................................................................37
9.3 Software functions (API)......................................................................................38
9.3.1 Base address and interrupt........................................................................................38
1) i_APCI1500_InitCompiler (..) ............................................................................................. 38
2) i_APCI1500_CheckAndGetPCISlotNumber (...) ................................................................ 40
3) i_APCI1500_SetBoardInformation (...)............................................................................... 42
4) i_APCI1500_GetHardwareInformation (...) ........................................................................ 44
5) i_APCI1500_CloseBoardHandle (..) ................................................................................... 46
9.3.2 Interrupt .....................................................................................................................48
1) i_APCI1500_SetBoardIntRoutineDos (..) ........................................................................... 48
2) i_APCI1500_SetBoardIntRoutineVBDos (..)...................................................................... 52
3) i_APCI1500_SetBoardIntRoutineWin16 (..) ....................................................................... 55
4) i_APCI1500_SetBoardIntRoutineWin32 (..) ....................................................................... 59
5) i_APCI1500_TestInterrupt (..) ............................................................................................. 66
6) i_APCI1500_ResetBoardIntRoutine (..) .............................................................................. 68
9.3.3 Kernel functions .........................................................................................................70
1) i_APCI1500_KRNL_Read16DigitalInput (...) .................................................................... 70
2) v_APCI1500_KRNL_Set16DigitalOutputOn (...)............................................................... 71
9.3.4 Digital input channel .................................................................................................72
1) i_APCI1500_Read1DigitalInput (...) ................................................................................... 72
2) i_APCI1500_Read8DigitalInput (...) ................................................................................... 72
3) i_APCI1500_Read16DigitalInput (...) ................................................................................. 73

Table of contents APCI-/CPCI-1500
III
9.3.5 Digital input channel - events ....................................................................................74
1) i_APCI1500_SetInputEventMask (...) ................................................................................. 74
2) i_APCI1500_StartInputEvent (...)........................................................................................ 77
3) i_APCI1500_StopInputEvent (...)........................................................................................ 77
9.3.6 Digital output channel...............................................................................................78
1) i_APCI1500_SetOutputMemoryOn (...) .............................................................................. 78
2) i_APCI1500_SetOutputMemoryOff (...) ............................................................................. 78
3) i_APCI1500_Set1DigitalOutputOn (...)............................................................................... 78
4) i_APCI1500_Set1DigitalOutputOff (...) .............................................................................. 79
5) i_APCI1500_Set8DigitalOutputOn (...)............................................................................... 80
6) i_APCI1500_Set8DigitalOutputOff (...) .............................................................................. 81
7) v_APCI1500_Set16DigitalOutputOn (...)............................................................................ 81
8) v_APCI1500_Set16DigitalOutputOff (...) ........................................................................... 82
9.3.7 Timer/counter and watchdog....................................................................................83
1) i_APCI1500_InitTimerInputClock (...)................................................................................ 83
2) i_APCI1500_InitTimerCounter1 (...)................................................................................... 84
3) i_APCI1500_InitTimerCounter2 (...)................................................................................... 85
4) i_APCI1500_InitWatchdogCounter3 (...) ............................................................................ 87
5) i_APCI1500_StartTimerCounter1(...).................................................................................. 88
6) i_APCI1500_StartTimerCounter2 (...)................................................................................. 89
7) i_APCI1500_StartCounter3 (...) .......................................................................................... 89
8) i_APCI1500_StopTimerCounter1 (...)................................................................................. 90
9) i_APCI1500_StopTimerCounter2 (...)................................................................................. 90
10) i_APCI1500_StopCounter3 (...)......................................................................................... 91
11) i_APCI1500_TriggerTimerCounter1 (...) .......................................................................... 91
12) i_APCI1500_TriggerTimerCounter2 (...) .......................................................................... 91
13) i_APCI1500_TriggerCounter3 (...) .................................................................................... 92
14) i_APCI1500_Watchdog (...) .............................................................................................. 92
15) i_APCI1500_ReadTimerCounter1 (...) .............................................................................. 92
16) i_APCI1500_ReadTimerCounter2 (...) .............................................................................. 93
17) i_APCI1500_ReadCounter3 (...)........................................................................................ 94
10 EXAMPLES .........................................................................................95
10.1 Initialisation........................................................................................................95
10.1.1 Initialisation of one xPCI-1500 board .........................................................................95
a) Flow chart..............................................................................................................95
b) Example in C.........................................................................................................96
10.1.2 Initialisation of several xPCI-1500 boards ...................................................................97
a) Flow chart..............................................................................................................97
b) Example in C.........................................................................................................98
10.2 Interrupt..............................................................................................................99
10.2.1 Interrupt routine..........................................................................................................99
a) Flow chart..............................................................................................................99
b) Example in C for DOS and Windows 3.1x ............................................................100
c) Example in C for Windows NT and Windows 95/98 (in asynchronous mode) .......101
d) Example for Windows NT and Windows 95/98 (in synchronous mode) ................102

APCI-/CPCI-1500 Table of contents
IV
10.2.2 Timer interrupt ..........................................................................................................103
a) Flow chart............................................................................................................103
b) Example in C for DOS ..........................................................................................104
c) Example in C for Windows 3.1x............................................................................105
d) Example in C for Windows NT/95/98 (in asynchronous mode) .............................106
e) Example in C for Windows NT/95/98 (in synchronous mode) ...............................107
INDEX ..........................................................................................................A

Figures and tables APCI-/CPCI-1500
V
Figures
Fig. 3-1: Correct handling of the CPCI-1500 ..........................................................................3
Fig. 3-2: Correct handling of the APCI-1500...........................................................................3
Fig. 4-1: Component scheme of the APCI-1500 board .........................................................8
Fig. 4-2: Component scheme of the CPCI-1500 board........................................................9
Fig. 5-1: Opening the blister packing ...................................................................................10
Fig. 5-2: Types of slots for PCI boards....................................................................................11
Fig. 5-3: Inserting the board..................................................................................................12
Fig. 5-4: Fastening the board at the back cover..................................................................12
Fig. 5-5: Types of slots for CompactPCI boards ....................................................................13
Fig. 5-6: Pushing a CPCI board into a rack ...........................................................................13
Fig. 5-7: Connector keying ...................................................................................................14
Fig. 6-1: Installation of the ADDIREG program ......................................................................15
Fig. 6-2: ADDIREG registration program ................................................................................16
Fig. 6-3: Configuring a new board .......................................................................................18
Fig. 6-4: PCI Boards...............................................................................................................19
Fig. 6-5: Driver installation .....................................................................................................21
Fig. 6-6: Inquiry of the .inf files (German version)...................................................................22
Fig. 6-7: Installation of the samples ......................................................................................23
Fig. 6-8: Installation of the ADDI-UNINSTALL program ............................................................24
Fig. 6-9: The ADDI-UNINSTALL program..................................................................................24
Fig. 7-1: 37-pin SUB-D male connector ................................................................................26
Fig. 7-2: Connection principle of the input and output channels.........................................27
Fig. 7-3: Connection examples for the input and output channels......................................27
Fig. 7-4: Connection examples............................................................................................28
Fig. 8-1: Block diagram of the APCI-1500.............................................................................29
Fig. 8-2: Block diagram of the CPCI-1500 ............................................................................29
Fig. 8-3: Protection circuitry for the inputs .............................................................................31
Fig. 8-4: Protection circuitry for the outputs...........................................................................33
Tables
Table 9-1: Type Declaration for Dos and Windows 3.1X .......................................................36
Table 9-2: Type Declaration for Windows 95/98/NT ...............................................................36
Table 9-3: Interrupt mask ......................................................................................................49

Technical description Chapter 1 APCI-/CPCI-1500
1
1 INTENDED PURPOSE OF THE BOARD
The APCI-/CPCI-1500 board is the interface between an industrial process and a
personal computer (PC). It is to be used in a free PCI slot.
The PC is to comply with the EU directive 89/336/EEC and the specifications for
EMC protection.
Products complying with these specifications bear the mark.
Data exchange between the APCI-/CPCI-1500 board and the peripheral is to
occur through a shielded cable. It has to be connected to the 37-pin SUB-D male
connector of the APCI-/CPCI-1500 board.
The board has 16 input channels and 16 output channels for processing digital
24 V signals.
An external 24 V supply voltage is necessary to run the output channels.
The PX 901 screw terminal board and the PX 8500 relay board allow to connect
the 24 V supply voltage through a shielded cable.
The use of the APCI-/CPCI-1500 board in combination with external screw
terminal or relay boards is to occur in a closed switch cabinet; the installation is
to be effected competently.
Check the shielding capacity of the PC housing and of the cable prior to
putting the device into operation.
The connection with our standard cable ST010 complies with the specifications:
- metallized plastic hoods
- shielded cable
- cable shield folded back and firmly screwed to the connector housing.
Uses beyond these specifications are not allowed. The manufacturer is not liable for
any damages which would result from the non-observance of this clause.
The use of the board according to its intended purpose includes observing all
advises given in this manual and in the safety leaflet.
1.1 Limits of use
The use of the board in a PC could change the PC features regarding noise
emission and immunity. Increased noise emission or decreased noise immunity
could result in the system not being conform anymore.
Our boards are not to be used for securing emergency stop functions.
The emergency stop functions are to be secured separately.
This securing must not be influenced by the board or the PC.
Make sure that the board remains in the protective blister pack until it is used.
Do not remove or alter the identification numbers of the board. If you do, the
guarantee expires.

APCI-/CPCI-1500 Technical description Chapter 2
2
2 USER
2.1 Qualification
Only persons trained in electronics are entitled to perform the following works:
•installation,
•use,
•maintenance.
2.2 Personal protection
Consider the country-specific regulations about
•the prevention of accidents
•electrical and mechanical installations
•radio interference suppression.

Technical description Chapter 3 APCI-/CPCI-1500
3
3 HANDLING THE BOARD
Fig. 3-1: Correct handling of the CPCI-1500
Fig. 3-2: Correct handling of the APCI-1500

APCI-/CPCI-1500 Technical description Chapter 4
4
4 TECHNICAL DATA
4.1 Electromagnetic compatibility (EMC)
The board has been subjected to EMC tests in an accredited laboratory in
accordance with the norms EN50082-2, EN55011, EN55022
The board complies as follows with the limit values set by the norm
EN50082-2:
True value Set value
ESD ................................................................... 4 kV 4 kV
Fields ................................................................. 10 V/m 10 V/m
Burst .................................................................. 2 kV 2 kV
Conducted radio interferences........................... 10 V 10 V
WARNING!
The EMC tests have been carried out in a specific appliance
configuration. We guarantee these limit values only in this configuration.
Consider the following aspects:
- your test program must be able to detect operation errors.
- your system must be set up so that you can find out what caused errors.
4.2 Physical set-up of the board
The board is assembled on a 4-layer printed circuit card.
APCI-1500 CPCI-1500
Dimensions
131 mm
127 mm
Weight 160 g 200 g
Installation PCI-5V (32-bit) slot or
PCI-5V (64-bit) slot
CompactPCI-5V(32-bit) slot or
CompactPCI-5V (64-bit) slot
Connection to the
peripheral
37-pin SUB-D male connector 37-pin SUB-D male connector

Technical description Chapter 4 APCI-/CPCI-1500
5
4.3 Options
The board CPCI-1500 is available in 2 versions:
- CPCI-1500-3U: 3U front plane
- CPCI-1500-6U: 6U front plane
4.4 Limit values
Operating temperature: ..................................... 0 to 60°C
Storage temperature: ......................................... -25 to 70°C
Relative humidity: ............................................ 30% to 99% non condensing
Minimum PC requirements (APCI-1500):
- PCI BIOS
- operating system: ........................................... MS DOS 3.3 or >
Windows 3.1, NT, 95, 98
- bus speed: ....................................................... < 33 MHz
Minimum system requirements (CPCI-1500):
- 32-bit CompactPCI bus (5 V)
- PCI BIOS, PCI 2.1 specification and complying with CompactPCI 2.1
- operating system .............................................MS DOS 3.3 or >
Windows 3.1, NT, 95, 98
- bus speed.........................................................≤33 MHz
Energy requirements
- operating voltage of the PC: ........................... 5V ±5%
- current consumption in mA (without load): ... typ. See table ±10%
APCI-1500 CPCI-1500
+ 5 V of the PC 320 mA 250 mA
+ 24 V extern - 10 mA
24 V digital input channels
Input type: ......................................................... common ground according
to IEC1131-2
Number of input channels: ............................... 16
Nominal voltage: .............................................. 24 VDC
Input current at nominal voltage: ..................... 6 mA

APCI-/CPCI-1500 Technical description Chapter 4
6
Logic input level:............................................... APCI-1500 CPCI-1500
U
H1) max.: 30 V 30 V
U
H min.: 19 V 17 V
U
L2) max.: 17 V 15 V
U
Lmin.: 0 V 0 V
Signal delay: ..................................................... 70 µs, (at nominal voltage)
Maximum input frequency: .............................. 5 kHz (at nominal voltage)
24 V digital output channels
Output type: ...................................................... high side (load at ground)
Number of output channels: ............................. 16
Nominal voltage: .............................................. 24 VDC
Range of the supply voltage: ............................ 10 V to 36 VDC
(over 24 V ext. pins)
Max. output current for the
16 output channels: ........................................... 3 A typ. (fused through
PTC resistors)
Max. output current / output channel: .............. 500 mA
Short-circuit current / output channel at 24 V,
APCI-1500: Rload < 0,1 R: ............................ 1,5 A max. (switches off the
output channel)
CPCI-1500: Rload < 0,01 R: .......................... 2,5 A max. (switches off the
output channel)
ON-resistor of the output channel
(RDS ON resistor):............................................ 0,4 R max.
Overtemperature: .............................................. 170°C (switches off the component
i.e. the 4 output channels)
Temperature hysteresis: .................................... 20°C
Switch ON time at 24 V, Rload 500 mA: ........... 100 µs typ.
Switch OFF time at 24 V, Rload 500 mA: ......... 60 µs typ.
Interruptible diagnostics, read back through status bit
ϑ
-diagnostic: ................................................... Pin 19 (24V/10 mA) is
switched on in case of overload
of the outputs or overtemperature
Vcc-diagnostic: .................................................. is switched on in case of voltage
drop < 5 V
1 UH: input voltage (= logic "1")
2 UL: input voltage (= logic "0")

Technical description Chapter 4 APCI-/CPCI-1500
7
Safety
Optical isolation
(DIN VDE 0411-100): ...................................... 1000 V (from the PC to the
external peripheral).
Logic: ................................................................ positive
Shut down logic: See
ϑ
-diagnostic
Watchdog: ........................................................ resets all the output channels, if no
software trigger has happened. Times
from 10 µs to 37 s are available.
Counter input channels: .................................... max. 10 kHz, 24 V
APCI-1500
Option: fast counter input channels: ................. max. 140 kHz, 24 V
CPCI-1500
Status LEDs on front connector:
Green LED on: ................................................. ext. voltage supply > 8 V
Red LED on: ..................................................... error signal from the outputs

APCI-/CPCI-1500 Technical description Chapter 4
8
4.5 Component scheme
Fig. 4-1: Component scheme of the APCI-1500 board

Technical description Chapter 4 APCI-/CPCI-1500
9
Fig. 4-2: Component scheme of the CPCI-1500 board

APCI-/CPCI-1500 Technical description Chapter 5
10
5 INSTALLATION
IMPORTANT !
If you want to install several ADDI-DATA boards simultaneously,
consider the following procedure:
•Install and configure the boards one after the other. You will thus avoid
configuration errors.
•Install and configure the boards one after the other.
You will thus avoid configuration errors.
1. Switch off the PC
2. Install the first board
3. Start the PC
4. Install ADDIREG (once is enough)
5. Configure the board
6. Install the driver and the samples if necessary
7. Switch off the PC
8. Install the second board
9. Start the PC
10. Configure the board
11. Install the driver and the samples if necessary.
etc.
IMPORTANT!
To install the new version of ADDIREG, please uninstall first the
current version from your PC with the ADDI-UNINSTALL
program.
Take the board out of the protective blister packing.
Fig. 5-1: Opening the blister packing

Technical description Chapter 5 APCI-/CPCI-1500
11
IMPORTANT!
Do observe the safety instructions.
•Switch off your PC and all the units connected to the PC.
•Pull the PC mains plug from the socket.
•Open your PC as described in the manual of the PC manufacturer.
5.1 Installing an APCI-1500 board
5.1.1 Selecting a free slot
The following PCI slot types are available for 5V systems:
PCI-5V (32 bit) and PCI-5V (64 bit)
Fig. 5-2: Types of slots for PCI boards
See in the PC manual which types of slots are free.
Decide in which type of slot to insert the board.
Remove the back cover of the selected slot according to the instructions of
the PC manufacturer. Keep the back cover. You will need it if you remove the
board.
Discharge yourself from electrostatic charges.