User Account 1 1
Cart 0  0,00

NET-DEV module with 16 relay outputs (3A/5A)

Price range: € 379,61 through € 415,31 Incl. 19% VAT plus shipping

SKU: NET-DEV-REL16_3/5A Category:

Our promise to you

The NET-DEV-REL16_5A module has 16 digital outputs and a switching capacity of 5A. It serves as an expansion option for the NET-CPU base modules and is integrated into an existing NET system using a plug’n play connector (DIN rail bus).

  • 16 relay outputs (NO)
  • Max. switching voltage: 48V AC / DC
  • Max. switching current: 5A AC / DC
  • Timer function
  • Timeout protection

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.

Icon Digital Out

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.

Icon Fail Safe

Plug connector

A screwless system from the manufacturer WAGO® Kontakttechnik is used as the connector. The 1-wire female connectors are 100 % protected against mismating and have an ejection and locking mechanism.

Icon Steckverbindung 12er

Easy installation thanks to DIN rail bus

Thanks to the practical NET bus connector, which is clipped into the DIN rail, individual modules of a system can be added or replaced very easily. This Plug'n Play principle makes commissioning easier for you and eliminates the need for tedious wiring.


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.

Icon LED

General information

Power supply Internal, via the DIN rail bus
LEDs
  • Internal bus communication
  • Module status
  • One LED per input or output channel
Fail-safe function
(only for outputs)
Automatic switching on and off of the outputs within a freely definable period of time
DIN Rail-Bus NET bus plug connector for connection to other NET modules
DIN rail mounting 35 x 7,5 mm
Operating temperature +10 °C ... +50 °C

Special features

Event-Control With our event control, you have the option of linking occurring events to a specific action. With the help of our ICT tool, the control tasks can be stored directly in the module memory thanks to an intuitive “if-then” logic. Monitor, control and regulate without an additional control PC.
FIFO-function The built-in FIFO-function makes it possible to carry out continuous measurements with the module. The measurement data is first stored temporarily on the module and can then be transferred to the measuring PC at a more constant sampling rate via the Ethernet interface.

Fail-Safe-function

FAIL-SAFE-function
  • Simple and uncomplicated setting of the timeout protection function possible via software
  • Time-definable automatic activation of the timeout protection function in the event of a timeout (between 0.1 seconds and 6553 seconds)
  • In the event of a timeout, digital outputs can be activated, deactivated or left unchanged
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.


Inputs/Outputs

Digital outputs (relay)

Relay 3 A
  • Type: PCN105D3MHZ
  • Type: Normally open contact (NO)
  • Max. Switching voltage: 48 V AC / DC
  • Max. Max. switching current: 3 A AC / DC
  • Max. Transport current 3 A AC / DC
  • Max. Switching power: 90 W
  • Galvanic isolation between contact and coil: 3 kV RMS /1 min

Digital outputs (relay)

Relay 5 A
  • Type: PCN105D3MHZ001B
  • Type: normally open contact (NO)
  • Max. Switching voltage: 48 V AC / DC
  • Max. Switching current: 5 A AC / DC
  • Max. Switching power: 150 W
  • Galvanic isolation between contact and coil: 3 kV RMS /1 min


Connectors

Plug connector 16-pin
  • Type: Wago contact technology 713-1108/037-000
  • Pluggable female connector with locking mechanism
  • 100 % protected against mismating
  • 1-wire connection for all conductor types up to 1.5 mm²

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

  1. Read / Write symbol:   Flashes to indicate an active connection to the module
  2. Automatic access: Removing the tick triggers a timeout after the timeout time has expired
  3. Manual access: Manual retrieval of data from the module
  4. Timeout status: Shows whether the timeout is active and whether a timeout event has occurred
  5. Timeout mode: Selection between 3 timeout modes, Normal, Reactivate and Secure
  6. Timeout duration: The time after which the timeout should be triggered is set here
  7. 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

  1. Go to Flash Files in the “Firmware update” menu
  2. Click on the download button to start the download.
  3. 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

  1. Download the required firmware flash file package from our homepage: Downloads -> Software -> Firmware
  2. 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.

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:

 

  1. Activation via DIP switch
  2. Activation via the network search function in the “Edit / Add menu” of the ICT-Tool
  3. Activation via the “Module configuration menu” of the ICT-Tool
  4. 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:

 

  1. Configuration via the network search function in the “Edit / Add menu” of the ICT-Tool
  2. Configuration via the “Module configuration menu” of the ICT-Tool
  3. 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:

  1. Activate WPS mode on the module (press the CFG button for 7-12 seconds)
  2. Press the WPS button on the router within 2 minutes*.
  3. 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.

Configuration of CAN modules

The parameters of the CAN interface can be fully configured via the ICT-Tool. In addition to the baud rate, CAN address and other settings, automatic send and receive packets can also be set up.

Icon Can

Automatic transmission (TX mode)

The Auto-TX mode allows cyclical transmission of data packets, optionally with analog or digital input states to other CAN addresses. Alternatively, a trigger event can also be defined. In this case, a data packet is only sent once a data packet has been received on a certain CAN ID (e.g. CAN sync on ID 0x80).

 

Automatic receiving (RX mode)

With Auto-RX mode, on the other hand, received data packets are forwarded directly to analog or digital outputs. For example, relay outputs can be set via another CAN bus subscriber.

ICT-Tool

The ICT-Tool can be used to quickly and easily read out or change CAN interface settings.

Status interface
Here you can find information about the status of the CAN interface

  • Baud rate
  • Module address
  • Receiving address
  • CAN status
  • Extended ID
  • CAN modus
FormCfgCANStatus
Status TX/RX
Hier finden Sie Informationen über die TX / RX -Pakete
 

  • Anzahl gesendeter / empfangener Pakete
  • TX / RX – Pakete pro Sekunde
  • Durchschnitt gesendeter / empfangener Pakete
FormCfgCANStatistic
Config interface
Settings can be made on the CAN interface here.
 

  • Baud rate
  • Adress Bit-mode
  • Module address
  • Receiver address
FormCfgCANConfigStd
Config I/O Init
Here you can configure the CAN settings of the connected submodules.
 

  • A/D mode
  • A/D filter
  • D/A mode
  • Counter mode
  • Timeout
  • CNT48 mode
  • CNT48 submode
  • CNT48 filter
FormCfgCANConfigIO
Config TX mode
Here you can make settings to the TX package configuration.
 

  • activate / deactivate
  • Trigger mode
  • Interval
  • Use extended ID
  • Send to CAN-ID
  • TX mode
FormCfgCANTX
Config RX mode
You can make settings to the RX package configuration here.
 

  • activate / deactivate
  • Use extended ID
  • Receive from CAN-ID
  • RX mode
FormCfgCANRX
Click here to download the latest driver library.
 
You can find more details on control and some programming examples in the programming section.

Configuration of our serial modules (RS-232 / RS-485)

To configure the serial interface, the module must be connected to the PC either via the Ethernet interface or USB interface.

The module can then be accessed and configured in the ICT tool.

The following parameters can be set:

  • Preferred mode (115k baud, module address = deactivated, echo = off)
  • Baud rate
  • Module address (only for RS-485)
  • Echo active on/off
  • Text mode / Register mode
FormCfgSeriell

Changing the interface standard

Switch between RS-232 and RS-485 (applies only to NET and RO series)

The modules are configured for RS-232 operation as standard when delivered. The module can be switched to RS-485 operation by changing the jumper positions. Further information on this can be found in the manual for the respective product.

Icon Ser

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.

Icon Can

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.

FormCfgCANStatus

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:

FormDiagnoseSetDAWithDelay

M2M

Machine to Machine
M2M is the abbreviation for “machine-to-machine” and enables automatic data transmission between two or more devices. This means that analog or digital input signals from a transmitter module can be automatically transmitted to a receiver module, where they are immediately output again.

Data exchange without a control PC
The modules communicate directly at device level and therefore do not require any additional user software. The one-off configuration of the transmitter module can be carried out very easily using our ICT-Tool. All settings remain permanently stored in the module memory, even in the event of a power failure. After a restart, the module automatically switches back to M2M operation.

M2M Ethernet or M2M CAN
With our DEDITEC products, we differentiate between M2M Ethernet and M2M CAN. We also refer to the latter as CAN-TX/RX mode. Both M2M methods are supported by most of our modules with Ethernet or CAN interface.

Overview M2M

M2M-Ethernet

To be able to use M2M-Ethernet, the transmitter module must always be equipped with our M2M feature, whereas the receiver module can be any DEDITEC product with an Ethernet interface.

A maximum of 4 receiver modules (destinations) can currently be configured and up to 8 actions defined.

Definition of the receiver module

  • Designation/name of the module
  • Network configuration of the module
  • Timeout time
  • Encryption type and password
FormM2MDestinations

Definition of actions

These actions are used to define which analog or digital inputs are to be transmitted to a receiver module.

The following parameters can be defined in an action:

  • Which data should be sent (digital or analog)
  • To which receiver module (destination) should be sent
  • The interval with which the operations are to be performed
  • Start channel of the transmitter module
  • Number of input channels to be transmitted
  • Start channel of the receiver 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.

FormM2MJobs

M2M-CAN

All DEDITEC products with a CAN interface are equipped with the M2M-CAN feature. The “Auto TX/RX mode” can be set in the ICT-Tool via the configuration menu. Depending on the product type, 8(4) TX and 8(4) RX modes can be defined.

"TX modes" submenu
The pictures on the right show an example configuration for a transmitter module (TX mode) and a corresponding receiver module (RX mode).

The TX mode on the transmitter module sends the logical states of inputs 1-64 to CAN ID 0x700 every 500ms.

The RX mode on the receiver module receives data packets on CAN ID 0x700 and outputs these values to outputs 1-64.

M2M CAN TX
M2M CAN RX

Software FIFO

Data processing in real time
In order to be able to process data streams constantly and at short intervals, external interference factors such as network utilization or large spatial distances must be avoided. As this is often not possible in practice, it is necessary to record the data first and store it temporarily in a buffer.

In our NET series modules, we have therefore integrated a software FIFO ("First in-First out"), which stores the required data directly on the module and then processes it independently at a defined time interval. This happens both for incoming data (FIFO-IN) and for outgoing data (FIFO-OUT). The FIFO buffer significantly improves the processes in our measurement procedures and reduces network utilization.

All the advantages at a glance:

  • Analog and digital values can be read out at very short intervals (milliseconds)
  • Exact readout of values in a self-defined time interval possible
  • The FIFO does not consume more traffic at higher utilization via the Ethernet interface
FormDiagnoseFifoInOut

Testing and programming
You can use our ICT tool to test and diagnose the FIFO-IN and FIFO-OUT with digital and analog I/Os.
You will also find support and help for correct programming in the source code of our FIFO sample programs.

FormIOGraph AD

General information on Event-Control

In den folgenden Kapitel, würden wir Ihnen unsere neue All-In-One-Software gerne genauer vorstellen.

To make our modules even more customer-friendly and flexible and to make it easier for you to enter the world of automated control technology, we have implemented Event-Control as a new feature in our products. This function can be used to implement small control tasks that are stored in the module. These control tasks are configured as events and actions and then executed automatically according to the “if-then” principle.

Configuration in the ICT-Tool
The ICT-Tool can be used to configure and monitor 16 events and 16 actions.

Processing in the module
The events stored in the module are automatically monitored and processed by the CPU in the module after the module is started. As soon as the set condition (“event”) is fulfilled, the corresponding action is executed. This automatism in the module makes an additional control PC with associated user software superfluous.

Functions
The following actions, among others, can be combined with the Event-Control:

  • Monitoring the analog and digital inputs (A/D, DI)
  • Setting switching thresholds for analog inputs
  • Switching the module outputs (relay, MOSFET, D/A)
  • Sending CAN packages

We are constantly expanding the range of promotional options. We are also happy to implement your special customer requirements on request.

Modulauswahl
Hier können Sie Ihre Module mit einem Klick auf das „+“ Symbol ins ICT-Tool einbinden, um diese anschließend konfigurieren oder testen zu können.

Module series that support this function:

  • BS-USB2 series
  • BS-WEU series
  • NET series
  • UC series
  • CAN-Box series

Module series that do not support this function:

  • Starter series
  • RO series
  • COS series

ICT Treeview
Im Treeview auf der linken Seite des Programmfensters, sehen Sie die jeweiligen Formen, die von Ihrem Modul unterstützt werden.
Mit einem Klick können Sie sich diese Form dann im rechten Teil des Programmes anzeigen lassen und mögliche Konfigurationen oder Tests durchführen.

In den folgenden Kapitel, würden wir Ihnen unsere neue All-In-One-Software gerne genauer vorstellen.

With the Event-Control module, you can react flexibly and automatically to external signals – directly on the I/O module, without a PC or additional controller.

How does it work?
The system registers external events, such as the switching of an input or the triggering of a sensor, and then executes predefined actions. These actions can be simple tasks such as switching on a relay or sending a CAN message.

The advantages:

  • Independent processing – Control takes place directly on the module, independently of the host system.

  • Flexibly customizable – you can link any inputs and outputs together.

  • Complex logic possible – Thanks to logical operators such as AND, OR or NOT, even more sophisticated controls can be implemented.

  • Simple configuration – events and actions are conveniently defined via our ICT-Tool and transferred to the module without any programming knowledge.

Example:
A digital input detects the opening of a door. The system then automatically switches on a light without a PC being involved.

Modulauswahl
Hier können Sie Ihre Module mit einem Klick auf das „+“ Symbol ins ICT-Tool einbinden, um diese anschließend konfigurieren oder testen zu können.

Modulserien, die von dieser Funktion unterstützt werden:

  • BS-USB2-Serie
  • BS-WEU-Serie
  • NET-Serie
  • UC-Serie
  • CAN-Box

Modulserien, die von dieser Funktion nicht unterstützt werden:

  • Starter-Serie
  • RO-Serie
  • COS-Serie

ICT Treeview
Im Treeview auf der linken Seite des Programmfensters, sehen Sie die jeweiligen Formen, die von Ihrem Modul unterstützt werden.
Mit einem Klick können Sie sich diese Form dann im rechten Teil des Programmes anzeigen lassen und mögliche Konfigurationen oder Tests durchführen.

Our ICT-Tool in the “Statistics” section provides a quick overview of all current campaigns and events.

Eine mini SPS
Um unsere Module noch kundenfreundlicher und flexibler zu gestalten und Ihnen den Einstieg in die Welt der automatisierten Steuer- und Regelungstechnik zu erleichtern, haben wir als neues Feature das sog. Event-Control in unsere Produkte implementiert. Mit dieser Funktion lassen sich kleine Steueraufgaben in das Modul speichern, die anschließend nach dem „Wenn-Dann“ Prinzip automatisch Aktionen ausführen.

The following information can be taken from the statistics:

  • Executed event no.
  • Event mode
  • Interval
  • Number of events executed
  • Number of the executed action
  • Number of actions performed

Modulserien, die von dieser Funktion unterstützt werden:

  • BS-USB2-Serie
  • BS-WEU-Serie
  • NET-Serie
  • UC-Serie
  • CAN-Box

Modulserien, die von dieser Funktion nicht unterstützt werden:

  • Starter-Serie
  • RO-Serie
  • COS-Serie

ICT Treeview
Im Treeview auf der linken Seite des Programmfensters, sehen Sie die jeweiligen Formen, die von Ihrem Modul unterstützt werden.
Mit einem Klick können Sie sich diese Form dann im rechten Teil des Programmes anzeigen lassen und mögliche Konfigurationen oder Tests durchführen.

An event is used to execute a specific action as soon as a condition is met.
A time period can also be specified for how long the condition must be fulfilled in order to execute an action.
These settings are saved directly in the Module-Configuration-Memory of the module.
Example: Voltages can be automatically output via the D/A converter or relays can be switched when a previously defined switching threshold is reached at the A/D inputs or a signal is detected at a digital input.

Depending on the features of your product, you can choose from different modes:

“DI” / “DI flip-flop” / “DO readback”
DI: High or low signal of a digital input.
Flip-Flop: If the status of the digital input changes, the flip-flop of the channel is set and then reset again.
DO-Readback: The status of the output channel is read out.

The following settings can be made:

  • Number of the channel to be monitored
  • Condition of the channel status (on = 1 / off = 0)
  • Minimum time to wait until the action is triggered
  • Number of the action to be executed (this is configured in the Action area)

“A/D”
The voltage currently present at the analog input is read out.

The following settings can be made:

  • Number of the channel to be monitored
  • A/D mode (selection depends on module)
  • Condition that must be fulfilled (value greater than … , value less than … , value in a range)
  • Values that must be achieved for the condition
  • Minimum time to wait until the action is triggered
  • Number of the action to be executed (this is configured in the Action area)

In the “Actions” section of our ICT-Tool, you define which tasks are to be performed automatically as soon as a condition (“event”) is fulfilled.
For example, you can specify that a certain CAN packet should be sent when a certain voltage is measured on an A/D channel or a signal is detected at a digital input.

Depending on the features of your product, you can choose from different modes:

Folgende Informationen können der Statistik entnommen werden:

  • Ausgeführte Event-Nr.
  • Event-Modus
  • Intervall
  • Anzahl ausgeführter Events
  • Nummer der ausgeführten Aktion
  • Anzahl ausgeführter Aktionen

“Set D/A output”
Outputs a voltage or a current at an analog output.

The following settings can be made:

  • Number of the channel on which the action is to be executed
  • D/A mode (selection depends on module)
  • Voltage or current to be output
  • Time to wait before executing the action again

“Set DO output”
Switches a digital output on or off.

The following settings can be made:

  • Number of the channel to be controlled
  • State (0 = off / 1 = on) that is to be set
  • Time to wait before executing the action again

“Send CAN package”
The set CAN TX event is triggered. For this function, the trigger mode in the CAN TX package must be set to “TX-EVENT” (see configuration).

The following settings can be made:

  • Number of the CAN TX event to be triggered
  • Time to wait before executing the action again (prevents a CAN packet from being sent too frequently)

You can find more information on configuring TX mode here:

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:

Logo DeLib

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

The following examples show how to open a module and switch digital outputs.

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:

Overview ICT Tool DE

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);

Icon Usb Plug And Play 600

Control of our CAN modules

Our RAW CAN modules can be controlled in two ways:

1. Auto TX/RX mode

2. DELIB command mode

 

 

Icon Can

1. Auto TX / RX mode

This operating mode allows the module to process CAN packets automatically without the need for an additional control PC. Configuration is very simple using the ICT tool and requires no programming knowledge.

 

 

Automatic transmission (TX mode)

Auto-TX mode allows automatic, cyclical transmission of CAN packets to other bus participants. The module's digital and analog input signals can thus be forwarded directly to other devices.

As an alternative to cyclic transmission, trigger events can also be defined. This means that a CAN packet is only sent, for example, when a CAN message has been received on a specific CAN ID.

 

 

TX mode configuration

The following settings can be configured:

  • Enable/disable TX mode
  • Trigger mode
  • Interval
  • Use extended ID
  • Send to CAN ID
  • TX mode

 

 

 

FormCfgCANTX

Automatic receive (RX mode)

In Auto-RX mode, received data packets are forwarded directly to the analog or digital outputs of the module. For example, relay outputs can be set on the module via another CAN bus participant.

 

 

 

RX mode configuration
The following settings can be configured:

 

  • Enable/disable RX mode
  • Use extended ID
  • Receive from CAN ID
  • RX mode
FormCfgCANRX

2. DELIB command mode

In DELIB command mode, the module's registers are accessed via a CAN protocol developed by DEDITEC. The module expects the CAN messages on a CAN address specified in command mode. Read and write accesses with different data lengths (BYTE, WORD, LONG) are possible. Details on the protocol structure and register assignment can be found in the “Protocols & Register Assignment” manual in the download area.

 

Control of our RS-232 / RS-485 modules

There are two options available for controlling our RS-232 / RS-485 modules:

1. Register-based via an open protocol

2. Via plain text input via a terminal program

Please note!
We only recommend using the RS-485 interface in conjunction with a microcontroller and your own serial protocol.

Icon Ser

1. Control via our open serial protocol

Serial control is register-based. An open communication protocol was 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 RS-232/RS-485 modules.

2. Control via plain text using HyperTerminal

The digital inputs and outputs can be controlled or read directly via “plain text” using HyperTerminal. Examples of this can be seen in the adjacent illustration.

Snapshot Ro Ser Hyperterminal

Management functions

Icon Delib Command

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

Icon Delib Command

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

Icon Delib Command

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

Icon Delib Command

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

Icon Delib Command

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

Icon Delib Command

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 Ethernet modules feature a web interface that allows you to conveniently configure settings via your web browser and also provides direct access to the I/Os.
This means you can access the product using a smartphone, tablet, or PC via a browser.
The following I/O units are supported:

  • Digital inputs
  • Digital inputs (counter function)
  • Digital outputs
  • Analog inputs (voltage & current)
  • Analog outputs (voltage & current)
  • PT100 temperature measurement
  • stepper motor control

With a user system and optional encryption system, you can protect the Ethernet module against unauthorized access.

General

Home page of the web interface. The navigation bar on the left-hand side gives you access to various settings options.

01 Ethernet Lc Config General 615 464 Kopie

Network configuration

All network settings can be configured directly via the web interface..

02 Ethernet Lc Config Network 615 464 Kopie

Usermanager

Here, you can specify the user name and password for accessing the web interface. If the user is inactive, they will be automatically logged out after the session time expires.

03 Ethernet Lc Config Usermanager 615 464 Kopie

Status / Reboot

Version of the installed firmware. Functions for restarting and resetting the settings.

04 Ethernet Lc Config Status 615 464 Kopie

Security

In addition to a user/password system for the web interface, we also offer you the option of encrypting all network communication. Access to the I/Os can also be blocked.

05 Ethernet Lc Config Security 615 464 Kopie

Supported I/Os

Below, we show you the supported I/Os that you can operate via the web interface.

Digital Inputs

The image shows an overview of the digital inputs. You can switch between multiple inputs using the drop-down menu. The “State” column shows whether a signal is present at the input.

06 Ethernet Io Digital Inputs 615 464 Kopie

Digital Inputs Counter

Our digital inputs have a counting function. The meter reading can be read and reset via the web interface.

07 Ethernet Io Digital Inputs Counter 615 464 Kopie

Digital Outputs

The digital outputs can be switched using an on/off button. The current status of the outputs can be read back via the “Readback” column.

08 Ethernet Io Digital Output 615 464 Kopie

Analog Inputs

Current and voltage can also be read via the web interface. The desired operating mode can be set via the A/D Mode drop-down menu.

09 Ethernet Io Analog Inputs 615 464 Kopie

Analog Outputs

Analog signals can also be output via the web interface. As with the analog inputs, the desired D/A mode can be set using the drop-down menu. The desired value can be written to the outputs using the ‘SET’ button. The ‘Readback’ column shows the current voltage/current output of the D/A converter.

10 Ethernet Io Analog Outputs 615 464 Kopie

Temperature measurement (PT100)

Temperature measurement is supported by our RO series.

PT100

The current temperature can be read. If no sensor is connected to the channel, this is indicated by ‘disconnected’.

11 Ethernet Io Pt100 615 464 Kopie

Stepper-Motor Control

The position and speed of the stepper motor can be set using the control elements. The status window shows the current position, temperature, and power supply.

12 Ethernet Io Stepper 615 464 Kopie

I/O-Control APP for Android™

Control the digital and analog I/Os of our Ethernet modules while on the go. The DEDITEC I/O-Control Android app turns any network-enabled Android device into a remote control for DEDITEC products with an Ethernet interface.

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

In the network settings, you can create and save configurations for private (Wi-Fi) or public (Internet) networks.
01 Snapshot Io Control Network Kopie

Module configuration

The module configuration shows the number of connected I/O modules.
You can also select which I/Os are to be controlled here.
02 Snapshot Io Control Moduleconfig Kopie

Digital inputs

The digital inputs are polled at an adjustable interval.

03 Snapshot Io Control Di Kopie

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.

04 Snapshot Io Control Do Kopie

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.

05 Snapshot Io Control Ai Kopie

Analog outputs

Here you can set analog outputs in the measuring range 0..10V, 0..5V, +/- 10V, or +/- 5V.

06 Snapshot Io Control Ao Kopie

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.

07 Snapshot Io Control Settings Kopie

Connection example relay:

Connection example

Screwless connector system

The customer-side connection wiring of the inputs and outputs is carried out using screwless, pluggable terminal strips. The conductor connection is made using a so-called actuating tool.
A locking and ejecting mechanism facilitates the insertion and removal of the complete terminal strip.

Handling:

Steps 1-5

Step 1

See the scope of delivery for the operating tool.

Wago Betaetigungswerkzeug 615 464 Kopie
Step 2

Insert the operating tool firmly into the side opening in the direction of the conductor connection.

Konf Werkz Montage2 615 464 Kopie
Step 3

Now insert the stripped conductor into the open clamp contact.

Konf Werkz Montage3 615 464 Kopie
Step 4

Pull out the operating tool again.

Konf Werkz Montage4 615 464 Kopie
Step 5

Check that the conductor is properly connected. It should now no longer be possible to pull it out easily.

Konf Werkz Montage5 615 464 Kopie

Manual

DDT Icons Downloads PDF Transparent 250606

Manual NET series

Quickstart - Hardware description - Software description - ICT-Tool
Commissioning/Quickstart

  • Safety instructions
  • Installing the drivers
  • Connecting the power supply
  • Connecting to the PC or network
  • Connecting the I/O connectors
  • 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

DDT-Icons-Downloads_ZIP_transparent_250606

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.

DDT-Icons-Downloads_ZIP_transparent_250606

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.

DDT-Icons-Downloads_ZIP_transparent_250606

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

DDT Icons Downloads PDF Transparent 250606

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

DDT-Icons-Downloads_ZIP_transparent_250606

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.

16-pin plug connector

Required for connecting inputs and outputs of the DEDITEC module.

  • Type: WAGO® 713-1108/037-000
  • Plug-in female multipoint connector with locking mechanism
  • 100 % mismatch protected
  • 1-wire connection for all conductor types up to 1.5 mm²
ZBH STECK 16 AUSW 600

Actuating tool for Wago connectors

Used to open and close the terminal contacts on the WAGO® connectors.

  • Type: WAGO® - 734-231
Zbh Steck Werkz 600

DIN-Rail connector

The DIN rail connector is a single BUS segment that enables connection to other modules. It is clipped into the top-hat rail and plugged onto the side of an existing DIN rail connector.

  • Type: Phoenix Contact® - 2203852
  • Connection of a NET or UC module
  • For expanding the NET or UC bus system
  • 1 Piece
Din Rail Bus 615 464

16-pin plug connector

Required for connecting inputs and outputs of the DEDITEC module.

  • Type: WAGO® 713-1108/037-000
  • Plug-in female multipoint connector with locking mechanism
  • 100 % mismatch protected
  • 1-wire connection for all conductor types up to 1.5 mm²
ZBH STECK 16 AUSW 600

Actuating tool for Wago connectors

Used to open and close the terminal contacts on the WAGO® connectors.

  • Type: WAGO® - 734-231
Zbh Steck Werkz 600

DIN-Rail connector

The DIN rail connector is a single BUS segment that enables connection to other modules. It is clipped into the top-hat rail and plugged onto the side of an existing DIN rail connector.

  • Type: Phoenix Contact® - 2203852
  • Connection of a NET or UC module
  • For expanding the NET or UC bus system
  • 1 Piece
Din Rail Bus 615 464

Strain relief plate for 16 or 18-pin Wago connectors

The strain relief plate is pushed onto the center of the female connector and enables the connected cables or strands to be fixed in place.

  • Type: WAGO® - 713-127
  • Strain relief for the connection wiring
  • Suitable for 16 or 18-pole female connectors
  • Slide onto the female connector from the side
ZBH STECK PL 16
ZBH STECK PL 16 Wago

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)
Zbhhutschiene 1m 600

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
Zbhphoerelais 24v 600

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
Zbhphoerelais 24v 600

Reviews & Ratings

My cart
Your cart is empty.

Looks like you haven't made a choice yet.