Deditec ETH-RELAIS-8 Guide

Hardware-Description
Juli
ETH-RELAIS-8 / OPTOIN-8
2019

INDEX
Index | 2Seite
1. Introduction 7
1.1. General remarks 7
1.2. Customer satisfaction 7
1.3. Customer response 7
2. Hardware description 9
2.1. Quick installation 9
9
2.1.1. Step 1 - Installation of the software and driver
9
2.1.2. Step 2 - Connecting of the module
9
2.1.3. Step 3 - Testing the connection and the module
10
2.1.4. DIP-Switches
2.2. ETH-RELAIS-8 12
12
2.2.1. Technical data
12
2.2.2. Product pictures
13
2.2.3. Overview screen
14
2.2.4. Pin assignment
14
2.2.4.1. Pin assignment J1
14
2.2.4.2. Pin assignment J2
15
2.2.5. Outputs
15
2.2.5.1. Relay outputs
15
2.2.5.2. Timeout protection
15
2.2.5.3. Visual control of the outputs (depends of
module)
2.3. ETH-OPTOIN-8 16
16
2.3.1. Technical data
17
2.3.2. Product pictures
18
2.3.3. Overview screen
19
2.3.4. Pin assignment
19
2.3.4.1. Pin assignment J1
19
2.3.4.2. Pin assignment J2
20
2.3.5. Inputs
20
2.3.5.1. Registering short input pulses
20
2.3.5.2. Galvanically decouppled through
optocouplers

INDEX
Index | 3Seite
20
2.3.5.3. Visual control of the inputs (depends of
module)
3. Hardware 23
3.1. LED blinking behavior 23
3.2. DIP-Switches 26
4. Firmware update 30
4.1. DEDITEC Flasher 30
5. Software 34
5.1. Using our products 34
34
5.1.1. Access via graphical applications
34
5.1.2. Access via the DELIB driver library
34
5.1.3. Access via protocol
35
5.1.4. Access via provided test programs
5.2. DELIB driver library 36
36
5.2.1. Overview
36
5.2.1.1. Program under diverse operating systems
37
5.2.1.2. Program with diverse programming languages
37
5.2.1.3. Program independent of the interface
37
5.2.1.4. SDK-Kit for Programmer
38
5.2.2. Supported operating systems
38
5.2.3. Supported programming languages
39
5.2.4. Installation DELIB driver library
41
5.2.5. DELIB Configuration Utility
5.3. Integration of the DELIB 42
42
5.3.1. Integration of the delib.h in Visual-C/C++
45
5.3.2. Integration of the delib.cs in Visual-C#
46
5.3.3. Integration of the delib.cs in Visual-C# unter Windows 64bit
50
5.3.4. Integration of the delib.pas in Delphi
51
5.3.5. Integration of the delib.bas in Visual Basic
52
5.3.6. Integration of the delib.vb in VB.NET
53
5.3.7. Integration of the delib.bas in MS-Office (VBA)
55
5.3.8. Integration of the delib.dll in LabVIEW

INDEX
Index | 4Seite
55
5.3.8.1. Integration of the delib.dll in LabVIEW
64
5.3.8.2. Usage of the VIs in LabVIEW
5.4. Test programs 66
66
5.4.1. Digital Input-Output Demo
5.5. DELIB CLI (command-line interface) 67
70
5.5.1. Customisation for USB-Modules (only Linux)
72
5.5.2. Customisation for RO-ETH-Modules (only Linux)
73
5.5.3. DELIB CLI samples
6. DELIB API reference 78
6.1. Management functions 78
78
6.1.1. DapiOpenModule
79
6.1.2. DapiCloseModule
80
6.1.3. DapiGetDELIBVersion
81
6.1.4. DapiSpecialCMDGetModuleConfig
83
6.1.5. DapiOpenModuleEx
6.2. Error handling 84
84
6.2.1. DapiGetLastError
85
6.2.2. DapiGetLastErrorText
6.3. Reading Digital inputs 86
86
6.3.1. DapiDIGet1
87
6.3.2. DapiDIGet8
88
6.3.3. DapiDIGet16
89
6.3.4. DapiDIGet32
90
6.3.5. DapiDIGet64
91
6.3.6. DapiDIGetFF32
92
6.3.7. DapiDIGetCounter
93
6.3.8. DapiSpecialCounterLatchAll
94
6.3.9. DapiSpecialCounterLatchAllWithReset
95
6.3.10. Dapi_Special_DI_FF_Filter_Value_Get
96
6.3.11. Dapi_Special_DI_FF_Filter_Value_Set
6.4. Setting Digital outputs 97
97
6.4.1. DapiDOSet1_WithTimer
98
6.4.2. DapiDOSet1

INDEX
Index | 5Seite
99
6.4.3. DapiDOSet8
100
6.4.4. DapiDOSet16
101
6.4.5. DapiDOSet32
102
6.4.6. DapiDOSet64
103
6.4.7. DapiDOReadback32
104
6.4.8. DapiDOReadback64
6.5. Example program 105
7. Appendix 108
7.1. Revisions 108
7.2. Copyrights and trademarks 109

I
Introduction | Seite 6
Introduction

Introduction | Seite 7
1. Introduction
1.1. General remarks
First of all, we would like to congratulate you to the purchase of a high quality
DEDITEC product.
Our products are being developed by our engineers according to quality
requirements of high standard. Already during design and development we take
care that our products have -besides quality- a long availability and an optimal
flexibility.
Modular design
The modular design of our products reduces the time and the cost of
development. Therefor we can offer you high quality products at a competitive
price.
Availability
Because of the modular design of our products, we have to redesign only a
module instead of the whole product, in case a specific component is no longer
available.
1.2. Customer satisfaction
Our philosophy: a content customer will come again. Therefor customer
satisfaction is in first place for us.
If by any chance, you are not content with the performance of our product,
please contact us by phone or mail immediately.
We take care of the problem.
1.3. Customer response
Our best products are co-developments together with our customers. Therefor
we are thankful for comments and suggestions.

II
Hardware description | Seite 8
Hardware description

Hardware description | Seite 9
2. Hardware description
2.1. Quick installation
2.1.1. Step 1 - Installation of the software and driver
Now install the driver DELIB library with the file "delib_install.exe" from the
supplied DEDITEC-Driver CD.
These can be found in the "\zip\DELIB\delib_install.exe" on the DEDITEC-Driver
CD.
Note: On our website www.deditec.de you can always find the latest DELIB
driver version.
2.1.2. Step 2 - Connecting of the module
Connect the ETH-RELAIS-8 or the ETH-OPTOIN-8 with a ethernet cable with
your network or PC.
2.1.3. Step 3 - Testing the connection and the module
In the Start menu, see "Start -> All Programs -> DEDITEC -> DELIB -> Sample
Programs" you will find some example programs to test your module.

Hardware description | Seite 10
2.1.4. DIP-Switches
You can configure DHCP- and EEPROM settings on the module directly via
DIP-Switches.
Achtung: Alle Änderungen an den DIP-Schaltern werden nur nach Trennung
und Wiederherstellung der Spannungsversorgung übernommen.
DIP Switch
1
Mode / Description
ON
DHCP is active
The network settings IP, subnet mask, DNS-Domain and
gateway will be received from a DHCP Server.
OFF
DHCP is not active
The network settings ip, subnet mask, DNS-Domain and
gateway from the module (EEPROM) itself will be used.
With the DELIB-Configuration Utility those settings can be edited
and saved in to the EEPROM of the module.