WEU-RELAIS-8 * WEB relay module with 8 digital outputs for switching via IP, browser or TCP/IP (Modbus TCP-compatible) – DEDITEC
€ 184,45 Incl. 19% VAT plus shipping
Our promise to you
The WEU-RELAIS-8 is a compact module with an Ethernet and USB interface. In addition, you can integrate and control this module into your home or company network via WiFi. It is equipped with 8 relay outputs for switching capacities up to max. 1 A. Four DIP switches facilitate network configuration and a series of status LEDs visualize the switching states of the relays, among other things. The connection wiring is made via two 8-pole plug-in screw terminals.
A special feature of the module is that it can be controlled in various ways. Our remote switching tool, the WEB interface or the free APP are suitable for beginners. Programmers can address the module directly via our extensive driver library or even via TCP/IP. All documentation can be found in the “Downloads & Manuals” tab.
- 8 relay outputs (NO contact), galvanically isolated
- Max. Switching current: 1A
- Ethernet connection with 10/100 Mbit
- Connection via WiFi possible
- WPS function
- USB 2.0 interface up to 480 Mbit
- Timeout protection function
- 10 status LEDs
- Top hat rail mounting
- General
- Technical data
- ICT-Tool
- Configuration
- Modbus
- Controling
- DELIB-API commands
- WEB interface
- App
- Connection examples
- Downloads & manuals
- Scope of delivery
- Accessories
Relay
Our digital outputs use power relays with normally open (NO) function.
All our relays are equipped with a software-based timeout protection function to protect against damage caused, for example, by contact breakage to the control PC.
Fail-Safe Mode
The Fail-Safe mode is a safety function in which the DEDITEC module switches to a previously configured, safe switching state in the event of a connection failure.
This is intended to prevent connected installations or systems from continuing to run in an uncontrolled manner.
USB interface with Plug & Play
Thanks to Plug & Play, our modules with USB interface are automatically recognized and are immediately ready for use without any configuration. Configuration is only required if several USB modules from the same product series are used on the same system.
WEU modules
WEU modules (WEU = WiFi, Ethernet, USB) can be connected to the PC network by cable via Ethernet or USB interface, but also via WiFi. For a more user-friendly connection setup via WiFi, the module can also be connected to the router using the WPS function.
LEDs
Each digital input and output has a separate LED that lights up when the signal status is active. The status of the operating voltage, communication with the interface, error events or the occurrence of a timeout can also be displayed.
M2M
Machine-to-machine, or M2M for short, involves direct communication between two or more modules. Analog or digital input signals from one transmitter module can be automatically transmitted to another module on a channel-by-channel basis.
M2M transmission is supported by all our products in the WEU series or by products with a CAN interface.
Software and control for programmers
Our supplied DELIB driver library makes it easy to address the product via our API in almost all programming languages under Windows and Linux.
We offer support for the following programming languages:
- C
- C++
- C#
- VB
- VBA
- VB.Net
- Java
Remote switching of IP modules
Our IP modules can be conveniently and easily controlled worldwide via the TCP-IP network. The following options are available to you.
DEDITEC I/O Control app
With our DEDITEC I/O-Control app, our modules can also be controlled remotely. All you need is the network configuration of the module. The app is available for iOS and Android smartphones.
Web interface
Our IP modules can be operated from any browser. All you need is the IP address of the module.
M2M
Our WEU series modules can establish direct M2M communication with any DEDITEC Ethernet product, enabling, for example, the automated transmission of measured values or remote monitoring of machines and systems.
ICT-Tool
With the help of our all-in-one ICT-Tool software, you can configure, update, control and test your DEDITEC modules quickly and easily. The tool is included in the DEDITEC driver library.
More security through encryption
With the DEDITEC encryption mode, all TCP communication from the control PC to the DEDITEC module can be encrypted. This prevents unauthorized access to the module via TCP by third parties.
Control modules via Modbus TCP
Modbus TCP enables standardized data exchange between controllers, measuring devices, drives, and higher-level systems, regardless of the manufacturer. Status and measured values are read or written via the open Modbus register protocol.
Command-Line-Interface
With the help of the command line interface, or CLI for short, our products with Ethernet or USB interface can be easily addressed via the command line. Our digital and analog inputs/outputs are supported. The CLI is available for Windows and Linux operating systems.
General information
| Supply voltage | +12 V DC ... +24 V DC |
|---|---|
| LED |
|
| Operating temperature | +10 °C ... +50 °C |
| Dimensions | 94 mm x 88 mm x 55 mm (L x W x H) |
| DIN rail mounting | 35 x 7,5 mm |
Special features
Fail-Safe-function
| FAIL-SAFE-function |
|
|---|---|
| Timeout-mode "Normal" | The "Normal mode" is valid once and must be reactivated manually by software command after each timeout event. The customer application still has access to all controller outputs. |
| Timeout-mode „Auto reactivate“ | In “Auto reactivate mode”, the timeout function is automatically reactivated once communication with the control PC has been re-established. The customer application still has access to all outputs of the control unit. |
| Timeout-mode "Secure Outputs" | The “Secure outputs mode” blocks access to the outputs after the timeout event. Unlocking can only be carried out by software command. This is an important safety aspect in the event of a fault. |
Interfaces
Ethernet Interface
| Ethernet-interface |
|
|---|---|
| Connection setup |
|
| IP-address | DHCP or static |
| WPS button | Activation WPS |
| DIP switches |
|
| Access speed |
|
USB Interface
| USB-Interface |
|
|---|
Inputs/Outputs
Digital outputs (relay)
| Relay up to 1 A |
|
|---|
Connectors
| Plug connector 8-pin |
|
|---|
The ICT-Tool
Integration, configuration and testing - Our all-in-one Windows tool contains all the functions you need to put our products into operation quickly, easily and efficiently. Start with the setup and configuration, install firmware updates and use the extensive test and diagnostic options. The integrated help menu provides additional support if required.
Below you will find a brief overview of the program’s basic menus.
Module selection
Here you can integrate a new product into the ICT tool by clicking on the “+” symbol and then configure it.
ICT TreeView
In the TreeView, on the left-hand side of the program window, you can see the respective control elements or functions that are supported by your selected module. The scope of the functions depends on the respective product.
Overview
All relevant module information can be accessed here at a glance.
- Module name
- Module ID
- Firmware revision
- MAC address
- LAN and WiFi Network address (module dependent)
Inputs / Outputs
This overview shows the number of I/Os supported by your module.
Module infos
Here you will find all the important feature information for your module.
General features
Here you will find all the important feature information for your module.
Digital I/O features
Here you will find information about the digital I/Os supported by the module.
Analog I/O features
Here you will find information about the type of analog I/Os supported by your module.
Special I/O features
Here you will find information about the type of special I/Os supported by your module.
In den folgenden Kapitel, würden wir Ihnen unsere neue All-In-One-Software gerne genauer vorstellen.
Info
All relevant module information can be called up here at a glance.
- Module name
- Module ID
- Firmware revision
- Interface type
- Current DIP switch setting (only for Ethernet modules)
Identification
If several DEDITEC Ethernet modules are active in the network, a signal LED on the selected module can be activated via an identification function. This facilitates visual assignment.
Restart
You can restart your module here. The module status shows whether the restart was successful.
USB configuration
If you want to use several USB modules from the same product series on one PC, each of these modules must first be assigned its own module number.
LAN info
On this information page, you will find the current LAN network information and all the settings for your module at a glance.
LAN configuration
Integrate the product into your network or control it directly via a 1-to-1 connection.
The following parameters can be changed.
- Board name
- DHCP on/off
- IP address
- Subnet mask
- Default gateway
- TCP Port
WiFi info
All important WiFi settings are displayed on this page
WiFi configuration
Here you can change the network settings of the selected WiFi product.
The following settings can be made:
- Board name
- WLAN on/off
- Router name
- Router password
WPS
With the WPS function, your module can be connected to the router quickly and easily, automatically (WPS on the router is required)
CAN configuration
With our CAN products in the BS, NET and UC series, settings for the interface and the TX/RX packets can be made using the ICT tool.
More information can be found here:
Serial configuration
For our serial products in the BS, NET, UC and RO series, changes to the interface can be made using the
ICT tool.
More information can be found here:
Modbus TCP
Here you can set the Modbus TCP configuration of the module.
The following configurations can be made.
- Enable/disable access via Modbus TCP
- TCP port
TCP encryption
Here you can make settings for the encryption of your module.
The following configurations can be made.
- Allow unencrypted protocol
- Allow “User” encryption mode
- User password
- Allow “Admin” encryption mode
- Admin password
NTP configuration
You can make changes to the NTP service here.
The following configurations can be made.
- NTP service on/off
- server
- Port
- Timezone
WEB-Login
Here you can change the login settings of the web interface.
The following configurations can be made.
- Session duration
- Login name
- Login password
- Allow I/O access via web interface
D/A Default Values
Here you can set the D/A values and modes with which the module should be started.
The value and mode can be set individually for each channel.
Watchdog configuration
Here you can make and save settings on your watchdog stick.
Save or Load config
Using the “Save or Load config” function, you can save your entire module configuration in an external XML file.
This means you can always load your module in the desired original state.
The following configurations can be saved depending on the module type.
- USB configuration
- LAN configuration
- WiFi configuration
- TCP encryption
- NTP configuration
- Serial configuration
- CAN configuration
Status
This gives you an overview of the activity of the transmitter and receiver module
The following information from the transmitter module is displayed:
- Status of the activity: If the check mark is set, this action is currently being performed.
- Total number of actions performed. Is reset to 0 after a restart of the module.
- Number of actions per second.
- Number of DELIB errors that occur when executing commands from the DEDITEC driver library.
The following information from the receiver module is displayed:
- Connected: If the check mark is set, the transmitter and receiver modules are connected.
- IP address of the receiver module.
- Number of connection attempts.
Receiver modules
You can set the network settings of the receiver module here.
The following settings can be made
- Name for the receiver module
- Network settings of the receiver module
- Timeout
- Encryption type/ password
Action
With an action, you define which input signal is to be sent from the transmitter module to which output of a receiver module.
The following settings can be made:
- Type of task (digital, analog)
- Which receiver module should be used
- The interval at which the operations are to be carried out
- Start channel of the transmitter module
- Number of channels to be transmitted
- Start channel of the receive module
In the image on the right, DI data is sent every 100ms from channel 3(CH Start) to channel 8 ((CH Start) + (CH Count)) to channels 0-5 of the target module.
In den folgenden Kapitel, würden wir Ihnen unsere neue All-In-One-Software gerne genauer vorstellen.
Status
The Status area provides an overview of all active events and executed actions.
The following information is listed:
- Event number
- Event type
- Time interval of the event
- Number of events that have occurred
- Action number
- Number of triggered actions
- Number of other actions
Events configuration
Up to 16 different events can be created in the configuration menu. An event can be used, for example, to define switching thresholds at the analog inputs or logical states at the digital inputs of the module and link them to an executable action. The configuration itself is saved permanently in the module configuration memory of the module.
The following event modes are available, depending on the module type:
- DI: High-Low state of a digital input.
- DI flip-flop: Status change of a digital input (is stored in the module with the so-called flip-flop flag and deleted again after readout).
- DO readback: ON-OFF status of a digital output (is read out using a DO readback command).
- A/D: Current or voltage level at the analog inputs
Configuration actions
Up to 16 different actions can be created in the configuration menu. An action defines what should happen within an event after a condition is met.
The following action modes are available, depending on the module type:
- Set DO output: Switches a digital output on or off
- Set D/A output: Outputs a current or voltage value at an analog output
- Send CAN packet: A special CAN TX event is triggered (up to eight CAN TX events can be configured separately).
Digital Out
Hier können Sie die digitalen Ausgänge Ihres Modules ein- und ausschalten.
Folgende Funktionen können in dieser Form getestet werden.
- Kanalweise Ein- und Ausschalten der digitalen Ausgänge
- Readback der Kanäle
- Setzen eines Digitalausgangs für eine bestimmte Zeit (Modulabhängig)
- Gibt an welchen Status die Kanäle nach Ablauf der Zeit einnehmen sollen (Modulabhängig)
- Testen der Ausgänge
Digital Out
All digital outputs of your product can be checked by clicking on the buttons.
The following switching options are possible:
- Switching on and off channel by channel
- Channel-by-channel switching on or off for a specific time (product-dependent)
- Reading back the switching status (readback)
Digital In
In this view, the logical states of all optocoupler inputs can be read out.
The following information is displayed:
- Logical status of the inputs (ON/OFF)
- Number of detected pulses (counter function)
- Change of state detected (flip-flop)
TTL I/O
In this menu, the TTL channels of the module can be configured as inputs or outputs. The individual TTL outputs can be switched on or off by pressing the buttons. In addition, the status of all TTL inputs can be read out.
The tool offers the following functions:
- Configuration of the channels as input or output (in blocks of 8)
- Switching on and off channel by channel
- Reading back the switching status (output readback)
- Displaying the logical status of the inputs (input readback)
Analog Out
Here you can test the analog outputs of the module and manually enter any voltage or current value.
Analog In
In this menu, voltage or current values of all A/D channels can be displayed.
It is also possible to activate our A/D software filter with different filter levels.
CAN Runtime Parameter
Here you can change the CAN settings of the interface, the RX and TX packets in runtime.
The following settings can be made:
- Baud rate
- Extended ID
- Active on/off
- CAN ID
- Mode
CNT48
Here you can read out the counter readings of a counter module, select filter options and set various counting modes.
The following counting modes are supported:
- Read on rising edge
- Read on rising edge x2
- Read on rising edge x4
- Period duration
- Frequency measurement
- PWM measurement
Pulse generator
The pulse generator can be used to generate square-wave signals. High and low time as well as the number of pulses can be set here.
PWM Out
In this menu you have the option of testing various PWM frequencies. In addition, the duty cycle can be entered manually for each individual channel.
Temp
The temperature of all connected temperature sensors is displayed here directly in °C.
Graphical display
This menu allows a graphical representation of all analog input signals, such as A/D, temperature or FIFO-IN.
Watchdog
This tool can be used to check the configured watchdog parameters for correct function.
I/O – Timeout
You can use the timeout function in the I/O area to simulate a timeout case for your module.
The following is a description of the timeout window
- Read / Write symbol: Flashes to indicate an active connection to the module
- Automatic access: Removing the tick triggers a timeout after the timeout time has expired
- Manual access: Manual retrieval of data from the module
- Timeout status: Shows whether the timeout is active and whether a timeout event has occurred
- Timeout mode: Selection between 3 timeout modes, Normal, Reactivate and Secure
- Timeout duration: The time after which the timeout should be triggered is set here
- Activate / deactivate: Activates or deactivates the timeout function
Access times tests
You can test the access times for the module here. The following access time tests can be performed:
- Register – Read/Write/Write + Readback
- Digital I/O – Read/Write/Write + Readback
- Analog I/O – Read/Write/Write + Readback
Access times tests
This test can be used to determine the access times to the module. The test values are read and written in 8, 16, 32, or 64-bit commands.
Access times Register
The following example checks the register accesses to an Ethernet module. The average access time here is 0.5 ms.
Access times Analog I/O
In the following example, the access times to an Ethernet module with analog I/Os are checked. The average access time here is 0.6 ms.
Access times Digital I/O
In the following example, the access times to an Ethernet module with digital I/Os are checked. The average access time here is 0.6 ms.
Cable feedback tests
For this test, the digital or analog outputs of the module are connected to the corresponding digital or analog inputs of the module via cable. The feedback test now checks whether the output and input values match.
Cable return test
The cable return test can be used to check the function of all digital and analog inputs and outputs (I/Os) of a module. To do this, inputs and outputs are wired together externally on a 1:1 basis. The test software analyzes whether the output signals arrive correctly at the inputs, thereby identifying wiring errors or hardware defects.
Analog test
In analog test mode, the D/A converter outputs defined test voltages, which are then read in by the A/D converter and compared with the target values. The software counts the number of test runs and automatically documents any deviations.
Digital test
In the digital test, the switching states of the relay or MOSFET outputs are fed back externally to the optocoupler inputs. Here, too, the software counts and compares the number of cycles and automatically detects transmission errors or deviations.
Cable return test
The cable return test can be used to check the function of all digital and analog inputs and outputs (I/Os) of a module. To do this, inputs and outputs are wired together externally on a 1:1 basis. The test software analyzes whether the output signals arrive correctly at the inputs, thereby identifying wiring errors or hardware defects.
Analog test
In analog test mode, the D/A converter outputs defined test voltages, which are then read in by the A/D converter and compared with the target values. The software counts the number of test runs and automatically documents any deviations.
Digital test
In the digital test, the switching states of the relay or MOSFET outputs are fed back externally to the optocoupler inputs. Here, too, the software counts and compares the number of cycles and automatically detects transmission errors or deviations.
A/D ripple
The ripple test displays the residual ripple of the individual A/D inputs.
A/D quality measurements
The quality of an A/D measurement is influenced by various factors and can be affected by external interference. A reliable method for checking measurement quality is to measure a stable battery voltage. Our diagnostic tools can be used to determine the residual ripple and noise behavior.
A/D ripple
The A/D ripple test can be used to measure the residual ripple of the individual A/D inputs and check for interference signals such as mains hum or voltage instabilities.
A/D noise
The noise behavior of each A/D channel can be displayed graphically using A/D noise measurement. Additional filter stages with averaging can be used to smooth and improve the measurement signal.
FIFO In/Out
The software FIFO test can be used to specifically test the integrated FIFO buffering of our digital and analog NET I/O modules. Depending on whether it is an input or output module, data is read from the submodule FIFO or written to the submodule FIFO.
FIFO settings
The submodule number can be used to specify which module is to be tested. The start and end channels can also be used to transmit several channels simultaneously. In addition, the transmission frequency can be set and the desired FIFO mode selected – for example, for the use of test values or the actual measured values of the module.
All important information at a glance
During program execution, key information such as the size of the data packets, free and occupied bytes in the FIFO buffer, the number of data packets sent or received, and the current FIFO status are clearly displayed.
D/A output test
The D/A output test enables targeted testing of each individual D/A channel of a module. A freely selectable test voltage can be output directly. Currently, simple square wave signals with configurable high and low times are available. The signals can be monitored simultaneously with an oscilloscope. This function is also ideal for long-term tests. The test software detects DELIB errors and logs them automatically.
Mustertext
Mustertext
DO 4* value + wait
In this test, adjustable 16-bit values are written to the digital outputs of the module.
The values are sent to the module using the DapiDOSet16 command. The start channel is always channel 0.
You can set different wait times between the individual calls.
The test is intended for testing the functionality of the module.
Mustertext
Mustertext
Modbus I/O test
In the diagnostics section of the ICT-Tool, you can test the module’s digital and analog inputs and outputs directly via Modbus TCP. Register addresses as well as transfer and return values are displayed in a debug panel, allowing you to quickly diagnose problems with the D/A converter, for example. A complete overview of all register addresses and examples can be found in the Modbus manual at the following link:
To benefit from the latest functions and prevent errors, we recommend that you always keep your DEDITEC product up to date.
Flash Files
Downloading the firmware flash file package via the ICT tool
- Go to Flash Files in the “Firmware update” menu
- Click on the download button to start the download.
- Administration rights are required for the automatic unpacking of the flash files. If these rights are not available, the files are downloaded to the download area of your PC and must be extracted manually to the installation directory.
\DEDITEC\DELIB\programs\flash_files
Downloading the firmware flash file package via the DEDITEC homepage
- Download the required firmware flash file package from our homepage: Downloads -> Software -> Firmware
- Extract the files to the following installation path: ..\DEDITEC\DELIB\programs\flash_files
Flash modules
In the “Firmware update” menu, select the module you want to update and then click on the “Flash modules” or “Flash submodules” button.
The firmware is now updated and the module is then restarted automatically.
Information on the firmware flasher
The following information is displayed in the firmware flasher:
- Last FW: Displays the last firmware version
- Current FW: Displays the currently installed firmware version
- Newest FW: Displays the latest firmware version
- Log: Displays status or error messages during the flash process
In den folgenden Kapitel, würden wir Ihnen unsere neue All-In-One-Software gerne genauer vorstellen.
General
Here you can make general configurations to the ICT tool.
The following changes can be made:
- Language – setting between German and English possible
Updates
Here you can search for available DELIB or firmware updates.
- Automatic update search at program start
- Search for DELIB updates
- Search for firmware updates
Error log
Here you can make settings for the deditec_debug.log. This is saved under the path C:\Users\?USER?\AppData\Local\DEDITEC.
The following settings can be made:
- Enable writing to the debug.log
- Activate log notifications
- Activate automatic deletion of the debug.log
- Setting after how many days the debug.log should be deleted
- Set the maximum size of the debug.log
DELIB – DebugView – Global
Settings can be made here for the information that is to be displayed with the DebugView.
- Activate debug output
- Activate display of errors
DELIB – DebugView – Details
More detailed settings can be made here for the information to be displayed with the DebugView.
Configuration of our modules via the Ethernet / WiFi and USB interface
Depending on the product series, different interfaces are available for configuration with the control PC.
(Dynamic IP)
(Static IP)
In order to be able to address the DEDITEC product via Ethernet, it must be provided with the corresponding network settings. The following options are available for configuration:
- USB
- Ethernet / Dynamic IP
- Ethernet / Static IP
- Web interface
- WiFi
Connect the DEDITEC module to your PC via USB cable. Thanks to the Plug & Play function and the DELIB driver library, our modules are automatically recognized by your computer’s operating system. You can now access the module with our ICT-Tool and make the network settings in the configuration menu.
In DHCP mode, the DEDITEC module is automatically assigned a free IP address and the appropriate network settings by a DHCP server. The following options are available for activating DHCP mode:
- Activation via DIP switch
- Activation via the network search function in the “Edit / Add menu” of the ICT-Tool
- Activation via the “Module configuration menu” of the ICT-Tool
- Activation via the web interface of the module
DHCP mode can be activated on all DEDITEC modules with DIP switch 1.
In the “Edit / Add menu” of the ICT-Tool, you can scan the network for connected DEDITEC modules. Any modules found are then displayed in a list view where they can be configured and saved.
Click on the “Edit” button in the line of the desired module.
You can now make the desired network configuration in the following window and save it in the module using the “Save / Test” button.
To access the module’s configuration menu, the module must first be integrated into the ICT-Tool.
As the factory IP settings of the module often do not match the network settings of the customer’s PC, the following options are available to help you change them:
- Integration via the USB interface
- Integration via DHCP with DIP switch 1
- Direct connection to the PC * IP factory setting via DIP switch
- Integration via WiFi
Integration via the USB interface (only if available)
Connect the DEDITEC module to your PC via USB cable. Thanks to the Plug & Play function and the DELIB driver library, our modules are automatically recognized by your computer’s operating system. You can now select the module in the main menu of the ICT-Tool and make the network settings in the configuration menu.
Integration via DHCP using DIP switch 1
Set DIP switch 1 on your module to “ON” and switch the module on.
The module now starts in DHCP mode and can be added or selected as a module in the ICT-Tool. You can now make the network settings in the configuration menu. Then reset DIP switch 1 again.
Integration via the IP factory settings with DIP switch 3 and crossover cable
Connect the DEDITEC module directly to your PC using a crossover cable. Set the module’s DIP switch 3 to “ON” and switch the module on. The module now starts with the factory IP address 192.168.1.1. Temporarily set your PC to the same 192.168.1.x network and then add the DEDITEC module in the ICT-Tool.
You can now change the network settings of the module in the configuration menu. DIP switch 3 and the PC IP settings are then reset.
Integration via WiFi (only for WEU series modules)
By pressing the CFG button on the DEDITEC module, you activate the WPS function to automatically connect to the WLAN router of your network (see “WiFi” tab). After a successful connection, the module can be called up in the ICT-Tool via the board name stored in the router – e.g. “boardname.fritz.box” – and can be added as a new module. You can then make the network settings in the configuration menu. For support, contact your system administrator if necessary.
The module is now set to DHCP on the software side.
Central network settings, such as IP configuration or DHCP activation, can be made via the module’s web interface.
To call up the web interface of the module, start your Internet browser and enter the IP address of the module in the URL line. -> For more details, see the “Web interface” tab
To integrate the module into an existing network, it can be permanently assigned a fixed IP address. The following options are available for configuring the module’s network settings:
- Configuration via the network search function in the “Edit / Add menu” of the ICT-Tool
- Configuration via the “Module configuration menu” of the ICT-Tool
- Configuration via the module’s web interface
In the “Edit / Add menu” of the ICT-Tool, you can scan the network for connected DEDITEC modules. Any modules found are then displayed in a list view where they can be configured and saved.
Click on the “Edit” button in the line of the desired module.
You can now make the desired network configuration in the following window and save it in the module using the “Save / Test” button.
To access the module’s configuration menu, the module must first be integrated into the ICT-Tool.
As the factory IP settings of the module often do not match the network settings of the customer’s PC, the following options are available to help you change them:
- Integration via the USB interface
- Integration via DHCP with DIP switch 1
- Direct connection to the PC * IP factory setting via DIP switch
- Integration via WiFi
Integration via the USB interface (only if available)
Connect the DEDITEC module to your PC via USB cable. Thanks to the Plug & Play function and the DELIB driver library, our modules are automatically recognized by your computer’s operating system. You can now select the module in the main menu of the ICT-Tool and make the network settings in the configuration menu.
Integration via DHCP using DIP switch 1
Set DIP switch 1 on your module to “ON” and switch the module on.
The module now starts in DHCP mode and can be added or selected as a module in the ICT-Tool. You can now make the network settings in the configuration menu. Then reset DIP switch 1 again.
Integration via the IP factory settings with DIP switch 3 and crossover cable
Connect the DEDITEC module directly to your PC using a crossover cable. Set the module’s DIP switch 3 to “ON” and switch the module on. The module now starts with the factory IP address 192.168.1.1. Temporarily set your PC to the same 192.168.1.x network and then add the DEDITEC module in the ICT-Tool.
You can now change the network settings of the module in the configuration menu. DIP switch 3 and the PC IP settings are then reset.
Integration via WiFi (only for WEU series modules)
By pressing the CFG button on the DEDITEC module, you activate the WPS function to automatically connect to the WLAN router of your network (see “WiFi” tab). After a successful connection, the module can be called up in the ICT-Tool via the board name stored in the router – e.g. “boardname.fritz.box” – and can be added as a new module. You can then make the network settings in the configuration menu. For support, contact your system administrator if necessary.
The module is now set to DHCP on the software side.
Central network settings, such as IP configuration or DHCP activation, can be made via the module’s web interface.
To call up the web interface of the module, start your Internet browser and enter the IP address of the module in the URL line. -> For more information, see the “Web interface” tab
All central network settings for the module can be made via the module’s web interface.
Access to the web interface
To call up the web interface of the module, start your Internet browser and enter the IP address of the module in the URL line. The access data is set at the factory as follows:
| IP address: | 192.168.1.1 |
| User name: | admin |
| Password: | admin |
If you do not know the IP address of the module, simply use the network search function in the “Edit / Add Men” of the ICT-Tool or look at the IP address assignment in your router.
You can also find more information on this under the “Static IP” or “Dynamic IP” tabs
All modules in the WEU series have an integrated WiFi interface. The connection to a WiFi network can be established either via the ICT-Tool or by pressing the CFG button on the module. You can then make further network settings in the configuration menu. The following options are available for establishing a WiFi connection:
- Establish WiFi connection via button
- Establish automatic connection via ICT-Tool (WPS)
- Establish manual connection via ICT-Tool
By pressing the CFG button on the DEDITEC module, you activate the WPS function to automatically connect to the WLAN router of your network.
Different modes are activated depending on the duration of operation:
- 3–6 Press and hold for seconds: Activate WiFi
- 7–12 Press and hold for seconds: Start WPS connection
- 13–15 Press and hold for seconds: Deactivate WiFi
A status LED on the module indicates the current mode by flashing.
WPS – Simple connection to the network
WPS (WiFi Protected Setup) makes it particularly easy to connect to a WLAN network – without having to enter a network name or password manually.
This is how the WPS connection works:
- Activate WPS mode on the module (press the CFG button for 7-12 seconds)
- Press the WPS button on the router within 2 minutes*.
- The connection is now established automatically.
* Note:
For this type of connection to work, the router used must support WPS. Otherwise, the WLAN connection must be set up manually via the LAN configuration in the ICT-Tool.
A connection to the router can be established automatically in the WPS tab. To do this, press the “WPS Start” button and activate the WPS function on the router within two minutes. The devices will then connect to each other automatically.
If the router login data is known, a connection can be established in the WiFi configuration tab by entering the user name and password. Please note that WiFi must also be activated.
Control of Ethernet modules via Modbus TCP protocol
Modbus TCP is a protocol based on TCP/IP that is used for communication between different devices. It allows data to be read and written via so-called registers and bits. Standardized function codes are used for this purpose, such as:
General register allocation
| Modbus register (dez) |
Data type | Access | Data size (Bit) |
Description |
| 0 ... 9999 | Coil | write / read | 1 | Writing and reading back digital outputs |
| 10000 ... 19999 | Discrete Inputs | read | 1 | Read digital inputs |
| 30000 ... 39999 | Input Register | read | 16 | Read holder register |
| 40000 ... 49999 | Holding Register | write / read | 16 | Write and read back registers |
Control of Ethernet modules via Modbus TCP
Our modules can be controlled via the Modbus register protocol for quick and easy integration. This protocol allows you to conveniently read and write values, switch digital outputs, or query inputs. The complete protocol is available for download.
Example:
// Writes the digital outputs of channels 1-16
MASTER.WriteMultipleRegisters(SLAVE_ID, 0x0420, 0x03);
// Reads the values from channels 1-16
registerValue = MASTER.ReadHoldingRegisters(SLAVE_ID, 0x0420, NUMREGISTERS);
Configuration of our Modbus TCP modules
The Ethernet module is configured as follows at the factory:
Modbus active = YES
Modbus IP address = IP address of the module
Modbus port = 502 (standard Modbus port)
If you would like to use your own settings or deactivate the Modbus function, please use the configuration menu of our ICT-Tool.
Changing the parameters in the ICT-Tool
1. Setting/changing the IP address:
The IP address for Modbus TCP and TCP-IP is always identical.
Detailed instructions on how to change the IP address can be found at the following link:
2. Deactivate the Modbus function in the module:
If you want to deactivate the Modbus function, navigate to the “Modbus TCP” submenu, uncheck the “Enable” box, and then save your settings.
3. Port configuration
Modbus TCP communication takes place on port 502 by default. Alternatively, any port between 100 and 49151 can be set.
Modbus I/O test
In the diagnostics section of the ICT-Tool, you can test the module's digital and analog inputs and outputs directly via Modbus TCP. Register addresses as well as transfer and return values are displayed in a debug panel, allowing you to quickly diagnose problems with the D/A converter, for example. A complete overview of all register addresses and examples can be found in the Modbus manual at the following link:
Programming our modules with the DELIB driver library
The DELIB driver library enables uniform communication with all DEDITEC products. Thanks to its comprehensive and clearly structured design, our modules can be integrated into your projects and controlled in almost any programming language.
Detailed instructions on DELIB and a variety of programming examples can be found here:
A list of all DELIB commands can be found here:
Programming our modules with the DELIB driver library ETH
DELIB ETH is a pure Ethernet version of the DEDITEC driver library. It does not contain any drivers for USB or serial ports and does not need to be installed on the PC. There is also no need to configure or integrate a module in the registry. Admin write permissions are also not required.
As a project customer, you can also integrate DELIB ETH directly into your own setup.
All products with an Ethernet interface are supported by DELIB ETH and can be addressed directly via the TCP/IP address.
Click here for DELIB ETH:
Example of programming our modules with DELIB
Open module:
uint ModulID = 14; - the ID depends on the module type. (s. delib.h)
uint ModulNr = 0; - always 0 by default
uint handle; - handle of the open module
handle = DapiOpenModule(ModulID, ModulNr);
Switching relays:
uint ch = 0; - channel number
uint val = 1; - value to be set (0=off / 1=on)
DapiDOSet1(handle, ch, val);
Close module:
DapiCloseModule(handle);
Explanation:
The “DapiOpenModule” function is used to open a module. The two parameters passed within the parentheses determine which module is to be opened.
The first parameter refers to the module ID. You can find the correct ID for your module in the delib.h file, which is located in the DEDITEC installation path.
The second parameter refers to the module number, which is important if several modules of the same type are operated on one PC. If only one module is connected to the PC, simply enter “0”. The module number can be set directly on the module using the ICT-Tool.
How do I test my module?
You can access the module directly via the graphical user interface and execute all functions.
Click here for the ICT tool:
Programming our Ethernet modules
Our Ethernet modules are programmed using the DELIB driver library.
The following programming options (protocols/IP address) are available:
Module mit einem 10/100 Mbit Ethernet-Interface können direkt an einem PC oder an einem Netzwerk-LAN angeschlossen werden. Für die Konfiguration stehen folgende Möglichkeiten zur Auswahl:
Ansteuerung von Ethernet-Modulen mit Hilfe der IP-Direct-Methode
Mit dieser Methode können Sie unsere Ethernet-Module direkt über die IP-Adresse öffnen und steuern. Eine Installation des DELIB-Setups ist nicht notwendig.
Im folgenden Beispiel wird das Modul über IP-Direct geöffnet:
DAPI_OPENMODULEEX_STRUCT exbuffer = new DAPI_OPENMODULEEX_STRUCT();
exbuffer.address = „192.168.1.1“;
exbuffer.portno = 9912;
exbuffer.timeout = 5000;
handle = DapiOpenModuleEx(29, 0, exbuffer, 0);
Ansteuerung von Ethernet-Modulen mit Hilfe der Standard-Methode (Registry)
Mit dieser Methode wird das Modul über die in der Registry hinterlegten Netzwerkkonfiguration geöffnet.
Dadurch muss die Anwendungssoftware nicht die IP-Adresse kennen, da diese auf dem Rechner in der Registry gespeichert ist. Die Verteilung von Software auf unterschiedliche Rechner ist dadurch einfacher.
Die Konfiguration kann mit Hilfe des ICT-Tools in der Registry abgespeichert werden.
Im folgenden Beispiel wird das Modul über die Standard-Methode geöffnet:
uint ModulID = 39; (s. delib.h)
uint ModulNr = 0;
handle = DapiOpenModule(ModulID, ModulNr);
Ansteuerung von Ethernet-Modulen über TCP/IP über unser offenes Ethernet Protokoll
Bei Bedarf können Sie Ihre eigene Ansteuerung selber programmieren. Das Protokoll, welches die Kommunikation über TCP/IP beschreibt, ist offen gelegt. Die Ansteuerung erfolgt registerbasiert. Hierfür wurde ein Kommunikations-Protokoll erstellt, anhand dessen die Register des Moduls angesprochen werden und somit Lese- oder Schreibbefehle ausgeführt werden. Das Handbuch “Protokolle & Registerbelegung” beschreibt die Sende- und Empfangsrahmen, um mit unseren Ethernet-Modulen zu kommunizieren.
Our Ethernet products can be controled in various ways. For a better overview, we have divided these into the following points:
- IP direct method
- Standard method (registry)
- DEDITEC TCP/IP protocol
- Modbus TCP protocol
Ansteuerung von Ethernet-Modulen mit Hilfe der IP-Direct-Methode
Mit dieser Methode können Sie unsere Ethernet-Module direkt über die IP-Adresse öffnen und steuern. Eine Installation des DELIB-Setups ist nicht notwendig.
Im folgenden Beispiel wird das Modul über IP-Direct geöffnet:
DAPI_OPENMODULEEX_STRUCT exbuffer = new DAPI_OPENMODULEEX_STRUCT();
exbuffer.address = „192.168.1.1“;
exbuffer.portno = 9912;
exbuffer.timeout = 5000;
handle = DapiOpenModuleEx(29, 0, exbuffer, 0);
Ansteuerung von Ethernet-Modulen mit Hilfe der Standard-Methode (Registry)
Mit dieser Methode wird das Modul über die in der Registry hinterlegten Netzwerkkonfiguration geöffnet.
Dadurch muss die Anwendungssoftware nicht die IP-Adresse kennen, da diese auf dem Rechner in der Registry gespeichert ist. Die Verteilung von Software auf unterschiedliche Rechner ist dadurch einfacher.
Die Konfiguration kann mit Hilfe des ICT-Tools in der Registry abgespeichert werden.
Im folgenden Beispiel wird das Modul über die Standard-Methode geöffnet:
uint ModulID = 39; (s. delib.h)
uint ModulNr = 0;
handle = DapiOpenModule(ModulID, ModulNr);
Ansteuerung von Ethernet-Modulen über TCP/IP über unser offenes Ethernet Protokoll
Bei Bedarf können Sie Ihre eigene Ansteuerung selber programmieren. Das Protokoll, welches die Kommunikation über TCP/IP beschreibt, ist offen gelegt. Die Ansteuerung erfolgt registerbasiert. Hierfür wurde ein Kommunikations-Protokoll erstellt, anhand dessen die Register des Moduls angesprochen werden und somit Lese- oder Schreibbefehle ausgeführt werden. Das Handbuch “Protokolle & Registerbelegung” beschreibt die Sende- und Empfangsrahmen, um mit unseren Ethernet-Modulen zu kommunizieren.
Module mit einem 10/100 Mbit Ethernet-Interface können direkt an einem PC oder an einem Netzwerk-LAN angeschlossen werden. Für die Konfiguration stehen folgende Möglichkeiten zur Auswahl:
Control of Ethernet modules using the IP Direct method
This method allows you to open and control our Ethernet modules directly via the IP address. It is not necessary to install the DELIB setup.
In the following example, the module is opened via IP-Direct:
DAPI_OPENMODULEEX_STRUCT exbuffer = new DAPI_OPENMODULEEX_STRUCT();
exbuffer.address = „192.168.1.1“;
exbuffer.portno = 9912;
exbuffer.timeout = 5000;
handle = DapiOpenModuleEx(29, 0, exbuffer, 0);
Control of Ethernet modules using the standard method (registry)
This method opens the module via the network configuration stored in the registry.
This means that the application software does not need to know the IP address, as this is stored on the computer in the registry. This makes it easier to distribute software to different computers.
The configuration can be saved in the registry using the ICT-Tool.
In the following example, the module is opened using the standard method:
uint ModulID = 39; (s. delib.h)
uint ModulNr = 0;
handle = DapiOpenModule(ModulID, ModulNr);
Control of Ethernet modules via TCP/IP using our open Ethernet protocol
If required, you can program your own control system yourself. The protocol that describes communication via TCP/IP is open. Control is register-based. A communication protocol has been created for this purpose, which is used to address the registers of the module and thus execute read or write commands. The “Protocols & Register Assignment” manual describes the send and receive frames for communicating with our Ethernet modules.
This method allows you to open and control our Ethernet modules directly via the IP address. Installation of the DELIB setup is not necessary.
In the following example, the module is opened via IP Direct:
DAPI_OPENMODULEEX_STRUCT exbuffer = new DAPI_OPENMODULEEX_STRUCT();
exbuffer.address = „192.168.1.1“;
exbuffer.portno = 9912;
exbuffer.timeout = 5000;
handle = DapiOpenModuleEx(29, 0, exbuffer, 0);
Ansteuerung von Ethernet-Modulen mit Hilfe der IP-Direct-Methode
Mit dieser Methode können Sie unsere Ethernet-Module direkt über die IP-Adresse öffnen und steuern. Eine Installation des DELIB-Setups ist nicht notwendig.
Im folgenden Beispiel wird das Modul über IP-Direct geöffnet:
DAPI_OPENMODULEEX_STRUCT exbuffer = new DAPI_OPENMODULEEX_STRUCT();
exbuffer.address = „192.168.1.1“;
exbuffer.portno = 9912;
exbuffer.timeout = 5000;
handle = DapiOpenModuleEx(29, 0, exbuffer, 0);
Ansteuerung von Ethernet-Modulen mit Hilfe der Standard-Methode (Registry)
Mit dieser Methode wird das Modul über die in der Registry hinterlegten Netzwerkkonfiguration geöffnet.
Dadurch muss die Anwendungssoftware nicht die IP-Adresse kennen, da diese auf dem Rechner in der Registry gespeichert ist. Die Verteilung von Software auf unterschiedliche Rechner ist dadurch einfacher.
Die Konfiguration kann mit Hilfe des ICT-Tools in der Registry abgespeichert werden.
Im folgenden Beispiel wird das Modul über die Standard-Methode geöffnet:
uint ModulID = 39; (s. delib.h)
uint ModulNr = 0;
handle = DapiOpenModule(ModulID, ModulNr);
Ansteuerung von Ethernet-Modulen über TCP/IP über unser offenes Ethernet Protokoll
Bei Bedarf können Sie Ihre eigene Ansteuerung selber programmieren. Das Protokoll, welches die Kommunikation über TCP/IP beschreibt, ist offen gelegt. Die Ansteuerung erfolgt registerbasiert. Hierfür wurde ein Kommunikations-Protokoll erstellt, anhand dessen die Register des Moduls angesprochen werden und somit Lese- oder Schreibbefehle ausgeführt werden. Das Handbuch “Protokolle & Registerbelegung” beschreibt die Sende- und Empfangsrahmen, um mit unseren Ethernet-Modulen zu kommunizieren.
Module mit einem 10/100 Mbit Ethernet-Interface können direkt an einem PC oder an einem Netzwerk-LAN angeschlossen werden. Für die Konfiguration stehen folgende Möglichkeiten zur Auswahl:
Ansteuerung von Ethernet-Modulen mit Hilfe der IP-Direct-Methode
Mit dieser Methode können Sie unsere Ethernet-Module direkt über die IP-Adresse öffnen und steuern. Eine Installation des DELIB-Setups ist nicht notwendig.
Im folgenden Beispiel wird das Modul über IP-Direct geöffnet:
DAPI_OPENMODULEEX_STRUCT exbuffer = new DAPI_OPENMODULEEX_STRUCT();
exbuffer.address = „192.168.1.1“;
exbuffer.portno = 9912;
exbuffer.timeout = 5000;
handle = DapiOpenModuleEx(29, 0, exbuffer, 0);
Ansteuerung von Ethernet-Modulen mit Hilfe der Standard-Methode (Registry)
Mit dieser Methode wird das Modul über die in der Registry hinterlegten Netzwerkkonfiguration geöffnet.
Dadurch muss die Anwendungssoftware nicht die IP-Adresse kennen, da diese auf dem Rechner in der Registry gespeichert ist. Die Verteilung von Software auf unterschiedliche Rechner ist dadurch einfacher.
Die Konfiguration kann mit Hilfe des ICT-Tools in der Registry abgespeichert werden.
Im folgenden Beispiel wird das Modul über die Standard-Methode geöffnet:
uint ModulID = 39; (s. delib.h)
uint ModulNr = 0;
handle = DapiOpenModule(ModulID, ModulNr);
Ansteuerung von Ethernet-Modulen über TCP/IP über unser offenes Ethernet Protokoll
Bei Bedarf können Sie Ihre eigene Ansteuerung selber programmieren. Das Protokoll, welches die Kommunikation über TCP/IP beschreibt, ist offen gelegt. Die Ansteuerung erfolgt registerbasiert. Hierfür wurde ein Kommunikations-Protokoll erstellt, anhand dessen die Register des Moduls angesprochen werden und somit Lese- oder Schreibbefehle ausgeführt werden. Das Handbuch “Protokolle & Registerbelegung” beschreibt die Sende- und Empfangsrahmen, um mit unseren Ethernet-Modulen zu kommunizieren.
This method opens the module using the network configuration stored in the registry.
This means that the application software does not need to know the IP address, as this is stored in the registry on the computer. This makes it easier to distribute software to different computers.
The configuration can be saved in the registry using the ICT-Tool.
In the following example, the module is opened using the standard method:
uint ModulID = 39; (s. delib.h)
uint ModulNr = 0;
handle = DapiOpenModule(ModulID, ModulNr);
Ansteuerung von Ethernet-Modulen mit Hilfe der IP-Direct-Methode
Mit dieser Methode können Sie unsere Ethernet-Module direkt über die IP-Adresse öffnen und steuern. Eine Installation des DELIB-Setups ist nicht notwendig.
Im folgenden Beispiel wird das Modul über IP-Direct geöffnet:
DAPI_OPENMODULEEX_STRUCT exbuffer = new DAPI_OPENMODULEEX_STRUCT();
exbuffer.address = „192.168.1.1“;
exbuffer.portno = 9912;
exbuffer.timeout = 5000;
handle = DapiOpenModuleEx(29, 0, exbuffer, 0);
Ansteuerung von Ethernet-Modulen mit Hilfe der Standard-Methode (Registry)
Mit dieser Methode wird das Modul über die in der Registry hinterlegten Netzwerkkonfiguration geöffnet.
Dadurch muss die Anwendungssoftware nicht die IP-Adresse kennen, da diese auf dem Rechner in der Registry gespeichert ist. Die Verteilung von Software auf unterschiedliche Rechner ist dadurch einfacher.
Die Konfiguration kann mit Hilfe des ICT-Tools in der Registry abgespeichert werden.
Im folgenden Beispiel wird das Modul über die Standard-Methode geöffnet:
uint ModulID = 39; (s. delib.h)
uint ModulNr = 0;
handle = DapiOpenModule(ModulID, ModulNr);
Ansteuerung von Ethernet-Modulen über TCP/IP über unser offenes Ethernet Protokoll
Bei Bedarf können Sie Ihre eigene Ansteuerung selber programmieren. Das Protokoll, welches die Kommunikation über TCP/IP beschreibt, ist offen gelegt. Die Ansteuerung erfolgt registerbasiert. Hierfür wurde ein Kommunikations-Protokoll erstellt, anhand dessen die Register des Moduls angesprochen werden und somit Lese- oder Schreibbefehle ausgeführt werden. Das Handbuch “Protokolle & Registerbelegung” beschreibt die Sende- und Empfangsrahmen, um mit unseren Ethernet-Modulen zu kommunizieren.
Module mit einem 10/100 Mbit Ethernet-Interface können direkt an einem PC oder an einem Netzwerk-LAN angeschlossen werden. Für die Konfiguration stehen folgende Möglichkeiten zur Auswahl:
Ansteuerung von Ethernet-Modulen mit Hilfe der IP-Direct-Methode
Mit dieser Methode können Sie unsere Ethernet-Module direkt über die IP-Adresse öffnen und steuern. Eine Installation des DELIB-Setups ist nicht notwendig.
Im folgenden Beispiel wird das Modul über IP-Direct geöffnet:
DAPI_OPENMODULEEX_STRUCT exbuffer = new DAPI_OPENMODULEEX_STRUCT();
exbuffer.address = „192.168.1.1“;
exbuffer.portno = 9912;
exbuffer.timeout = 5000;
handle = DapiOpenModuleEx(29, 0, exbuffer, 0);
Ansteuerung von Ethernet-Modulen mit Hilfe der Standard-Methode (Registry)
Mit dieser Methode wird das Modul über die in der Registry hinterlegten Netzwerkkonfiguration geöffnet.
Dadurch muss die Anwendungssoftware nicht die IP-Adresse kennen, da diese auf dem Rechner in der Registry gespeichert ist. Die Verteilung von Software auf unterschiedliche Rechner ist dadurch einfacher.
Die Konfiguration kann mit Hilfe des ICT-Tools in der Registry abgespeichert werden.
Im folgenden Beispiel wird das Modul über die Standard-Methode geöffnet:
uint ModulID = 39; (s. delib.h)
uint ModulNr = 0;
handle = DapiOpenModule(ModulID, ModulNr);
Ansteuerung von Ethernet-Modulen über TCP/IP über unser offenes Ethernet Protokoll
Bei Bedarf können Sie Ihre eigene Ansteuerung selber programmieren. Das Protokoll, welches die Kommunikation über TCP/IP beschreibt, ist offen gelegt. Die Ansteuerung erfolgt registerbasiert. Hierfür wurde ein Kommunikations-Protokoll erstellt, anhand dessen die Register des Moduls angesprochen werden und somit Lese- oder Schreibbefehle ausgeführt werden. Das Handbuch “Protokolle & Registerbelegung” beschreibt die Sende- und Empfangsrahmen, um mit unseren Ethernet-Modulen zu kommunizieren.
If necessary, you can program your own control system yourself. The protocol that describes communication via TCP/IP is fully documented. Control is register-based. A communication protocol has been created for this purpose, which is used to address the module’s registers and thus execute read or write commands. The “Protocols & Register Assignment” manual describes the transmission and reception frames for communicating with our Ethernet modules.
Ansteuerung von Ethernet-Modulen mit Hilfe der IP-Direct-Methode
Mit dieser Methode können Sie unsere Ethernet-Module direkt über die IP-Adresse öffnen und steuern. Eine Installation des DELIB-Setups ist nicht notwendig.
Im folgenden Beispiel wird das Modul über IP-Direct geöffnet:
DAPI_OPENMODULEEX_STRUCT exbuffer = new DAPI_OPENMODULEEX_STRUCT();
exbuffer.address = „192.168.1.1“;
exbuffer.portno = 9912;
exbuffer.timeout = 5000;
handle = DapiOpenModuleEx(29, 0, exbuffer, 0);
Ansteuerung von Ethernet-Modulen mit Hilfe der Standard-Methode (Registry)
Mit dieser Methode wird das Modul über die in der Registry hinterlegten Netzwerkkonfiguration geöffnet.
Dadurch muss die Anwendungssoftware nicht die IP-Adresse kennen, da diese auf dem Rechner in der Registry gespeichert ist. Die Verteilung von Software auf unterschiedliche Rechner ist dadurch einfacher.
Die Konfiguration kann mit Hilfe des ICT-Tools in der Registry abgespeichert werden.
Im folgenden Beispiel wird das Modul über die Standard-Methode geöffnet:
uint ModulID = 39; (s. delib.h)
uint ModulNr = 0;
handle = DapiOpenModule(ModulID, ModulNr);
Ansteuerung von Ethernet-Modulen über TCP/IP über unser offenes Ethernet Protokoll
Bei Bedarf können Sie Ihre eigene Ansteuerung selber programmieren. Das Protokoll, welches die Kommunikation über TCP/IP beschreibt, ist offen gelegt. Die Ansteuerung erfolgt registerbasiert. Hierfür wurde ein Kommunikations-Protokoll erstellt, anhand dessen die Register des Moduls angesprochen werden und somit Lese- oder Schreibbefehle ausgeführt werden. Das Handbuch “Protokolle & Registerbelegung” beschreibt die Sende- und Empfangsrahmen, um mit unseren Ethernet-Modulen zu kommunizieren.
Modbus TCP is a protocol based on TCP/IP that is used for communication between different devices. It allows data to be read and written via so-called registers and bits. Standardized function codes are used for this purpose, such as:
General register allocation
| Modbus register (dez) |
Data type | Access | Data size (Bit) |
Description |
| 0 … 9999 | Coil | write / read | 1 | Writing and reading back digital outputs |
| 10000 … 19999 | Discrete Inputs | read | 1 | Read digital inputs |
| 30000 … 39999 | Input Register | read | 16 | Read holder register |
| 40000 … 49999 | Holding Register | write / read | 16 | Write and read back registers |
Modbus TCP is a protocol based on TCP/IP that is used for communication between different devices. It allows data to be read and written via so-called registers and bits. Standardized function codes are used for this purpose, such as:
- Read Coils (FC 01): reads digital outputs (0 or 1).
- Read Discrete Inputs (FC 02): reads digital inputs (0 or 1).
- Read Holding Registers (FC 03): Reads 16-bit values that can also be written (e.g., setpoints).
- Read Input Registers (FC 04): Reads 16-bit values that are read-only (e.g., measured values).
Our modules can be controlled via the Modbus register protocol for quick and easy integration. This protocol allows you to conveniently read and write values, switch digital outputs, or query inputs. The complete protocol is available for download.
Example:
// Writes the digital outputs of channels 1-16
MASTER.WriteMultipleRegisters(SLAVE_ID, 0x0420, 0x03);
// Reads the values from channels 1-16
registerValue = MASTER.ReadHoldingRegisters(SLAVE_ID, 0x0420, NUMREGISTERS);
Programming USB modules
Thanks to plug & play, our modules work without any major configuration effort. Only the module ID and module number are required to open the module. The module number is always 0 by default.
This only needs to be adjusted using the ICT-Tool if several modules from the same series are used.
In the following example, the USB module is opened:uint ModulID = 14; (s. delib.h)
uint ModulNr = 0;
handle = DapiOpenModule(ModulID, ModulNr);
Management functions
DapiOpenModule
This function opens a specific module.
Description
This function opens a specific module.
Definition
ULONG DapiOpenModule(ULONG moduleID, ULONG nr);
Parameter
moduleID=Specifies the module to be opened (see delib.h)
nr=Specifies which module is to be opened.
nr=0 -> 1. Module
nr=1 -> 2. Module
Return value
handle=Corresponding handle for the module
handle=0 -> Module was not found
Remark
The handle returned by this function is required to identify the module for all other functions.
Programming example
// Open USB module
handle = DapiOpenModule(RO_USB1, 0);
printf(„handle = %x\n“, handle);
if (handle==0)
{
// USB module was not found
printf(„Module could not be opened\n“);
return;
}
DapiCloseModule
This command closes an open module.
Description
This command closes an open module.
Definition
ULONG DapiCloseModule(ULONG handle);
Parameter
handle=This is the handle of an open module
Return value
None
Programming example
// Close module
DapiCloseModule(handle);
DapiGetDELIBVersion
This function returns the installed DELIB version.
Description
This function returns the installed DELIB version.
Definition
ULONG DapiGetDELIBVersion(ULONG mode, ULONG par);
Parameter
mode=Mode with which the version is read out (must always be 0).
par=This parameter is not defined (must always be 0).
Return value
version=Version number of the installed DELIB version [hex]
Programming example
version = DapiGetDELIBVersion(0, 0);
//With version 1.32 installed
version = 132(hex)
DapiSpecialCMDGetModuleConfig
This function returns the hardware configuration (number of input and output channels) of the module.
Description
This function returns the hardware configuration (number of input and output channels) of the module.
Definition
ULONG DapiSpecialCommand(ULONG handle,
DAPI_SPECIAL_CMD_GET_MODULE_CONFIG, par, 0, 0);
Parameter
handle=This is the handle of an open module
Querying the number of digital input channels
par=DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DI
Query number of digital input flip-flops
par=DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DI_FF
Query number of digital input counters (16-bit counter)
par=DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DI_COUNTER
Query number of digital input counters (48-bit counter)
par=DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_CNT48
Querying the number of digital output channels
par=DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DO
Querying the number of digital pulse generator outputs
par=DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_PULSE_GEN
Querying the number of digital PWM outputs
par=DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_PWM_OUT
Querying the number of digital input/output channels
par=DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DX
Querying the number of analog input channels
par=DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_AD
Querying the number of analog output channels
par=DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DA
Query number of temperature channels
par=DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_TEMP
Query number of stepper channels
par=DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_STEPPER
Return value
Querying the number of digital input channels
return=number of digital input channels
Query number of digital input flip-flops
return=number of digital input flip-flops
Query number of digital input counters (16-bit counter)
return=number of digital input counters (16-bit counter)
Query number of digital input counters (48-bit counter)
return=number of digital input counters (48-bit counter)
Querying the number of digital output channels
return=number of digital output channels
Querying the number of digital pulse generator outputs
return=number of digital pulse generator outputs
Querying the number of digital PWM outputs
return=number of digital PWM outputs
Querying the number of digital input/output channels
return=number of digital input/output channels
Querying the number of analog input channels
return=number of analog input channels
Querying the number of analog output channels
return=number of analog output channels
Query number of temperature channels
return=number of temperature channels
Query number of stepper channels
return=number of stepper channels
Programming example
ret=DapiSpecialCommand(handle,
DAPI_SPECIAL_CMD_GET_MODULE_CONFIG,
DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DI, 0, 0);
//Returns the number of digital input channels
ret=DapiSpecialCommand(handle,
DAPI_SPECIAL_CMD_GET_MODULE_CONFIG,
DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DO, 0, 0);
//Returns the number of digital output channels
ret=DapiSpecialCommand(handle,
DAPI_SPECIAL_CMD_GET_MODULE_CONFIG,
DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DX, 0, 0);
//Returns the number of digital input/output channels
ret=DapiSpecialCommand(handle,
DAPI_SPECIAL_CMD_GET_MODULE_CONFIG,
DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_AD, 0, 0);
//Returns the number of analog input channels
ret=DapiSpecialCommand(handle,
DAPI_SPECIAL_CMD_GET_MODULE_CONFIG,
DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DA, 0, 0);
//Returns the number of analog output channels
ret=DapiSpecialCommand(handle,
DAPI_SPECIAL_CMD_GET_MODULE_CONFIG,
DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_STEPPER, 0, 0);
//Returns the number of stepper channels
DapiOpenModuleEx
This function specifically opens a module with an Ethernet interface. The parameters IP address, port number and the duration of the timeout can be defined.
Description
This function specifically opens a module with an Ethernet interface. The parameters IP address, port number and the duration of the timeout can be defined. The module is opened independently of the settings made in the DELIB Configuration Utility.
Definition
ULONG DapiOpenModuleEx(ULONG moduleID, ULONG nr, unsigned char* exbuffer, 0);
Parameter
moduleID = Specifies the module to be opened (see delib.h)
nr = Specifies which module (if several) is to be opened.
nr = 0 -> 1. Module
nr = 1 -> 2. Module
exbuffer = Buffer for IP address, port number and duration of the timeout
Return value
handle = Corresponding handle for the module
handle = 0 -> Module was not found
Remark
The handle returned by this function is required to identify the module for all other functions.
This command is supported by all modules with an Ethernet interface.
Programming example
// Open ETH-Module with parameter
DAPI_OPENMODULEEX_STRUCT open_buffer;
strcpy((char*) open_buffer.address, "192.168.1.10");
open_buffer.portno = 0;
open_buffer.timeout = 5000;
handle = DapiOpenModuleEx(RO_ETH, 0, (unsigned char*) &open_buffer, 0);
printf("Module handle = %x\n", handle);
DapiScanAllModulesAvailable
This function can be used to scan all modules connected to the USB bus.
Description
This function can be used to scan all modules connected to the USB bus.
The module ID and module no. of each module found are determined.
Definition
ULONG DapiScanAllModulesAvailable(uint nr)
Parameter
nr = 0: All modules connected to the USB bus are searched for
nr = i: Reading out the individual connected modules
Return value
Indicates the number of modules found.
Programming example
no_of_modules =
DT.Delib.DapiScanAllModulesAvailable(0);
for (i = 1; i <= no_of_modules; i++)
{
ret = DapiScanAllModulesAvailable(i);
moduleID = ret & 0x0000ffff;
moduleNr = (ret >> 16) & 0xff;
}
Register functions
DapiWriteByte
This command executes a direct register write command to the module.
Description
This command executes a direct register write command to the module.
Definition
void DapiWriteByte(ULONG handle, ULONG adress, ULONG value);
Parameter
handle=This is the handle of an open module
adress=Address to be accessed
value=Specifies the data value that is written (8-bit)
Return value
None
Remark
This should only be used by experienced programmers. This allows direct access to all available registers.
Programming example
// Data is written to register 0x10
DapiWriteByte(handle, 0x10, 0xFF);
DapiWriteWord
This command executes a direct register write command to the module.
Description
This command executes a direct register write command to the module.
Definition
void DapiWriteWord(ULONG handle, ULONG adress, ULONG value);
Parameter
handle=This is the handle of an open module
adress=Address to be accessed
value=Specifies the data value that is written (16-bit)
Return value
None
Remark
This should only be used by experienced programmers. This allows direct access to all available registers.
Programming example
// Data is written to register 0x10
DapiWriteWord(handle, 0x10, 0xFFFF);
DapiWriteLong
This command executes a direct register write command to the module.
Description
This command executes a direct register write command to the module.
Definition
void DapiWriteLong(ULONG handle, ULONG adress, ULONG value);
Parameter
handle=This is the handle of an open module
adress=Address to be accessed
value=Specifies the data value that is written (32-bit)
Return value
None
Remark
This should only be used by experienced programmers. This allows direct access to all available registers.
Programming example
// Data is written to register 0x10
DapiWriteLong(handle, 0x10, 0xFFFFFFFF);
DapiWriteLongLong
This command executes a direct register write command to the module.
Description
This command executes a direct register write command to the module.
Definition
void DapiWriteLongLong(ULONG handle, ULONG adress, ULONGLONG value);
Parameter
handle=This is the handle of an open module
adress=Address to be accessed
value=Specifies the data value that is written (64-bit)
Return value
None
Remark
This should only be used by experienced programmers. This allows direct access to all available registers.
Programming example
// Data is written to register 0x10
DapiWriteLongLong(handle, 0x10, 0xFFFFFFFFFFFFFFFF);
DapiReadByte
This command executes a direct register read command on the module.
Description
This command executes a direct register read command on the module.
Definition
ULONG DapiReadByte(ULONG handle, ULONG adress);
Parameter
handle=This is the handle of an open module
adress=Address to be accessed
Return value
Content of the register to be read (8-bit)
Remark
This should only be used by experienced programmers. This allows direct access to all available registers.
Programmierbeispiel
// Reads 8 bits from the address 0x0
ULONG data;
data = DapiReadByte(handle, 0x0);
DapiReadWord
This command executes a direct register read command on the module.
Description
This command executes a direct register read command on the module.
Definition
ULONG DapiReadWord(ULONG handle, ULONG adress);
Parameter
handle=This is the handle of an open module
adress=Address to be accessed
Return value
Content of the register to be read (16-bit)
Remark
This should only be used by experienced programmers. This allows direct access to all available registers.
Programming example
// Reads 16 bits from the address 0x0
ULONG data;
data = DapiReadWord(handle, 0x0);
DapiReadLong
This command executes a direct register read command on the module.
Description
This command executes a direct register read command on the module.
Definition
ULONG DapiReadLong(ULONG handle, ULONG adress);
Parameter
handle=This is the handle of an open module
adress=Address to be accessed
Return value
Content of the register to be read (32-bit)
Remark
This should only be used by experienced programmers. This allows direct access to all available registers.
Programming example
// Reads 32 bits from the address 0x0
ULONG data;
data = DapiReadLong(handle, 0x0);
DapiReadLongLong
This command executes a direct register read command on the module.
Description
This command executes a direct register read command on the module.
Definition
ULONGLONG DapiReadLongLong(ULONG handle, ULONG address);
Parameter
handle=This is the handle of an open module
address=Address to be accessed
Return value
Content of the register to be read (64-bit)
Remark
This should only be used by experienced programmers. This allows direct access to all available registers.
Programming example
// Reads 64 bits from the address 0x0
ULONGLONG data;
data = DapiReadLongLong(handle, 0x0);
Digital output functions
DapiDOSet1
This command sets a single output.
Description
This command sets a single output.
Definition
void DapiDOSet1(ULONG handle, ULONG ch, ULONG data);
Parameter
handle=This is the handle of an open module
ch=Indicates the number of the output to be set (0 .. )
data=Indicates the data value to be written (0 / 1)
Return value
None
Requirements
The following SW feature bits must be supported by the module:
DAPI_SW_FEATURE_BIT_CFG_DO
The following conditions for the transfer parameters must be met:
maxCh = DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_GET_MODULE_CONFIG, DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DO, 0, 0);
maxCh > ch
Programming example
// Output 8 is set to 1
DapiDOSet1(handle, 7, 1);
DapiDOSet8
This command sets 8 digital outputs simultaneously.
Description
This command sets 8 digital outputs simultaneously.
Definition
void DapiDOSet8(ULONG handle, ULONG ch, ULONG data);
Parameter
handle=This is the handle of an open module
ch=Specifies the number of the output to be written from (0, 8, 16, 24, 32, ..)
data=Indicates the data values to be written
Return value
None
Programming example
// Outputs 9-12 are set to 0
// Outputs 13-16 are set to 1
DapiDOSet8(handle, 8, 0xf0);
DapiDOSet16
This command sets 16 digital outputs simultaneously.
Description
This command sets 16 digital outputs simultaneously.
Definition
void DapiDOSet16(ULONG handle, ULONG ch, ULONG data);
Parameter
handle=This is the handle of an open module
ch=Specifies the number of the output to be written from (0, 16, 32, ..)
data=Indicates the data values to be written
Return value
None
Programming example
// Outputs 1-8 are set to 0
// Outputs 9-16 are set to 1
DapiDOSet16(handle, 0, 0xff00);
DapiDOSet32
This command sets 32 digital outputs simultaneously.
Description
This command sets 32 digital outputs simultaneously.
Definition
void DapiDOSet32(ULONG handle, ULONG ch, ULONG data);
Parameter
handle=This is the handle of an open module
ch=Specifies the number of the output from which to write (0, 32, 64, ..)
data=Indicates the data values to be written
Return value
None
Programming example
// Write a value to the outputs
data = 0x0000ff00; // Outputs 9-16 are set to 1
DapiDOSet32(handle, 0, data); // Chan Start = 0
printf("Schreibe auf Ausgänge Daten=0x%x\n", data);
printf("Taste für weiter\n");
getch();
// ----------------------------------------------------
// Write a value to the outputs
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();
// ----------------------------------------------------
// Write a value to the outputs
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();
DapiDOSet64
This command simultaneously sets 64 digital outputs.
Description
This command sets 64 digital outputs simultaneously.
Definition
void DapiDOSet64(ULONG handle, ULONG ch, ULONGLONG data);
Parameter
handle=This is the handle of an open module
ch=Indicates the number of the output to be written from (0, 64, ..)
data=Indicates the data values to be written
Return value
None
Programming example
// Outputs 1-32 are set to 0
// Outputs 33-64 are set to 1
DapiDOSet64(handle, 0, 0xffffffff00000000);
DapiDOReadback32
This command reads back the 32 digital outputs.
Description
This command reads back the 32 digital outputs.
Definition
ULONG DapiDOReadback32(ULONG handle, ULONG ch);
Parameter
handle=This is the handle of an open module
ch=Specifies the number of the output from which to read back (0, 32, 64, ..)
Return value
Status of 32 outputs.
Programming example
// Read back channel 1-32
unsigned long data;
data = DapiDOReadback32(handle, 0);
DapiDOReadback64
This command reads back the 64 digital outputs.
Description
This command reads back the 64 digital outputs.
Definition
ULONG DapiDOReadback64(ULONG handle, ULONG ch);
Parameter
handle=This is the handle of an open module
ch=Specifies the number of the output from which to read back (0, 32, 64, ..)
Return value
Status of 64 outputs.
Programming example
// Read back channel 1-64
unsigned long data;
data = DapiDOReadback64(handle, 0);
DapiDOSetBit32
This command can be used to switch outputs specifically to 1 without changing the states of the neighboring outputs.
Description
This command can be used to switch outputs specifically to 1 without changing the states of the neighboring outputs.
Definition
void DapiDOSetBit32(uint handle, uint ch, uint data);
Parameter
handle = This is the handle of an open module
ch = Specifies the number of the output from which to write
data = Specifies the data value to be written (up to 32 bits)
Return value
None
Remark
Only the bits with a value of 1 in the data parameter are taken into account by the command.
Programming example
data = 0x1; // Output 0 would be changed to 1. The states of outputs 1-31 won't be changed
DapiDOSetBit32(handle, 0, data);
data = 0xf; // Outputs 0-3 would be changed to 1. The states of outputs 4-31 won't be changed
DapiDOSetBit32(handle, 0, data);
data = 0xff; // Outputs 0-7 would be changed to 1. The states of outputs 8-31 won't be changed
DapiDOSetBit32(handle, 0, data);
data = 0xff000000; // Outputs 23-31 would be changed to 1. The states of outputs 0-21 won't be changed
DapiDOSetBit32(handle, 0, data);
DapiDOClrBit32
This command can be used to switch outputs specifically to 0 without changing the states of the neighboring outputs.
Description
This command can be used to switch outputs specifically to 0 without changing the states of the neighboring outputs.
Definition
void DapiDOClrBit32(uint handle, uint ch, uint data);
Parameter
handle = This is the handle of an open module
ch = Specifies the number of the output from which to write
data = Specifies the data value to be written (up to 32 bits)
Return value
None
Remark
Only the bits with a value of 1 in the data parameter are taken into account by the command.
Programming example
data = 0x1; // Output 0 would be changed to 0. The states of outputs 1-31 won't be changed
DapiDOSetBit32(handle, 0, data);
data = 0xf; // Outputs 0-3 would be changed to 0. The states of outputs 4-31 won't be changed
DapiDOSetBit32(handle, 0, data);
data = 0xff; // Outputs 0-7 would be changed to 0. The states of outputs 8-31 won't be changed
DapiDOSetBit32(handle, 0, data);
data = 0xff000000; // Outputs 23-31 would be changed to 0. The states of outputs 0-21 won't be changed
DapiDOSetBit32(handle, 0, data);
DapiDOSet1_WithTimer
This function sets a digital output (ch) to a value (data - 0 or 1) for a specific time in ms.
Description
This function sets a digital output (ch) to a value (data - 0 or 1) for a specific time in ms.
Definition
void DapiDOSet1_WithTimer(ULONG handle, ULONG ch, ULONG data, ULONG time_ms);
Parameter
handle=This is the handle of an open module
ch=Indicates the number of the output to be set (0 .. )
data=Indicates the data value to be written (0 / 1)
time_ms=Indicates the time in which the output is set [ms].
Return value
None
Remark
This command is supported by all output modules of the NET series, as well as by our RO-O8-R8 module.
This command loses its validity if it is overwritten with other values.
If you want to deactivate the command, it must be overwritten with time_ms=0.
Programming example
DapiDOSet1_WithTimer(handle, 2, 1, 1000);
//Setting channel 2 for 1000msec to 1
Timeout protection function
DapiSpecialCMDTimeout
This command is used to set the timeout protection function.
Description
This command is used to set the timeout protection function.
There are three different timeout methods since 2021.
"normal" timeout
This is the timeout that our modules have had since 2009.
Procedure for the timeout command:
The timeout is activated by command.
If a so-called timeout event then occurs (pause between two accesses to the module is longer than the permitted timeout time), the following happens:
- All outputs are switched off.
- The timeout status changes to "2".
- The timeout LED goes on (for modules that have such a status)
Further access to the outputs is then still possible, but the timeout is no longer active. Only when it has been reactivated.
"auto reactivate" timeout
This is a timeout mode implemented since 2021, which automatically reactivates the timeout after the timeout event occurs.
Procedure for the timeout command:
The timeout is activated by command.
If a so-called timeout event then occurs (pause between two accesses to the module is greater than the permitted timeout time), the following happens:
- All outputs are switched off.
- The timeout status changes to "4".
- The timeout LED goes on (for modules that have such a status)
Further access to the outputs is then still possible. AND the timeout is still active. If the timeout time is exceeded again, the outputs are switched off again.
"secure outputs" timeout
This is a timeout mode implemented since 2021, which prevents write access to the outputs after the timeout event occurs, thus ensuring that the software must first restore a "secure" state of the outputs, as the module's timeout mechanism has changed the outputs to predefined values.
Procedure for the timeout command:
The timeout is activated by command.
If a so-called timeout event then occurs (pause between two accesses to the module is longer than the permitted timeout time), the following happens:
- All outputs are switched off.
- The timeout status changes to "6".
- The timeout LED goes on (for modules that have such a status)
Further access to the outputs is NOT possible. The outputs can only be written to after the timeout has been reactivated or deactivated.
Definition
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_TIMEOUT, cmd, par1, par2);
Parameter
handle = This is the handle of an open module
cmd = function to be executed
par1 = value that is passed to the function
par2 = Value that is passed to the function
DapiSpecialTimeoutSetValueSec
This command is used to set the timeout time.
Description
This command is used to set the timeout time.
Definition
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_TIMEOUT, cmd, par1, par2);
Parameter
cmd = DAPI_SPECIAL_TIMEOUT_SET_VALUE_SEC
par1 = seconds [s]
par2 = milliseconds [100ms] (value 6 = 600ms)
Remark
The permissible value range of the time specification is between 0.1 seconds and 6553 seconds
Programming example
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_TIMEOUT,
DAPI_SPECIAL_TIMEOUT_SET_VALUE_SEC, 3, 7);
//The timeout time is set to 3.7 sec.
DapiSpecialTimeoutActivate
This command activates the "normal" timeout.
Description
This command activates the "normal" timeout.
After the timeout event...
- ...all outputs are switched off
- ...the timeout status is set to "2"
- ...the timeout LED is switched on (for modules that have such a status)
Further access to the outputs is then still possible, but the timeout is no longer active.
Only when it has been reactivated.
Definition
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_TIMEOUT, cmd, 0, 0);
Parameter
cmd = DAPI_SPECIAL_TIMEOUT_ACTIVATE
Programming example
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_TIMEOUT,
DAPI_SPECIAL_TIMEOUT_ACTIVATE, 0, 0);
//The "normal" timeout is activated.
DapiSpecialTimeoutActivateAutoReactivate
This command activates the "auto reactivate" timeout.
Description
This command activates the "auto reactivate" timeout.
In this mode, the timeout is automatically reactivated after the timeout event.
After the timeout event...
- ...all outputs are switched off
- ..the timeout status is set to "4"
- ...the timeout LED is switched on (for modules that have such a status)
Further access to the outputs is then still possible AND the timeout is still active.
If the timeout time is exceeded again, the outputs are switched off again.
Definition
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_TIMEOUT, cmd, 0, 0);
Parameter
cmd = DAPI_SPECIAL_TIMEOUT_ACTIVATE_AUTO_REACTIVATE
Programming example
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_TIMEOUT,
DAPI_SPECIAL_TIMEOUT_ACTIVATE_AUTO_REACTIVATE, 0, 0);
//The "auto reactivate" timeout is activated.
DapiSpecialTimeoutActivateSecureOutputs
This command activates the "secure outputs" timeout.
Description
This command activates the "secure outputs" timeout.
In this mode, write access to the outputs is prevented after a timeout event.
This ensures that the software must first restore a "secure" state of the outputs,
as the module's timeout mechanism has changed the outputs to predefined values.
After the timeout event...
- ...all outputs are switched off
- ..the timeout status is set to "6"
- ..the timeout LED is switched on (for modules that have such a status)
Further access to the outputs is NOT possible. Only after reactivating the
timeout or deactivating the timeout, the outputs can be written to.
Definition
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_TIMEOUT, cmd, 0, 0);
Parameter
cmd = DAPI_SPECIAL_TIMEOUT_ACTIVATE_SECURE_OUTPUTS
Programming example
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_TIMEOUT,
DAPI_SPECIAL_TIMEOUT_ACTIVATE_SECURE_OUTPUTS, 0, 0);
//The "secure outputs" timeout is activated.
DapiSpecialTimeoutDeactivate
This command deactivates the timeout.
Description
This command deactivates the timeout.
Definition
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_TIMEOUT, cmd, 0, 0);
Parameter
cmd = DAPI_SPECIAL_TIMEOUT_DEACTIVATE
Programming example
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_TIMEOUT,
DAPI_SPECIAL_TIMEOUT_DEACTIVATE, 0, 0);
//The timeout is deactivated.
DapiSpecialTimeoutGetStatus
This command is used to read out the timeout status.
Description
This command is used to read out the timeout status.
Definition
ULONG DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_TIMEOUT, DAPI_SPECIAL_TIMEOUT_GET_STATUS, 0, 0);
Parameter
cmd = DAPI_SPECIAL_TIMEOUT_GET_STATUS
Return value
Return = 0 (timeout is deactivated)
Values for the "normal" timeout
Return = 1 (timeout "normal" is activated)
Return = 2 (timeout "normal" has taken place)
Values for the "auto reactivate" timeout
Return = 3 ("auto reactivate" timeout is activated)
Return = 4 ("auto reactivate" timeout has occurred once or several times)
Values for the "secure" timeout
Return = 5 ("secure" timeout is activated)
Return = 6 (Timeout "secure" has taken place. Writing to the outputs is prevented in this status)
Programming example
unsigned long status = DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_TIMEOUT,
DAPI_SPECIAL_TIMEOUT_GET_STATUS, 0, 0);
printf("Status = %ul\n", status);
// Query the timeout status with output.
DapiSpecialTimeoutDoValueMaskWRSet32
This command activates relays in the event of a timeout.
Description
This command determines the outputs that are to be set in the event of a timeout.
Definition
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_TIMEOUT, cmd, ch, par2);
Parameter
cmd = DAPI_SPECIAL_TIMEOUT_DO_VALUE_MASK_WR_SET32
ch = Specifies the number of the output from which to write (0, 32, 64, ..)
par2 = [32 Bit] Specifies the outputs which are to be activated in the event of a timeout
Programming example
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_TIMEOUT,
DAPI_SPECIAL_TIMEOUT_DO_VALUE_MASK_WR_SET32, 0, 0xff);
//The first 8 relays are switched on in the event of a timeout.
DapiSpecialTimeoutDoValueMaskRDSet32
This command is used to read out the transferred values.
Description
This command is used to read the transferred values
Definition
ULONG DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_TIMEOUT, cmd, 0, 0);
Parameter
cmd = DAPI_SPECIAL_TIMEOUT_DO_VALUE_MASK_RD_SET32
Return value
[32 bit] Value that is transferred to the SET command
Programming example
unsigned long value = DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_TIMEOUT,
DAPI_SPECIAL_TIMEOUT_DO_VALUE_MASK_RD_SET32, 0, 0);
printf("%0x\n", value);
//The value that was transferred to the SET command is read out and displayed.
DapiSpecialTimeoutDoValueMaskWRClr32
This command deactivates relays in the event of a timeout.
Description
This command determines the outputs that are to be switched off in the event of a timeout.
Definition
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_TIMEOUT, cmd, ch, par2);
Parameter
cmd = DAPI_SPECIAL_TIMEOUT_DO_VALUE_MASK_WR_CLR32
ch = Specifies the number of the output from which to write (0, 32, 64, ..)
par2 = [32 Bit] Specifies the outputs that are to be deactivated in the event of a timeout
Programming example
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_TIMEOUT,
DAPI_SPECIAL_TIMEOUT_DO_VALUE_MASK_WR_CLR32, 0, 0xff);
// The first 8 relays are switched off in the event of a timeout.
DapiSpecialTimeoutDoValueMaskRDClr32
This command is used to read out the transferred values.
Description
This command is used to read out the transferred values.
Definition
LONG DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_TIMEOUT, cmd, 0, 0);
Parameter
cmd = DAPI_SPECIAL_TIMEOUT_DO_VALUE_MASK_RD_CLR32
Return value
[32 bit] Value that is transferred to the CLR command
Programming example
unsigned long value = DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_TIMEOUT,
DAPI_SPECIAL_TIMEOUT_DO_VALUE_MASK_RD_CLR32, 0, 0);
printf("%0x\n", value);
//The value that was transferred to the CLR command is read out and displayed.
DapiSpecialTimeoutDoValueLoadDefault
Resets the SET and CLR values to the original value.
Description
Resets the SET and CLR values to the default value.
(SET value = 0, CLR value = FFFFFFFFFF)
Definition
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_TIMEOUT, cmd, 0, 0);
Parameter
cmd = DAPI_SPECIAL_TIMEOUT_DO_VALUE_LOAD_DEFAULT
Programming example
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_TIMEOUT,
DAPI_SPECIAL_TIMEOUT_DO_VALUE_LOAD_DEFAULT, 0, 0);
//SET and CRL values are set to the default value.
Error handling
DapiGetLastError
This function returns the last error recorded.
Description
This function returns the last recorded error. If an error has occurred, it must be cleared with DapiClearLastError(), otherwise every call to DapiGetLastError() will return the "old" error.
If several modules are to be used, the use of DapiGetLastErrorByHandle() is recommended.
Definition
ULONG DapiGetLastError(void);
Parameter
None
Return value
Error code
0=no error. (see delib_error_codes.h)
Programming example
BOOL IsError()
{
unsigned char msg[500];
unsigned long error_code = DapiGetLastError();
if (error_code != DAPI_ERR_NONE)
{
DapiGetLastErrorText((unsigned char*) msg, sizeof(msg));
printf("Error Code = 0x%x * Message = %s\n", error_code, msg);
DapiClearLastError();
return TRUE;
}
return FALSE;
}
DapiGetLastErrorByHandle
This function returns the last error recorded for a specific module using the handle.
Description
This function returns the last error recorded for a specific module using the handle. If an error has occurred, it must be cleared with DapiClearLastErrorByHandle(), otherwise every call to DapiGetLastErrorByHandle() will return the "old" error.
Definition
ULONG DapiGetLastErrorByHandle(ULONG handle);
Parameter
handle=This is the handle of an open module
Return value
Error code
0=no error. (see delib_error_codes.h)
Programming example
BOOL IsError(ULONG handle)
{
unsigned long error_code = DapiGetLastErrorByHandle(handle);
if (error_code != DAPI_ERR_NONE)
{
printf("Error detected on handle 0x%x - Error Code = 0x%x\n", handle, error_code);
DapiClearLastErrorByHandle(handle);
return TRUE;
}
return FALSE;
}
DapiGetLastErrorText
This function reads out the text of the last error recorded.
Description
This function reads out the text of the last recorded error. If an error has occurred, it must be cleared with DapiClearLastError(), otherwise every call to DapiGetLastErrorText() will return the "old" error.
Definition
ULONG DapiGetLastErrorText(unsigned char * msg, unsigned long msg_length);
Parameter
msg = Buffer for the text to be received
msg_length = Length of the text buffer
Programming example
BOOL IsError()
{
unsigned char msg[500];
unsigned long error_code = DapiGetLastError();
if (error_code != DAPI_ERR_NONE)
{
DapiGetLastErrorText((unsigned char*) msg, sizeof(msg));
printf("Error Code = 0x%x * Message = %s\n", error_code, msg);
DapiClearLastError();
return TRUE;
}
return FALSE;
}
DapiClearLastError
This function deletes the last error that was recorded with DapiGetLastError().
Description
This function deletes the last error that was recorded with DapiGetLastError().
Definition
void DapiClearLastError(void);
Parameter
None
Return value
None
Programming example
BOOL IsError()
{
unsigned char msg[500];
unsigned long error_code = DapiGetLastError();
if (error_code != DAPI_ERR_NONE)
{
DapiGetLastErrorText((unsigned char*) msg, sizeof(msg));
printf("Error Code = 0x%x * Message = %s\n", error_code, msg);
DapiClearLastError();
return TRUE;
}
return FALSE;
}
DapiClearLastErrorByHandle
This function deletes the last error of a specific module (handle) that was recorded with DapiGetLastErrorByHandle().
Description
This function deletes the last error of a specific module (handle) that was registered with DapiGetLastErrorByHandle().
Definition
void DapiClearLastErrorByHandle(ULONG handle);
Parameter
handle=This is the handle of an open module.
Return value
None
Programming example
BOOL IsError(ULONG handle)
{
unsigned long error_code = DapiGetLastErrorByHandle(handle);
if (error_code != DAPI_ERR_NONE)
{
printf("Error detected on handle 0x%x - Error Code = 0x%x\n", handle, error_code);
DapiClearLastErrorByHandle(handle);
return TRUE;
}
return FALSE;
}
Test functions
DapiPing
This command checks the connection to an open module.
Description
This command checks the connection to an open module.
Definition
ULONG DapiPing(ULONG handle, ULONG value);
Parameter
handle=This is the handle of an open module
value=Transferred test value, in the value range of 0-255 (8-bit), to the module
Return value
The test value transferred with "value" must be returned here
Web interface
All DEDITEC products with an Ethernet interface have a graphical web interface that allows you to access the module directly. No apps or additional programs are required for operation other than an Internet browser. You can easily log in to the module from any smartphone, PC, or tablet to manage the device, check status values, or switch outputs.
The integrated user menu allows you to assign a password to prevent unauthorized access to the module. You can also configure network settings and run various services.
The following I/O functions are currently accessible via the web interface:
- Digital inputs: Query statuses, read counters
- Digital outputs: Switch outputs on or off
- Analog inputs: Reading voltage and current values
- Analog outputs: Output voltage and current values
General
The board name of the module can be entered here, which can be used to address the module via DHCP.
The IP protection function prevents the IP address from being read.
Network configuration
All network settings for the module can be configured directly in the "Network configuration" menu.
User management
In the "User management" menu, you can set the login details for accessing the web interface.
Using the "Session valid time" entry, you can specify the period of inactivity after which the user should be automatically logged out.
Status / Reboot
In the "Status / Reboot" menu, you can check the currently installed firmware version, reset the module to factory settings, and perform a restart.
Digital Inputs
The image shows a list of the first 16 digital inputs (CH0 ... CH15) of the module. Depending on the module variant, the next 16 inputs can be displayed via a drop-down menu.
The "State" column indicates whether the signal state at the respective input is high (ON) or low (OFF).
The counted pulses can be read via the "Counter Value." The counter reading is reset to 0 after each hard reset.
Digital Outputs
The image shows a list of the first 16 digital outputs (CH0 ... CH15) of the module. Depending on the module variant, the next 16 outputs can be displayed via a drop-down menu.
An on/off button allows the outputs to be switched on or off individually or all together.
The actual switching status of the outputs can be read back via the "Readback" column.
Analog Inputs
The desired operating mode can be set using the “A/D Mode” drop-down menu.
Analog Outputs
The desired D/A mode is selected via a drop-down menu.
The desired current or voltage value is then entered manually in the "Value" field and written to the outputs via the "SET" button.
The "Readback" column shows the current voltage or current output of the D/A converter.
I/O-Control APP for Android™
Features:
- Separate storage of network settings for private and public networks
- Better clarity thanks to configurable I/O names
- Configurable refresh of all I/Os
The following I/Os are supported:
- up to 128 analog inputs (0..10V, 0..5V, +/- 10V, and +/- 5V)
- up to 64 analog outputs (0..10V, 0..5V, +/- 10V, and +/- 5V)
- up to 128 digital inputs and outputs
Network settings
Module configuration
You can also select which I/Os are to be controlled here.
Digital inputs
The digital inputs are polled at an adjustable interval.
Digital outputs
In the digital outputs section, the channels can be switched on or off individually. It is also possible to switch all channels on or off.
Analog inputs
For the analog inputs, you can choose from the measuring ranges 0..10V, 0..5V, +/- 10V, or +/- 5V. The A/D channels are queried automatically at a configurable interval.
Analog outputs
Here you can set analog outputs in the measuring range 0..10V, 0..5V, +/- 10V, or +/- 5V.
Settings
This image shows the settings for analog outputs. Here, each channel can be given a name.
In addition, you can specify here whether and at what intervals the analog outputs are read back.
These settings are available for all I/Os.
Connection example relay:
Manual
Manual WEU-OPTOIN-8 / WEU-RELAIS-8
Quickstart - Hardware description - Software description - ICT-Tool
- Safety instructions
- Installing the drivers
- Connecting the power supply
- Connecting to the PC or network
- Function test
Hardware description
- List of technical data
- Definition of the LEDs
- Functions of switches and buttons
- Pin assignment of the connectors
- Connection examples
Software description
- Control options via the DELIB, protocol level, DELIB CLI, graphical applications
- DELIB Driver Library, DELIB Sample Sources, DELIB for Linux
- Web interface (only for Ethernet modules)
- DELIB API and its functions
ICT-Tool
- Add module on the PC
- Configure module/interface (Ethernet, USB, CAN, serial)
- Setting options for M2M and event control (only for supported modules)
- Test and diagnose module
- Install firmware updates
- Save/load module configurations using a separate file
Software packages ICT-Tool / DELIB driver library
ICT-Tool + DELIB for Windows (64-bit)
For Windows 11/10, Windows 7, Windows 8, Vista, XP and 2000
Software package for the 64-bit version of the ICT-Tool and the DELIB driver library.
The following operating systems are compatible:
64-bit:
- Windows 10/11 x64
- Windows 8 x64
- Windows 7 x64
- Windows Server 2012 x64
- Windows Server 2008 x64
- Windows Vista x64
- Windows XP x64
- Windows Server 2003 x64
- Windows 2000 x64
Supplied software
ICT-Tool x64
- Updating the DEDITEC module-firmware
- Assigning module addresses
- Module-specific settings
- Configuration of CAN modules
- Test and diagnosis of module functions
- Configuration of the watchdog stick
Replaces the following software
- DT-Flasher x64
- DELIB Module Demo x64
- CAN Configuration Utility x64
- DELIB Module Config x64
- DELIB Configuration Utility x64
- Watchdog Configuration Utility x64
DELIB Command Line Interface x64
Enables the execution of DELIB commands in the command line.
ICT-Tool + DELIB for Windows (32-bit)
For Windows 11/10, Windows 7, Windows 8, Vista, XP and 2000
Software package for the 32-bit version of the ICT-Tool and the DELIB driver library.
The following operating systems are compatible:
32-bit:
-
-
- Windows 10/11
- Windows 8
- Windows 7
- Windows Server 2012
- Windows Server 2008
- Windows Vista
- Windows XP
- Windows Server 2003
- Windows 2000
-
Supplied software
ICT-Tool x32
-
-
- Updating the DEDITEC module-firmware
- Assigning module addresses
- Module-specific settings
- Configuration of CAN modules
- Test and diagnosis of module functions
- Configuration of the watchdog stick
-
Replaces the following software
-
-
- DT-Flasher
- DELIB Module Demo
- CAN Configuration Utility
- DELIB Module Config
- DELIB Configuration Utility
- Watchdog Configuration Utility
-
Attention:
With this version of the driver library, only 32-bit applications can be created, which can then be executed on 32- and 64-bit systems.
DELIB driver library for Linux (32/64-bit)
For 32/64-bit Linux distributions from kernel 2.6.x. Version 2.73 from 28.10.2024
DELIB driver library for Linux distributions (32/64-bit) from kernel 2.6.x
This driver package contains the following components
- DELIB USB driver
- DELIB Ethernet driver
- DELIB CLI
DELIB USB driver
Support for the following products:
- NET series (via USB interface)
- RO-USB series
- BS-USB series
- USB mini-sticks
- USB watchdog
- USB-OPTION-8 / USB-RELAY-8
- USB-TTL-32 / USB-TTL-64
Note:
With the standard version of the USB driver, several USB products with different module IDs (e.g. one RO-USB and one USB-OPTOIN-8) can be addressed. No further driver installation is required.
If several USB products with the same module ID (e.g. a USB-OPTOIN-8 and a USB-RELAIS-8) are to be addressed, the Linux FTDI driver must also be installed. You can find the FTDI driver at http://www.ftdichip.com.
DELIB Ethernet driver
Support for the following products:
- NET series (via Ethernet interface)
- RO-ETH series
- RO-ETH/LC series
- BS-ETH series
- ETH-OPTION-8 / ETH-RELAY-8
- ETH-TTL-64
DELIB CLI
With the DELIB CLI (Command Line Interface) for Linux, all commands for digital and analog I/Os can be set directly via the command line
Manual
Manual for ICT-Tool and DELIB
Software Description - ICT-Tool - DELIB API Reference
Software Description
- Control options via DELIB, protocol level, DELIB CLI, graphical applications
- DELIB driver library, DELIB sample sources, DELIB for Linux
- Web interface (only for Ethernet modules)
- DELIB API and its functions
ICT-Tool
- Add module to PC
- Configure module/interface (Ethernet, USB, CAN, Serial)
- Settings for M2M and Event Control (only for supported modules)
- Test and diagnose module
- Install firmware updates
- Save/load module configurations using a separate file
DELIB API Reference
- Directory structure of DELIB
- Management functions
- Error handling
- Manage digital inputs and outputs
- Manage analog inputs and outputs
- Manage software FIFO
- Manage output timeout
- Register read and write commands
Download
Hardware updates (firmware flash file package)
Firmware flash file package for the ICT tool
This package contains the latest firmware files for the following product series:
- STARTER series
- BS series
- RO series
- NET series
- UC series
- CAN-IO-Box
- Development accessories
The firmware flash file package can alternatively be downloaded via the ICT tool.
USB cable A plug to B plug
USB cable for connecting our modules to the control PC.
- Type: USB 2.0, A plug to B plug
- Length: 1,8 m
2-pin plug connector
Enables the power supply to be connected to the DEDITEC module.
- Type: Phoenix Contact® - 1783287
- 100 % mismatch protected
- For all conductor types from 0.2 mm² to 2.5 mm²
8-pin connector black
Required for connecting inputs and outputs of the DEDITEC module.
- Type: Weidmüller® - 1950640000
- 100 % mismatch protected
- For all conductor types from 0.2 mm² to 4 mm²
USB cable A plug to B plug
USB cable for connecting our modules to the control PC.
- Type: USB 2.0, A plug to B plug
- Length: 1,8 m
2-pin plug connector
Enables the power supply to be connected to the DEDITEC module.
- Type: Phoenix Contact® - 1783287
- 100 % mismatch protected
- For all conductor types from 0.2 mm² to 2.5 mm²
8-pin connector black
Required for connecting inputs and outputs of the DEDITEC module.
- Type: Weidmüller® - 1950640000
- 100 % mismatch protected
- For all conductor types from 0.2 mm² to 4 mm²
Top hat rail
Top-hat rail for mounting our control technology modules.
- DIN rail according to DIN EN 50022
- Type: Phoenix Contact® - 1208131
- Dimensions in mm: 450 x 35 x 7.5 (L x W x H)
24V/2A power supply unit for top-hat rail mounting
The DR-4524 from Mean Well is a 48W power supply unit for DIN rail mounting for industrial applications. It offers protection against short circuit, overload, overvoltage and overheating.
- Input voltage range: 85 V.. 264 V AC / 120 V DC ... 370 V DC
- Output voltage: 24 V DC
- Output current: 2 A
- Rated power: 48 W
12 V top-hat rail relay
PLC interface for limit continuous currents up to 10 A, consisting of basic terminal with screw connection and plug-in miniature relay. Can be mounted on NS 35/7.5 mounting rail.
- Rated voltage: 230 V AC / 220 V DC
- Switching voltage: 250 V AC / DC
- 1 Changer
- Reverse polarity protection, freewheeling diode
- LED for voltage display
- Type: Phoenix Contact® - 2967617, PLC-RSC- 12DC/21HC
24 V top-hat rail relay
PLC interface for limit continuous currents up to 10 A, consisting of basic terminal with screw connection and plug-in miniature relay. Can be mounted on NS 35/7.5 mounting rail.
- Rated voltage: 24 V AC/DC
- Switching voltage: 250 V AC/DC
- 1 Changer
- Reverse polarity protection, freewheeling diode
- LED for voltage display
- Type: Phoenix Contact® - 2967633, PLC-RSC- 24UC/21HC
You might also like …
-
WEU-OPTOIN-8 (Modbus TCP-compatible) – DEDITEC
€ 171,96 Incl. 19% VAT plus shipping View Product -
CAN-BOX Automotive I/O Box analog & digital – DEDITEC
Price range: € 238,00 through € 273,70 Incl. 19% VAT plus shipping View Product -
8 * Query optocoupler inputs via the USB bus – DEDITEC
€ 124,95 Incl. 19% VAT plus shipping View Product
Install the installation program and check the module functions.




















Reviews