2.1.1. Step 1 - Installation of the software and driver
2.1.2. Step 2 - Connecting of the module
2.1.3. Step 3 - Testing the connection and the module
2.2. USB-RELAIS-89
2.2.1. Technical data
2.2.2. Product pictures
2.2.3. Overview screen
2.2.4. Pin assignment
2.2.4.1. Pin assignment J1
2.2.4.2. Pin assignment J2
2.2.5. Outputs
2.2.5.1. Relay outputs
2.2.5.2. Timeout protection
2.2.5.3. Visual control of the outputs (depends of
module)
10
11
12
12
12
13
13
13
13
2.3. USB-OPTOIN-814
2.3.1. Technical data
2.3.2. Product pictures
2.3.3. Overview screen
2.3.4. Pin assignment
2.3.4.1. Pin assignment J1
2.3.4.2. Pin assignment J2
2.3.5. Inputs
2.3.5.1. Registering short input pulses
2.3.5.2. Galvanically decouppled through optocouplers
2.3.5.3. Visual control of the inputs (depends of module)
14
15
16
17
17
17
18
18
18
18
8
8
8
9
Index |2Seite
INDEX
3. Software21
3.1. Using our products21
3.1.1. Access via graphical applications
3.1.2. Access via the DELIB driver library
3.1.3. Access via protocol
3.1.4. Access via provided test programs
21
21
21
22
3.2. DELIB driver library23
3.2.1. Overview
3.2.1.1. Program under diverse operating systems
3.2.1.2. Program with diverse programming languages
3.2.1.3. Program independent of the interface
3.2.1.4. SDK-Kit for Programmer
3.2.2. Supported operating systems
3.2.3. Supported programming languages
3.2.4. Installation DELIB driver library
3.2.5. DELIB Configuration Utility
23
23
24
24
24
25
25
26
30
3.3. Test programs31
3.3.1. Digital Input-Output Demo
31
4. DELIB API reference33
4.1. Management functions33
4.1.1. DapiOpenModule
4.1.2. DapiCloseModule
4.1.3. DapiGetDELIBVersion
33
34
35
4.2. Error handling36
4.2.1. DapiGetLastError
4.2.2. DapiGetLastErrorText
36
37
4.3. Reading Digital inputs38
4.3.1. DapiDIGet1
4.3.2. DapiDIGet8
4.3.3. DapiDIGet16
4.3.4. DapiDIGet32
4.3.5. DapiDIGet64
4.3.6. DapiDIGetFF32
38
39
40
41
42
43
Index |3Seite
INDEX
4.4. Setting Digital outputs44
4.4.1. DapiDOSet1
4.4.2. DapiDOSet8
4.4.3. DapiDOSet16
4.4.4. DapiDOSet32
4.4.5. DapiDOSet64
4.4.6. DapiDOReadback32
4.4.7. DapiDOReadback64
44
45
46
47
48
49
50
4.5. Example program51
5. Appendix56
5.1. Revisions56
5.2. Copyrights and trademarks57
Index |4Seite
Introduction
I
Introduction |Seite5
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.
Introduction |Seite6
Hardware description
II
Hardware description |Seite7
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 your PC via USB cable to the USB connector of the module.
After about 20 seconds, the module is detected by the driver and can now be
tested and operated.
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 |Seite8
2.2. USB-RELAIS-8
Product
Connection
Activity-LED
Case
USB-RELAIS-8
screwable terminal block
1 for each output
Yes
USB-RELAIS-8_A
screwable
-
-
USB-RELAIS-8_B
screwable terminal block
1 for each output
-
2.2.1. Technical data
Interface USB 2.0 / USB 1.1
Power Supply +5V (power supply occurs over USB bus)
8x Relais outputs (36V, 1A, 15W)
max. switching voltage: 36V DC
max. switching current: 1A
max. switching power: 15W
max. transport current: 1,25A
Isolation (coil / contact): 1500V DC
contact resistance: 150mW
switching time: 0,5 ms
fall time: 0,1 ms
Outputs Selectable timeout-protection, if the module is not longer adressed
Galvanically isolated using relays
Control-LED LED for 5V power supply
Dimensions 77 mm x 67,5 mm x 55 mm (L x W x H)
Operating temperature 10°C .. 50°C
Produktspezifische Daten:
Hardware description |Seite9
2.2.2. Product pictures
USB-RELAIS-8
USB-RELAIS-8_A
USB-RELAIS-8_B
Hardware description |Seite10
2.2.3. Overview screen
Hardware description |Seite11
2.2.4. Pin assignment
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
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
2.2.4.1. Pin assignment J1
2.2.4.2. Pin assignment J2
Hardware description |Seite12
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.
Note: Only available for the USB-RELAIS-8 and USB-RELAIS-8_B module
Hardware description |Seite13
2.3. USB-OPTOIN-8
Product
Connection
Activity-LED
Case
USB-OPTOIN-8
screwable terminal block
1 for each input
Yes
USB-OPTOIN-8_A
screwable
-
-
USB-OPTOIN-8_B
screwable terminal block
1 for each input
-
2.3.1. Technical data
USB-Interface (USB 1.1 / USB 2.0)
Power supply: +5V (supply occurs over USB bus)
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
Produktspezifische Daten:
Hardware description |Seite14
2.3.2. Product pictures
USB-OPTOIN-8
USB-OPTOIN-8_A
USB-OPTOIN-8_B
Hardware description |Seite15
2.3.3. Overview screen
Hardware description |Seite16
2.3.4. Pin assignment
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 -
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 -
2.3.4.1. Pin assignment J1
2.3.4.2. Pin assignment J2
Hardware description |Seite17
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 USB-RELAIS-8 and USB-RELAIS-8_B module
Hardware description |Seite18
Hardware description |Seite19
Software
III
Software |Seite20
3. Software
3.1. Using our products
3.1.1. Access via graphical applications
We provide driverinterfaces e.g. for LabVIEW and ProfiLab. The DELIB driver
library is the basis, which can be directly activated by ProfiLAB.
For LabVIEW, we provide a simple driver connection with examples!
3.1.2. Access via the DELIB driver library
In the appendix, you can find the complete function reference for the integration of
our API-functions in your software. In addition we provide examples for the
following programming languages:
C
C++
C#
Delphi
VisualBasic
VB.NET
MS-Office
3.1.3. Access via protocol
The protocol for the activation of our products is open source. So you are able to
use our products on systems without Windows or Linux.
Software |Seite21
3.1.4. Access via provided test programs
We provide simple handling test programs for the most important functions of our
products. These will be installed automatically by the installation of the DELIB
driver library.
So you can test directly e.g. relays or you can check the voltage of an A/D
converter.
Software |Seite22
3.2. DELIB driver library
3.2.1. Overview
The following figure explains the structure of the DELIB driver library
The DELIB driver library allows an uniform response of DEDITEC hardware with
particular consideration of the following viewpoints:
Independent of operating system
Independent of programming language
Independent of the product
3.2.1.1. Program under diverse operating systems
The DELIB driver library allows an uniform response of our products on diverse
operating systems.
We has made sure, that all of our products can be responded by a few commands.
Whatever which operating system you use. - Therefore the DELIB cares!
Software |Seite23
3.2.1.2. Program with diverse programming languages
We provide uniform commands to create own applications. This will be solved by
the DELIB driver library.
You choose the programming language!
It can be simply developed applications under C++, C, Visual Basic, Delphi or
LabVIEW®.
3.2.1.3. Program independent of the interface
Write your application independent of the interface !
Program an application for an USB product of us. - Also, it will work with an
ethernet or RS-232 product of us !
3.2.1.4. SDK-Kit for Programmer
Integrate the DELIB in your application. On demand you receive an installation
script for free, which allows you, to integrate the DELIB installation in your
application.
Software |Seite24
3.2.2. Supported operating systems
Our products support the following operating systems:
Windows 7
Windows Vista
Windows XP
Windows 2000
Linux
3.2.3. Supported programming languages
Our products are responsive via the following programming languages:
C
C++
C#
Delphi
VisualBasic
VB.NET
MS-Office
Software |Seite25
3.2.4. Installation DELIB driver library
Our DELIB installer start screen.
Insert the DEDITEC driver CD into the drive and start „delib_install.exe“. The
DELIB driver library is also available on http://www.deditec.en/delib
Software |Seite26
Click on „Install“.
Software |Seite27
The drivers will be installed.
Software |Seite28
The DELIB driver library is now installed. Press „Close“ to finish the installation.
You can configure your module with the „DELIB Configuration Utility“ (see next
chapter). This is only necessary, if more than one module is present.
Software |Seite29
3.2.5. DELIB Configuration Utility
Start the “DELIB Configuration Utility” as follows:
Start Programs DEDITEC DELIB DELIB Configuration Utility.
The „DELIB Configuration Utility“ is a program to configure and subdivide
identical USB-modules in the system. This is only necessary if more than one
module is present.
Software |Seite30
3.3. Test programs
3.3.1. Digital Input-Output Demo
Start “Digital Input-Output Demo” as follows:
Start Programme DEDITEC DELIB Digital Input-Output Demo.
The screenshot shows a test of the RO-USB-O64-R64. The configuration of the
module (64 inputs and 64 outputs) is shown on the upper left side.
Software |Seite31
DELIB API reference
IV
DELIB API reference |Seite32
4. DELIB API reference
// USB-Modul öffnen
handle = DapiOpenModule(RO_USB1, 0);
printf("handle = %x\n", handle);
if (handle==0)
{
// USB Modul wurde nicht gefunden
printf("Modul konnte nicht geöffnet werden\n");
return;
}
4.1. Management functions
4.1.1. DapiOpenModule
Description
This function opens a particular module.
Definition
ULONG DapiOpenModule(ULONG moduleID, ULONG nr);
Parameters
moduleID=Specifies the module, which is to be opened (see delib.h)
nr=Indicates No of module which is to be opened.
nr=0 -> 1. module
nr=1 -> 2. module
Return value
handle=handle to the corresponding module
handle=0 -> Module was not found
Remarks
The handle returned by this function is needed to identify the module for all other
functions.
Example program
DELIB API reference |Seite33
4.1.2. DapiCloseModule
// Close the module
DapiCloseModule(handle);
Description
This command closes an opened module.
Definition
ULONG DapiCloseModule(ULONG handle);
Parameters
handle=This is the handle of an opened module
Return value
none
Example program
DELIB API reference |Seite34
4.1.3. DapiGetDELIBVersion
version = DapiGetDELIBVersion(0, 0);
//Bei installierter Version 1.32 ist version = 132(hex)
Description
This function returns the installed DELIB version.
Definition
ULONG DapiGetDELIBVersion(ULONG mode, ULONG par);
Parameters
mode=Mode, with which the version is readout (must be 0).
par=This parameter is not defined (must be 0).
Return value
version=Version number of the installed DELIB version [hex].
handle=This is the handle of an opened module
ch=Specifies the number of the output to be set to (0 ..)
data=Specifies the data value that is to be written (0 / 1)
Return value
None
DELIB API reference |Seite44
4.4.2. DapiDOSet8
Description
This command sets 8 digital outputs simultaneously.
handle=This is the handle of an opened module
ch=Specifies the number of the output, from which it begins to write to (0, 16, 32, ..)
data=Specifies the data values, to write to the outputs
Return value
None
DELIB API reference |Seite46
4.4.4. DapiDOSet32
// Einen Wert auf die Ausgänge schreiben
data = 0x0000ff00; // Ausgänge 9-16 werden auf 1 gesetzt
DapiDOSet32(handle, 0, data); // Chan Start = 0
printf("Schreibe auf Ausgänge Daten=0x%x\n", data);
printf("Taste für weiter\n");
getch();
// ---------------------------------------------------// Einen Wert auf die Ausgänge schreiben
data = 0x80000000; // Ausgang 32 wird auf 1 gesetzt
DapiDOSet32(handle, 0, data); // Chan Start = 0
printf("Schreibe auf Ausgänge Daten=0x%x\n", data);
printf("Taste für weiter\n");
getch();
// ---------------------------------------------------// Einen Wert auf die Ausgänge schreiben
data = 0x80000000; // Ausgang 64 wird auf 1 gesetzt
DapiDOSet32(handle, 32, data); // Chan Start = 32
printf("Schreibe auf Ausgänge Daten=0x%x\n", data);
printf("Taste für weiter\n");
getch();
Description
This command sets 32 digital outputs simultaneously.
handle=This is the handle of an opened module
ch=Specifies the number of the output, from which it begins to write to (0, 32, 64, ..)
data=Specifies the data values, to write to the outputs
handle=This is the handle of an opened module
ch=Specifies the number of the output, from which it begins to write to (0, 64, ..)
data=Specifies the data values, to write to the outputs
Return value
None
DELIB API reference |Seite48
4.4.6. DapiDOReadback32
Description
This command reads back the 32 digital outputs.
Definition
ULONG DapiDOReadback32(ULONG handle, ULONG ch);
Parameters
handle=This is the handle of an opened module
ch=Specifies the number of the input, from which it begins to read from (0, 32, ..)