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.

Hardware description | Seite 11
DIP Switch
2
Mode / Description
ON
EEPROM is write protected
If the write protection is on, no settings can be configured via
the DELIB-Configuration Utility.
OFF
EEPROM write protection is off
DIP Switch
3
Mode / Description
ON
The settings from the EEPROM will be ignored on module
start. The modul will start with factory settings. The settings
which will be ignored are the IP-address, gateway, subnet
mask and DHCP.
Factory settings:
IP: 192.168.1.1
Subnet mask: 255.255.255.0
Gateway: 192.168.1.254
DHCP: Off
The settings in the EEPROM will not be changed.
OFF
The module will start with the settings from the EEPROM
DIP Switch
4
Mode / Description
ON
Modul will start normally.
OFF
Only for service.
The module will stay in bootloader mode and won't start the
firmware. All settings in the EEPROM will not be changed.

Hardware description | Seite 12
2.2. ETH-RELAIS-8
2.2.1. Technical data
Ethernet-Interface 100/10Mbit
Power supply: External 12-24V DC
8 Relays outputs (36V, 1A, 10W, make contact)
Max. switching voltage: 36V DC
Max. switching current: 0,5A
Max. switching power: 10W
Max. transport current: 1,25A
Isolation : 5TOhm
Switching time: 0,5ms
Fall time: 0,1ms
Timeout protection
2 Control-LEDs (Status, Interface activity)
8 LED Output-LEDs, one for each output
Dimensions: 77 x 67,5 x 55 mm (L x B x H)
Operation temperature: 10°C .. 50°C
2.2.2. Product pictures
ETH-RELAIS-8

Hardware description | Seite 13
2.2.3. Overview screen

Hardware description | Seite 14
2.2.4. Pin assignment
2.2.4.1. Pin assignment J1
Pin
Description
1
Output Channel 1
2
Output Channel 1
3
Output Channel 2
4
Output Channel 2
5
Output Channel 3
6
Output Channel 3
7
Output Channel 4
8
Output Channel 4
2.2.4.2. Pin assignment J2
Pin
Description
9
Output Channel 5
10
Output Channel 5
11
Output Channel 6
12
Output Channel 6
13
Output Channel 7
14
Output Channel 7
15
Output Channel 8
16
Output Channel 8

Hardware description | Seite 15
2.2.5. Outputs
2.2.5.1. Relay outputs
The relays are able to switch voltages up to 36V. The max. current is 1A at a
max. power of 15W.
Additionally, the relays provide a safe electrical isolation of the module to the
connected equipment.
2.2.5.2. Timeout protection
The timeout-protection gives the possibility to switch-off automatically the
outputs to prevent damage. This takes place, if in a predefined time frame any
communication with the module was possible. Reasons could be cable
disruption, PC-crash and so on. This way damage control, surcharge of
connected equipment and risk of accidents can be avoided.
2.2.5.3. Visual control of the outputs (depends of module)
The state of each output is directly signalized by a separate LED. This simplifies
to detect and rectify wiring errors, because the signals on the cables are directly
observable.

Hardware description | Seite 16
2.3. ETH-OPTOIN-8
2.3.1. Technical data
Ethernet-Interface 100/10Mbit
Power supply: External 12-24V DC
8 opto-coupler inputs
24V AC switching voltage (optional 15V, 12V and 5V are available)
16 Bit-Counter for each input
Detection of pulses between two selection cycles
Galvanically isolated using opto-couplers
Variable input voltage range min 5V, max 30V AC (standard: 15-30V)
Logging of impulses between 2 read out cycles
Control-LED LED for 5V power supply
Dimensions: 77 x 67,5 x 55 mm (L x W x H)
Operating temperature: 10°C .. 50°C

Hardware description | Seite 17
2.3.2. Product pictures
ETH-RELAIS-8

Hardware description | Seite 18
2.3.3. Overview screen

Hardware description | Seite 19
2.3.4. Pin assignment
2.3.4.1. Pin assignment J1
Pin
Description
1
Input Channel 1 +
2
Input Channel 1 -
3
Input Channel 2 +
4
Input Channel 2 -
5
Input Channel 3 +
6
Input Channel 3 -
7
Input Channel 4 +
8
Input Channel 4 -
2.3.4.2. Pin assignment J2
Pin
Description
9
Input Channel 5 +
10
Input Channel 5 -
11
Input Channel 6 +
12
Input Channel 6 -
13
Input Channel 7 +
14
Input Channel 7 -
15
Input Channel 8 +
16
Input Channel 8 -

Hardware description | Seite 20
2.3.5. Inputs
2.3.5.1. Registering short input pulses
Short input pulses between to read-out cycles are registered through an
additional logic and can be separately read-out.
2.3.5.2. Galvanically decouppled through optocouplers
AC input opto-couplers provide a galvanic isolation of the module towards the
connected equipment. They also provide a safe connection to the module for
reverse currents and high voltage peaks.
2.3.5.3. Visual control of the inputs (depends of module)
The state of each input is directly signalized by a separate LED. This simplifies
to detect and rectify wiring errors, because the signals on the cables are directly
observable.
Note: Only available for the ETH-RELAIS-8 and ETH-RELAIS-8_B module