Modbus TCP analog * ethernet 16-bit A/D converter with galvanic isolation – 2 channels
The UC-ETH-AD2-16ISO Modbus TCP analog converter module, featuring 2 galvanically isolated AD channels, acquires voltage and current signals with 16-bit resolution and converts them into digital measurement data. Values can be efficiently integrated into control and IoT systems via Ethernet and Modbus TCP. Ideal for connecting analog sensors in industrial automation or for monitoring energy and process data.
€ 668,78 Incl. 19% VAT plus shipping
Our promise to you
Product Description – Modbus TCP analog module
The DEDITEC Modbus TCP Analog Converter Module (2-channel) is a compact and powerful solution for the precise acquisition of analog measurement values in modern automation environments. Featuring two high-resolution 16-bit input channels for voltages and currents, the module enables the accurate capture of industrial sensor signals. Galvanic isolation ensures maximum operational safety and reliably protects connected systems against interference.
Thanks to its integrated Ethernet interface, the device can be seamlessly integrated into existing networks. In addition to the DEDITEC protocol, the module fully supports the open Modbus TCP standard, enabling vendor-independent integration into PLC, SCADA, and IoT platforms. The intuitive web interface allows for configuration, diagnostics, and live monitoring directly within a browser—without the need for additional software.
With features such as configurable filters, 16-bit counters, watchdog mechanisms, and status LEDs, the module offers robust and reliable data acquisition for demanding applications. Its high accuracy and flexible communication capabilities make it ideal for distributed systems and Industry 4.0 architectures.
Typical areas of application include industrial process monitoring—such as the acquisition of pressure, temperature, or flow signals—as well as building automation, where analog sensors (e.g., level or environmental sensors) are integrated. The Modbus TCP analog module thus provides a future-proof, versatile, and precise solution for professional measurement tasks.
Flexible network communication via Ethernet & Wi-Fi
The Ethernet and WiFi interfaces of the UC-ETH-AD2-16ISO enable flexible integration into existing networks—both wired and wireless. Via Ethernet (10/100 Mbps), the Modbus TCP analog module can be operated with a static or dynamic IP address and accessed directly through standard network protocols, while WiFi allows wireless integration, for example via WPS or manual configuration.
Both communication methods support access through an integrated web interface as well as driver libraries and a mobile app, enabling simple parameterization and remote control. A key feature is the ability to make the Modbus TCP analog module accessible across the entire network and operate it via browser, software tools, or mobile devices.
Overall, Ethernet and WiFi provide scalable and location-independent communication within industrial applications.
Control & software
For control purposes, the Modbus TCP analog module provides open protocols (TCP/IP, Modbus TCP, and HTTP), enabling flexible integration into existing IT and automation environments. These protocols allow both traditional industrial applications and modern IoT scenarios to be implemented directly, without the need for additional gateways or proprietary interfaces.
In addition, comprehensive API libraries are available for C, C++, C#, Java, VB, and other programming languages, enabling the functions of the UC-ETH-AD2-16ISO to be seamlessly integrated into custom software solutions.
The DELIB driver library, including CLI tools, also enables fast and straightforward commissioning as well as direct control via scripts or the command line, which is particularly useful for test, automation, and development environments. Furthermore, the I/O Control App for mobile devices provides a convenient way to remotely control and monitor the system over the network, without requiring a traditional PC application.
Overall, this creates a highly flexible control architecture ranging from low-level integration to mobile operation.
Accurate and interference-resistant analog signal acquisition for industrial applications
The analog inputs of the UC-ETH-AD2-16ISO are designed for precise acquisition of voltage and current signals in industrial applications and provide two independently usable measurement channels. They support common input signals such as ±40 V as well as current signals in the ranges 0–20 mA, 4–20 mA, and 0–24 mA, enabling flexible adaptation to various sensors. The inputs on the Modbus TCP analog module are implemented with high impedance, ensuring that connected signal sources are only minimally loaded and stable measurement values are guaranteed. Due to the high resolution of the conversion, even small signal changes are reliably detected and accurately represented. In addition, galvanic isolation of the input stages provides safe decoupling between the measurement system and the signal source, effectively reducing interference and potential differences. As a result, the analog inputs are particularly well suited for demanding measurement and monitoring tasks in industrial environments.
Event Control – event-based automation
The Event Control function enables direct, event-driven processing of both digital and analog signals in the Modbus TCP analog module, without requiring cyclic polling by higher-level software. Digital signal transitions can immediately trigger internal actions, while analog signals can generate events based on defined thresholds, measurement ranges, or significant value changes. This allows responses to be implemented much faster and more resource-efficiently compared to traditional polling-based processing.
The event logic can be flexibly configured, enabling both simple switching conditions and more complex dependencies between digital and analog signals. In addition, functions such as filtering, hysteresis, and threshold monitoring are available to ensure stable and reliable trigger conditions.
As a result, Event Control is particularly well suited for automation applications where signals must be evaluated intelligently and processed immediately.
Robust industrial design with a well-engineered connection and mounting architecture
The Modbus TCP analog module is housed in a compact DIN rail enclosure specifically designed for control cabinet use, enabling space-saving integration into industrial systems. With a housing width of 22.5 mm, it supports high packing density while still ensuring good accessibility to all connections. For electrical wiring of the UC-ETH-AD2-16ISO, a pluggable WAGO spring-clamp system is used, enabling tool-free and vibration-resistant installation and supporting conductor cross-sections of up to 1.5 mm². In addition, a separate 5-pin connector is provided for the power supply, ensuring a clear separation between signal and operating voltage. The entire connection architecture is designed for misconnection protection and fast maintainability, offering clear advantages during service and commissioning processes. Overall, the design combines a robust mechanical structure with a practical, modular wiring concept for continuous industrial operation.
User Benefits and Practical Application
The UC-ETH-AD2-16ISO offers a practical solution for industrial control and monitoring tasks. Its rugged, galvanically isolated electronics ensure reliable operation, while the documentation, drivers, and ICT diagnostic tool enable quick integration. Thanks to regular updates and direct developer support, the module remains operational over the long term and supports sustainable planning in professional environments.
Technical Specifications
The Modbus TCP Analog Module features 2 analog inputs for measuring voltages and currents. It supports typical ranges such as 0–5 V, 0–10 V, 0–20 mA, and 4–20 mA. Data is transmitted via Ethernet or Modbus TCP. The device offers reliable signal conversion and is designed for industrial applications involving continuous data acquisition.
Ethernet interface:
- Ethernet 10/100 Mbps
- Supported protocols: HTTP, UDP, TCP, DHCP, Modbus-TCP
- Control: API for Windows and Linux (DELIB driver library), command line interface, open TCP protocol, Modbus-TCP
- Encrypted Ethernet communication possible
- Open standard or Modbus TCP protocol
- Web interface and app (smartphone and tablet)
- Electrically isolated up to 1.5 kV
Wi-Fi interface:
- Wi-Fi connection available
- WPS feature
- WPS Button
16-bit analog inputs:
- Design: single-ended
- 16-bit resolution per channel
- Voltage ranges: 0–5 V, 0–10 V, 0–20 V, 0–40 V, ±5 V, ±10 V, ±20 V, ±40 V
- Current ranges: 0–20 mA, 4–20 mA, 0–24 mA
- Channel-to-channel isolation: max. 1 kV AC
- Electrical isolation for the power supply: max. 500 V
- A/D converter conversion time: 4 µs
Additional features:
- Configurable event control
- M2M functionality
- General
- Technical data
- ICT-Tool
- Configuration
- Modbus
- M2M
- Event-Control
- Programming/API
- DELIB-API commands
- WEB interface
- App
- Connectors
- Downloads & manuals
- Scope of delivery
- Accessories
Analog inputs
Analog/digital converter modules are suitable for measuring and monitoring voltages and currents. Transducers, for example, convert physical variables such as pressure, temperature, humidity etc. into corresponding currents or voltages and can therefore be recorded and digitally processed with our A/D modules.
A/D filter
Electrical or electromagnetic interference in measurement signals is smoothed and optimized by the software A/D filter by averaging the measurements.
Ethernet/WiFi modules
Our Ethernet/WiFi modules can be connected to the PC network via cable or WiFi. For a more user-friendly connection setup via WiFi, the module can also be connected to the router using the WPS function.
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.
LEDs
Each digital input and output has a separate LED that lights up when the signal status is active. The status of the operating voltage, communication with the interface, error events or the occurrence of a timeout can also be displayed.
M2M
Machine-to-machine, or M2M for short, involves direct communication between two or more modules. Analog or digital input signals from one transmitter module can be automatically transmitted to another module on a channel-by-channel basis.
M2M transmission is supported by all our products in the WEU series or by products with a CAN interface.
Event-Control
This function can be used to implement small control tasks that are saved in the module. These control tasks are configured as events and actions and then executed automatically according to the “if-then” principle.
Software and control for programmers
Our supplied DELIB driver library makes it easy to address the product via our API in almost all programming languages under Windows and Linux.
We offer support for the following programming languages:
- C
- C++
- C#
- VB
- VBA
- VB.Net
- Java
Remote switching of IP modules
Our IP modules can be conveniently and easily controlled worldwide via the TCP-IP network. The following options are available to you.
DEDITEC I/O Control app
With our DEDITEC I/O-Control app, our modules can also be controlled remotely. All you need is the network configuration of the module. The app is available for iOS and Android smartphones.
Web interface
Our IP modules can be operated from any browser. All you need is the IP address of the module.
M2M
Our WEU series modules can establish direct M2M communication with any DEDITEC Ethernet product, enabling, for example, the automated transmission of measured values or remote monitoring of machines and systems.
ICT-Tool
With the help of our all-in-one ICT-Tool software, you can configure, update, control and test your DEDITEC modules quickly and easily. The tool is included in the DEDITEC driver library.
More security through encryption
With the DEDITEC encryption mode, all TCP communication from the control PC to the DEDITEC module can be encrypted. This prevents unauthorized access to the module via TCP by third parties.
Control modules via Modbus TCP
Modbus TCP enables standardized data exchange between controllers, measuring devices, drives, and higher-level systems, regardless of the manufacturer. Status and measured values are read or written via the open Modbus register protocol.
| Power supply | +12 V ... +24 V DC |
|---|---|
| LEDs general |
|
| LEDs product-specific |
A/D-version:
D/A-version:
Thermo version:
|
| DIN rail mounting | 35 x 7,5 mm |
| Operating temperature | +10 °C ... +50 °C |
| Dimensions | 120 mm x 22.5 mm x 111 mm (H x W x D) |
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. |
|---|
| A/D-filter | Our A/D software filter can be used to smooth and optimize electrical disturbance variables that affect the measurement signal. The filter principle is based on averaging a sum of measurements. The higher the filter level is selected, the more measurements are used to calculate the average value. |
|---|
Interfaces
Ethernet-Interface
| Ethernet-Interface |
|
|---|---|
| IP-address | DHCP or static |
| DIP Switches |
|
| Access speed |
|
Inputs/Outputs
Analog inputs
| Inputs |
|
|---|---|
| Conversion rates |
|
| Galvanic isolation | Galvanic isolation from the power supply: max. 500V |
| A/D-filter |
|
Connectors
| Plug connector 16-pin |
|
|---|
| Plug connector 5-pin |
|
|---|
The ICT-Tool
Integration, configuration and testing - Our all-in-one Windows tool contains all the functions you need to put our products into operation quickly, easily and efficiently. Start with the setup and configuration, install firmware updates and use the extensive test and diagnostic options. The integrated help menu provides additional support if required.
Below you will find a brief overview of the program’s basic menus.
Module selection
Here you can integrate a new product into the ICT tool by clicking on the “+” symbol and then configure it.
ICT TreeView
In the TreeView, on the left-hand side of the program window, you can see the respective control elements or functions that are supported by your selected module. The scope of the functions depends on the respective product.
Overview
All relevant module information can be accessed here at a glance.
- Module name
- Module ID
- Firmware revision
- MAC address
- LAN and WiFi Network address (module dependent)
Inputs / Outputs
This overview shows the number of I/Os supported by your module.
Module infos
Here you will find all the important feature information for your module.
General features
Here you will find all the important feature information for your module.
Digital I/O features
Here you will find information about the digital I/Os supported by the module.
Analog I/O features
Here you will find information about the type of analog I/Os supported by your module.
Special I/O features
Here you will find information about the type of special I/Os supported by your module.
In den folgenden Kapitel, würden wir Ihnen unsere neue All-In-One-Software gerne genauer vorstellen.
Info
All relevant module information can be called up here at a glance.
- Module name
- Module ID
- Firmware revision
- Interface type
- Current DIP switch setting (only for Ethernet modules)
Identification
If several DEDITEC Ethernet modules are active in the network, a signal LED on the selected module can be activated via an identification function. This facilitates visual assignment.
Restart
You can restart your module here. The module status shows whether the restart was successful.
USB configuration
If you want to use several USB modules from the same product series on one PC, each of these modules must first be assigned its own module number.
LAN info
On this information page, you will find the current LAN network information and all the settings for your module at a glance.
LAN configuration
Integrate the product into your network or control it directly via a 1-to-1 connection.
The following parameters can be changed.
- Board name
- DHCP on/off
- IP address
- Subnet mask
- Default gateway
- TCP Port
WiFi info
All important WiFi settings are displayed on this page
WiFi configuration
Here you can change the network settings of the selected WiFi product.
The following settings can be made:
- Board name
- WLAN on/off
- Router name
- Router password
WPS
With the WPS function, your module can be connected to the router quickly and easily, automatically (WPS on the router is required)
CAN configuration
With our CAN products in the BS, NET and UC series, settings for the interface and the TX/RX packets can be made using the ICT tool.
More information can be found here:
Serial configuration
For our serial products in the BS, NET, UC and RO series, changes to the interface can be made using the
ICT tool.
More information can be found here:
Modbus TCP
Here you can set the Modbus TCP configuration of the module.
The following configurations can be made.
- Enable/disable access via Modbus TCP
- TCP port
TCP encryption
Here you can make settings for the encryption of your module.
The following configurations can be made.
- Allow unencrypted protocol
- Allow “User” encryption mode
- User password
- Allow “Admin” encryption mode
- Admin password
NTP configuration
You can make changes to the NTP service here.
The following configurations can be made.
- NTP service on/off
- server
- Port
- Timezone
WEB-Login
Here you can change the login settings of the web interface.
The following configurations can be made.
- Session duration
- Login name
- Login password
- Allow I/O access via web interface
D/A Default Values
Here you can set the D/A values and modes with which the module should be started.
The value and mode can be set individually for each channel.
Watchdog configuration
Here you can make and save settings on your watchdog stick.
Save or Load config
Using the “Save or Load config” function, you can save your entire module configuration in an external XML file.
This means you can always load your module in the desired original state.
The following configurations can be saved depending on the module type.
- USB configuration
- LAN configuration
- WiFi configuration
- TCP encryption
- NTP configuration
- Serial configuration
- CAN configuration
Status
This gives you an overview of the activity of the transmitter and receiver module
The following information from the transmitter module is displayed:
- Status of the activity: If the check mark is set, this action is currently being performed.
- Total number of actions performed. Is reset to 0 after a restart of the module.
- Number of actions per second.
- Number of DELIB errors that occur when executing commands from the DEDITEC driver library.
The following information from the receiver module is displayed:
- Connected: If the check mark is set, the transmitter and receiver modules are connected.
- IP address of the receiver module.
- Number of connection attempts.
Receiver modules
You can set the network settings of the receiver module here.
The following settings can be made
- Name for the receiver module
- Network settings of the receiver module
- Timeout
- Encryption type/ password
Action
With an action, you define which input signal is to be sent from the transmitter module to which output of a receiver module.
The following settings can be made:
- Type of task (digital, analog)
- Which receiver module should be used
- The interval at which the operations are to be carried out
- Start channel of the transmitter module
- Number of channels to be transmitted
- Start channel of the receive module
In the image on the right, DI data is sent every 100ms from channel 3(CH Start) to channel 8 ((CH Start) + (CH Count)) to channels 0-5 of the target module.
In den folgenden Kapitel, würden wir Ihnen unsere neue All-In-One-Software gerne genauer vorstellen.
Status
The Status area provides an overview of all active events and executed actions.
The following information is listed:
- Event number
- Event type
- Time interval of the event
- Number of events that have occurred
- Action number
- Number of triggered actions
- Number of other actions
Events configuration
Up to 16 different events can be created in the configuration menu. An event can be used, for example, to define switching thresholds at the analog inputs or logical states at the digital inputs of the module and link them to an executable action. The configuration itself is saved permanently in the module configuration memory of the module.
The following event modes are available, depending on the module type:
- DI: High-Low state of a digital input.
- DI flip-flop: Status change of a digital input (is stored in the module with the so-called flip-flop flag and deleted again after readout).
- DO readback: ON-OFF status of a digital output (is read out using a DO readback command).
- A/D: Current or voltage level at the analog inputs
Configuration actions
Up to 16 different actions can be created in the configuration menu. An action defines what should happen within an event after a condition is met.
The following action modes are available, depending on the module type:
- Set DO output: Switches a digital output on or off
- Set D/A output: Outputs a current or voltage value at an analog output
- Send CAN packet: A special CAN TX event is triggered (up to eight CAN TX events can be configured separately).
Digital Out
Hier können Sie die digitalen Ausgänge Ihres Modules ein- und ausschalten.
Folgende Funktionen können in dieser Form getestet werden.
- Kanalweise Ein- und Ausschalten der digitalen Ausgänge
- Readback der Kanäle
- Setzen eines Digitalausgangs für eine bestimmte Zeit (Modulabhängig)
- Gibt an welchen Status die Kanäle nach Ablauf der Zeit einnehmen sollen (Modulabhängig)
- Testen der Ausgänge
Digital Out
All digital outputs of your product can be checked by clicking on the buttons.
The following switching options are possible:
- Switching on and off channel by channel
- Channel-by-channel switching on or off for a specific time (product-dependent)
- Reading back the switching status (readback)
Digital In
In this view, the logical states of all optocoupler inputs can be read out.
The following information is displayed:
- Logical status of the inputs (ON/OFF)
- Number of detected pulses (counter function)
- Change of state detected (flip-flop)
TTL I/O
In this menu, the TTL channels of the module can be configured as inputs or outputs. The individual TTL outputs can be switched on or off by pressing the buttons. In addition, the status of all TTL inputs can be read out.
The tool offers the following functions:
- Configuration of the channels as input or output (in blocks of 8)
- Switching on and off channel by channel
- Reading back the switching status (output readback)
- Displaying the logical status of the inputs (input readback)
Analog Out
Here you can test the analog outputs of the module and manually enter any voltage or current value.
Analog In
In this menu, voltage or current values of all A/D channels can be displayed.
It is also possible to activate our A/D software filter with different filter levels.
CAN Runtime Parameter
Here you can change the CAN settings of the interface, the RX and TX packets in runtime.
The following settings can be made:
- Baud rate
- Extended ID
- Active on/off
- CAN ID
- Mode
CNT48
Here you can read out the counter readings of a counter module, select filter options and set various counting modes.
The following counting modes are supported:
- Read on rising edge
- Read on rising edge x2
- Read on rising edge x4
- Period duration
- Frequency measurement
- PWM measurement
Pulse generator
The pulse generator can be used to generate square-wave signals. High and low time as well as the number of pulses can be set here.
PWM Out
In this menu you have the option of testing various PWM frequencies. In addition, the duty cycle can be entered manually for each individual channel.
Temp
The temperature of all connected temperature sensors is displayed here directly in °C.
Graphical display
This menu allows a graphical representation of all analog input signals, such as A/D, temperature or FIFO-IN.
Watchdog
This tool can be used to check the configured watchdog parameters for correct function.
I/O – Timeout
You can use the timeout function in the I/O area to simulate a timeout case for your module.
The following is a description of the timeout window
- Read / Write symbol: Flashes to indicate an active connection to the module
- Automatic access: Removing the tick triggers a timeout after the timeout time has expired
- Manual access: Manual retrieval of data from the module
- Timeout status: Shows whether the timeout is active and whether a timeout event has occurred
- Timeout mode: Selection between 3 timeout modes, Normal, Reactivate and Secure
- Timeout duration: The time after which the timeout should be triggered is set here
- Activate / deactivate: Activates or deactivates the timeout function
Access times tests
You can test the access times for the module here. The following access time tests can be performed:
- Register – Read/Write/Write + Readback
- Digital I/O – Read/Write/Write + Readback
- Analog I/O – Read/Write/Write + Readback
Access times tests
This test can be used to determine the access times to the module. The test values are read and written in 8, 16, 32, or 64-bit commands.
Access times Register
The following example checks the register accesses to an Ethernet module. The average access time here is 0.5 ms.
Access times Analog I/O
In the following example, the access times to an Ethernet module with analog I/Os are checked. The average access time here is 0.6 ms.
Access times Digital I/O
In the following example, the access times to an Ethernet module with digital I/Os are checked. The average access time here is 0.6 ms.
Cable feedback tests
For this test, the digital or analog outputs of the module are connected to the corresponding digital or analog inputs of the module via cable. The feedback test now checks whether the output and input values match.
Cable return test
The cable return test can be used to check the function of all digital and analog inputs and outputs (I/Os) of a module. To do this, inputs and outputs are wired together externally on a 1:1 basis. The test software analyzes whether the output signals arrive correctly at the inputs, thereby identifying wiring errors or hardware defects.
Analog test
In analog test mode, the D/A converter outputs defined test voltages, which are then read in by the A/D converter and compared with the target values. The software counts the number of test runs and automatically documents any deviations.
Digital test
In the digital test, the switching states of the relay or MOSFET outputs are fed back externally to the optocoupler inputs. Here, too, the software counts and compares the number of cycles and automatically detects transmission errors or deviations.
Cable return test
The cable return test can be used to check the function of all digital and analog inputs and outputs (I/Os) of a module. To do this, inputs and outputs are wired together externally on a 1:1 basis. The test software analyzes whether the output signals arrive correctly at the inputs, thereby identifying wiring errors or hardware defects.
Analog test
In analog test mode, the D/A converter outputs defined test voltages, which are then read in by the A/D converter and compared with the target values. The software counts the number of test runs and automatically documents any deviations.
Digital test
In the digital test, the switching states of the relay or MOSFET outputs are fed back externally to the optocoupler inputs. Here, too, the software counts and compares the number of cycles and automatically detects transmission errors or deviations.
A/D ripple
The ripple test displays the residual ripple of the individual A/D inputs.
A/D quality measurements
The quality of an A/D measurement is influenced by various factors and can be affected by external interference. A reliable method for checking measurement quality is to measure a stable battery voltage. Our diagnostic tools can be used to determine the residual ripple and noise behavior.
A/D ripple
The A/D ripple test can be used to measure the residual ripple of the individual A/D inputs and check for interference signals such as mains hum or voltage instabilities.
A/D noise
The noise behavior of each A/D channel can be displayed graphically using A/D noise measurement. Additional filter stages with averaging can be used to smooth and improve the measurement signal.
FIFO In/Out
The software FIFO test can be used to specifically test the integrated FIFO buffering of our digital and analog NET I/O modules. Depending on whether it is an input or output module, data is read from the submodule FIFO or written to the submodule FIFO.
FIFO settings
The submodule number can be used to specify which module is to be tested. The start and end channels can also be used to transmit several channels simultaneously. In addition, the transmission frequency can be set and the desired FIFO mode selected – for example, for the use of test values or the actual measured values of the module.
All important information at a glance
During program execution, key information such as the size of the data packets, free and occupied bytes in the FIFO buffer, the number of data packets sent or received, and the current FIFO status are clearly displayed.
D/A output test
The D/A output test enables targeted testing of each individual D/A channel of a module. A freely selectable test voltage can be output directly. Currently, simple square wave signals with configurable high and low times are available. The signals can be monitored simultaneously with an oscilloscope. This function is also ideal for long-term tests. The test software detects DELIB errors and logs them automatically.
Mustertext
Mustertext
DO 4* value + wait
In this test, adjustable 16-bit values are written to the digital outputs of the module.
The values are sent to the module using the DapiDOSet16 command. The start channel is always channel 0.
You can set different wait times between the individual calls.
The test is intended for testing the functionality of the module.
Mustertext
Mustertext
Modbus I/O test
In the diagnostics section of the ICT-Tool, you can test the module’s digital and analog inputs and outputs directly via Modbus TCP. Register addresses as well as transfer and return values are displayed in a debug panel, allowing you to quickly diagnose problems with the D/A converter, for example. A complete overview of all register addresses and examples can be found in the Modbus manual at the following link:
To benefit from the latest functions and prevent errors, we recommend that you always keep your DEDITEC product up to date.
Flash Files
Downloading the firmware flash file package via the ICT tool
- Go to Flash Files in the “Firmware update” menu
- Click on the download button to start the download.
- Administration rights are required for the automatic unpacking of the flash files. If these rights are not available, the files are downloaded to the download area of your PC and must be extracted manually to the installation directory.
\DEDITEC\DELIB\programs\flash_files
Downloading the firmware flash file package via the DEDITEC homepage
- Download the required firmware flash file package from our homepage: Downloads -> Software -> Firmware
- Extract the files to the following installation path: ..\DEDITEC\DELIB\programs\flash_files
Flash modules
In the “Firmware update” menu, select the module you want to update and then click on the “Flash modules” or “Flash submodules” button.
The firmware is now updated and the module is then restarted automatically.
Information on the firmware flasher
The following information is displayed in the firmware flasher:
- Last FW: Displays the last firmware version
- Current FW: Displays the currently installed firmware version
- Newest FW: Displays the latest firmware version
- Log: Displays status or error messages during the flash process
In den folgenden Kapitel, würden wir Ihnen unsere neue All-In-One-Software gerne genauer vorstellen.
General
Here you can make general configurations to the ICT tool.
The following changes can be made:
- Language – setting between German and English possible
Updates
Here you can search for available DELIB or firmware updates.
- Automatic update search at program start
- Search for DELIB updates
- Search for firmware updates
Error log
Here you can make settings for the deditec_debug.log. This is saved under the path C:\Users\?USER?\AppData\Local\DEDITEC.
The following settings can be made:
- Enable writing to the debug.log
- Activate log notifications
- Activate automatic deletion of the debug.log
- Setting after how many days the debug.log should be deleted
- Set the maximum size of the debug.log
DELIB – DebugView – Global
Settings can be made here for the information that is to be displayed with the DebugView.
- Activate debug output
- Activate display of errors
DELIB – DebugView – Details
More detailed settings can be made here for the information to be displayed with the DebugView.
Configuration of our modules via the Ethernet / WiFi and USB interface
Depending on the product series, different interfaces are available for configuration with the control PC.
(Dynamic IP)
(Static IP)
In order to be able to address the DEDITEC product via Ethernet, it must be provided with the corresponding network settings. The following options are available for configuration:
- USB
- Ethernet / Dynamic IP
- Ethernet / Static IP
- Web interface
- WiFi
Connect the DEDITEC module to your PC via USB cable. Thanks to the Plug & Play function and the DELIB driver library, our modules are automatically recognized by your computer’s operating system. You can now access the module with our ICT-Tool and make the network settings in the configuration menu.
In DHCP mode, the DEDITEC module is automatically assigned a free IP address and the appropriate network settings by a DHCP server. The following options are available for activating DHCP mode:
- Activation via DIP switch
- Activation via the network search function in the “Edit / Add menu” of the ICT-Tool
- Activation via the “Module configuration menu” of the ICT-Tool
- Activation via the web interface of the module
DHCP mode can be activated on all DEDITEC modules with DIP switch 1.
In the “Edit / Add menu” of the ICT-Tool, you can scan the network for connected DEDITEC modules. Any modules found are then displayed in a list view where they can be configured and saved.
Click on the “Edit” button in the line of the desired module.
You can now make the desired network configuration in the following window and save it in the module using the “Save / Test” button.
To access the module’s configuration menu, the module must first be integrated into the ICT-Tool.
As the factory IP settings of the module often do not match the network settings of the customer’s PC, the following options are available to help you change them:
- Integration via the USB interface
- Integration via DHCP with DIP switch 1
- Direct connection to the PC * IP factory setting via DIP switch
- Integration via WiFi
Integration via the USB interface (only if available)
Connect the DEDITEC module to your PC via USB cable. Thanks to the Plug & Play function and the DELIB driver library, our modules are automatically recognized by your computer’s operating system. You can now select the module in the main menu of the ICT-Tool and make the network settings in the configuration menu.
Integration via DHCP using DIP switch 1
Set DIP switch 1 on your module to “ON” and switch the module on.
The module now starts in DHCP mode and can be added or selected as a module in the ICT-Tool. You can now make the network settings in the configuration menu. Then reset DIP switch 1 again.
Integration via the IP factory settings with DIP switch 3 and crossover cable
Connect the DEDITEC module directly to your PC using a crossover cable. Set the module’s DIP switch 3 to “ON” and switch the module on. The module now starts with the factory IP address 192.168.1.1. Temporarily set your PC to the same 192.168.1.x network and then add the DEDITEC module in the ICT-Tool.
You can now change the network settings of the module in the configuration menu. DIP switch 3 and the PC IP settings are then reset.
Integration via WiFi (only for WEU series modules)
By pressing the CFG button on the DEDITEC module, you activate the WPS function to automatically connect to the WLAN router of your network (see “WiFi” tab). After a successful connection, the module can be called up in the ICT-Tool via the board name stored in the router – e.g. “boardname.fritz.box” – and can be added as a new module. You can then make the network settings in the configuration menu. For support, contact your system administrator if necessary.
The module is now set to DHCP on the software side.
Central network settings, such as IP configuration or DHCP activation, can be made via the module’s web interface.
To call up the web interface of the module, start your Internet browser and enter the IP address of the module in the URL line. -> For more details, see the “Web interface” tab
To integrate the module into an existing network, it can be permanently assigned a fixed IP address. The following options are available for configuring the module’s network settings:
- Configuration via the network search function in the “Edit / Add menu” of the ICT-Tool
- Configuration via the “Module configuration menu” of the ICT-Tool
- Configuration via the module’s web interface
In the “Edit / Add menu” of the ICT-Tool, you can scan the network for connected DEDITEC modules. Any modules found are then displayed in a list view where they can be configured and saved.
Click on the “Edit” button in the line of the desired module.
You can now make the desired network configuration in the following window and save it in the module using the “Save / Test” button.
To access the module’s configuration menu, the module must first be integrated into the ICT-Tool.
As the factory IP settings of the module often do not match the network settings of the customer’s PC, the following options are available to help you change them:
- Integration via the USB interface
- Integration via DHCP with DIP switch 1
- Direct connection to the PC * IP factory setting via DIP switch
- Integration via WiFi
Integration via the USB interface (only if available)
Connect the DEDITEC module to your PC via USB cable. Thanks to the Plug & Play function and the DELIB driver library, our modules are automatically recognized by your computer’s operating system. You can now select the module in the main menu of the ICT-Tool and make the network settings in the configuration menu.
Integration via DHCP using DIP switch 1
Set DIP switch 1 on your module to “ON” and switch the module on.
The module now starts in DHCP mode and can be added or selected as a module in the ICT-Tool. You can now make the network settings in the configuration menu. Then reset DIP switch 1 again.
Integration via the IP factory settings with DIP switch 3 and crossover cable
Connect the DEDITEC module directly to your PC using a crossover cable. Set the module’s DIP switch 3 to “ON” and switch the module on. The module now starts with the factory IP address 192.168.1.1. Temporarily set your PC to the same 192.168.1.x network and then add the DEDITEC module in the ICT-Tool.
You can now change the network settings of the module in the configuration menu. DIP switch 3 and the PC IP settings are then reset.
Integration via WiFi (only for WEU series modules)
By pressing the CFG button on the DEDITEC module, you activate the WPS function to automatically connect to the WLAN router of your network (see “WiFi” tab). After a successful connection, the module can be called up in the ICT-Tool via the board name stored in the router – e.g. “boardname.fritz.box” – and can be added as a new module. You can then make the network settings in the configuration menu. For support, contact your system administrator if necessary.
The module is now set to DHCP on the software side.
Central network settings, such as IP configuration or DHCP activation, can be made via the module’s web interface.
To call up the web interface of the module, start your Internet browser and enter the IP address of the module in the URL line. -> For more information, see the “Web interface” tab
All central network settings for the module can be made via the module’s web interface.
Access to the web interface
To call up the web interface of the module, start your Internet browser and enter the IP address of the module in the URL line. The access data is set at the factory as follows:
| IP address: | 192.168.1.1 |
| User name: | admin |
| Password: | admin |
If you do not know the IP address of the module, simply use the network search function in the “Edit / Add Men” of the ICT-Tool or look at the IP address assignment in your router.
You can also find more information on this under the “Static IP” or “Dynamic IP” tabs
All modules in the WEU series have an integrated WiFi interface. The connection to a WiFi network can be established either via the ICT-Tool or by pressing the CFG button on the module. You can then make further network settings in the configuration menu. The following options are available for establishing a WiFi connection:
- Establish WiFi connection via button
- Establish automatic connection via ICT-Tool (WPS)
- Establish manual connection via ICT-Tool
By pressing the CFG button on the DEDITEC module, you activate the WPS function to automatically connect to the WLAN router of your network.
Different modes are activated depending on the duration of operation:
- 3–6 Press and hold for seconds: Activate WiFi
- 7–12 Press and hold for seconds: Start WPS connection
- 13–15 Press and hold for seconds: Deactivate WiFi
A status LED on the module indicates the current mode by flashing.
WPS – Simple connection to the network
WPS (WiFi Protected Setup) makes it particularly easy to connect to a WLAN network – without having to enter a network name or password manually.
This is how the WPS connection works:
- Activate WPS mode on the module (press the CFG button for 7-12 seconds)
- Press the WPS button on the router within 2 minutes*.
- The connection is now established automatically.
* Note:
For this type of connection to work, the router used must support WPS. Otherwise, the WLAN connection must be set up manually via the LAN configuration in the ICT-Tool.
A connection to the router can be established automatically in the WPS tab. To do this, press the “WPS Start” button and activate the WPS function on the router within two minutes. The devices will then connect to each other automatically.
If the router login data is known, a connection can be established in the WiFi configuration tab by entering the user name and password. Please note that WiFi must also be activated.
Control of Ethernet modules via Modbus TCP protocol
Modbus TCP is a protocol based on TCP/IP that is used for communication between different devices. It allows data to be read and written via so-called registers and bits. Standardized function codes are used for this purpose, such as:
General register allocation
| Modbus register (dez) |
Data type | Access | Data size (Bit) |
Description |
| 0 ... 9999 | Coil | write / read | 1 | Writing and reading back digital outputs |
| 10000 ... 19999 | Discrete Inputs | read | 1 | Read digital inputs |
| 30000 ... 39999 | Input Register | read | 16 | Read holder register |
| 40000 ... 49999 | Holding Register | write / read | 16 | Write and read back registers |
Control of Ethernet modules via Modbus TCP
Our modules can be controlled via the Modbus register protocol for quick and easy integration. This protocol allows you to conveniently read and write values, switch digital outputs, or query inputs. The complete protocol is available for download.
Example:
// Writes the digital outputs of channels 1-16
MASTER.WriteMultipleRegisters(SLAVE_ID, 0x0420, 0x03);
// Reads the values from channels 1-16
registerValue = MASTER.ReadHoldingRegisters(SLAVE_ID, 0x0420, NUMREGISTERS);
Configuration of our Modbus TCP modules
The Ethernet module is configured as follows at the factory:
Modbus active = YES
Modbus IP address = IP address of the module
Modbus port = 502 (standard Modbus port)
If you would like to use your own settings or deactivate the Modbus function, please use the configuration menu of our ICT-Tool.
Changing the parameters in the ICT-Tool
1. Setting/changing the IP address:
The IP address for Modbus TCP and TCP-IP is always identical.
Detailed instructions on how to change the IP address can be found at the following link:
2. Deactivate the Modbus function in the module:
If you want to deactivate the Modbus function, navigate to the “Modbus TCP” submenu, uncheck the “Enable” box, and then save your settings.
3. Port configuration
Modbus TCP communication takes place on port 502 by default. Alternatively, any port between 100 and 49151 can be set.
Modbus I/O test
In the diagnostics section of the ICT-Tool, you can test the module's digital and analog inputs and outputs directly via Modbus TCP. Register addresses as well as transfer and return values are displayed in a debug panel, allowing you to quickly diagnose problems with the D/A converter, for example. A complete overview of all register addresses and examples can be found in the Modbus manual at the following link:
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.
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
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.
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:
Programming our modules with the DELIB driver library ETH
DELIB ETH is a pure Ethernet version of the DEDITEC driver library. It does not contain any drivers for USB or serial ports and does not need to be installed on the PC. There is also no need to configure or integrate a module in the registry. Admin write permissions are also not required.
As a project customer, you can also integrate DELIB ETH directly into your own setup.
All products with an Ethernet interface are supported by DELIB ETH and can be addressed directly via the TCP/IP address.
Click here for DELIB ETH:
Example of programming our modules with DELIB
Open module:
uint ModulID = 14; - the ID depends on the module type. (s. delib.h)
uint ModulNr = 0; - always 0 by default
uint handle; - handle of the open module
handle = DapiOpenModule(ModulID, ModulNr);
Switching relays:
uint ch = 0; - channel number
uint val = 1; - value to be set (0=off / 1=on)
DapiDOSet1(handle, ch, val);
Close module:
DapiCloseModule(handle);
Explanation:
The “DapiOpenModule” function is used to open a module. The two parameters passed within the parentheses determine which module is to be opened.
The first parameter refers to the module ID. You can find the correct ID for your module in the delib.h file, which is located in the DEDITEC installation path.
The second parameter refers to the module number, which is important if several modules of the same type are operated on one PC. If only one module is connected to the PC, simply enter “0”. The module number can be set directly on the module using the ICT-Tool.
How do I test my module?
You can access the module directly via the graphical user interface and execute all functions.
Click here for the ICT tool:
Programming our Ethernet modules
Our Ethernet modules are programmed using the DELIB driver library.
The following programming options (protocols/IP address) are available:
Module mit einem 10/100 Mbit Ethernet-Interface können direkt an einem PC oder an einem Netzwerk-LAN angeschlossen werden. Für die Konfiguration stehen folgende Möglichkeiten zur Auswahl:
Ansteuerung von Ethernet-Modulen mit Hilfe der IP-Direct-Methode
Mit dieser Methode können Sie unsere Ethernet-Module direkt über die IP-Adresse öffnen und steuern. Eine Installation des DELIB-Setups ist nicht notwendig.
Im folgenden Beispiel wird das Modul über IP-Direct geöffnet:
DAPI_OPENMODULEEX_STRUCT exbuffer = new DAPI_OPENMODULEEX_STRUCT();
exbuffer.address = „192.168.1.1“;
exbuffer.portno = 9912;
exbuffer.timeout = 5000;
handle = DapiOpenModuleEx(29, 0, exbuffer, 0);
Ansteuerung von Ethernet-Modulen mit Hilfe der Standard-Methode (Registry)
Mit dieser Methode wird das Modul über die in der Registry hinterlegten Netzwerkkonfiguration geöffnet.
Dadurch muss die Anwendungssoftware nicht die IP-Adresse kennen, da diese auf dem Rechner in der Registry gespeichert ist. Die Verteilung von Software auf unterschiedliche Rechner ist dadurch einfacher.
Die Konfiguration kann mit Hilfe des ICT-Tools in der Registry abgespeichert werden.
Im folgenden Beispiel wird das Modul über die Standard-Methode geöffnet:
uint ModulID = 39; (s. delib.h)
uint ModulNr = 0;
handle = DapiOpenModule(ModulID, ModulNr);
Ansteuerung von Ethernet-Modulen über TCP/IP über unser offenes Ethernet Protokoll
Bei Bedarf können Sie Ihre eigene Ansteuerung selber programmieren. Das Protokoll, welches die Kommunikation über TCP/IP beschreibt, ist offen gelegt. Die Ansteuerung erfolgt registerbasiert. Hierfür wurde ein Kommunikations-Protokoll erstellt, anhand dessen die Register des Moduls angesprochen werden und somit Lese- oder Schreibbefehle ausgeführt werden. Das Handbuch “Protokolle & Registerbelegung” beschreibt die Sende- und Empfangsrahmen, um mit unseren Ethernet-Modulen zu kommunizieren.
Our Ethernet products can be controled in various ways. For a better overview, we have divided these into the following points:
- IP direct method
- Standard method (registry)
- DEDITEC TCP/IP protocol
- Modbus TCP protocol
Ansteuerung von Ethernet-Modulen mit Hilfe der IP-Direct-Methode
Mit dieser Methode können Sie unsere Ethernet-Module direkt über die IP-Adresse öffnen und steuern. Eine Installation des DELIB-Setups ist nicht notwendig.
Im folgenden Beispiel wird das Modul über IP-Direct geöffnet:
DAPI_OPENMODULEEX_STRUCT exbuffer = new DAPI_OPENMODULEEX_STRUCT();
exbuffer.address = „192.168.1.1“;
exbuffer.portno = 9912;
exbuffer.timeout = 5000;
handle = DapiOpenModuleEx(29, 0, exbuffer, 0);
Ansteuerung von Ethernet-Modulen mit Hilfe der Standard-Methode (Registry)
Mit dieser Methode wird das Modul über die in der Registry hinterlegten Netzwerkkonfiguration geöffnet.
Dadurch muss die Anwendungssoftware nicht die IP-Adresse kennen, da diese auf dem Rechner in der Registry gespeichert ist. Die Verteilung von Software auf unterschiedliche Rechner ist dadurch einfacher.
Die Konfiguration kann mit Hilfe des ICT-Tools in der Registry abgespeichert werden.
Im folgenden Beispiel wird das Modul über die Standard-Methode geöffnet:
uint ModulID = 39; (s. delib.h)
uint ModulNr = 0;
handle = DapiOpenModule(ModulID, ModulNr);
Ansteuerung von Ethernet-Modulen über TCP/IP über unser offenes Ethernet Protokoll
Bei Bedarf können Sie Ihre eigene Ansteuerung selber programmieren. Das Protokoll, welches die Kommunikation über TCP/IP beschreibt, ist offen gelegt. Die Ansteuerung erfolgt registerbasiert. Hierfür wurde ein Kommunikations-Protokoll erstellt, anhand dessen die Register des Moduls angesprochen werden und somit Lese- oder Schreibbefehle ausgeführt werden. Das Handbuch “Protokolle & Registerbelegung” beschreibt die Sende- und Empfangsrahmen, um mit unseren Ethernet-Modulen zu kommunizieren.
Module mit einem 10/100 Mbit Ethernet-Interface können direkt an einem PC oder an einem Netzwerk-LAN angeschlossen werden. Für die Konfiguration stehen folgende Möglichkeiten zur Auswahl:
Control of Ethernet modules using the IP Direct method
This method allows you to open and control our Ethernet modules directly via the IP address. It is not necessary to install the DELIB setup.
In the following example, the module is opened via IP-Direct:
DAPI_OPENMODULEEX_STRUCT exbuffer = new DAPI_OPENMODULEEX_STRUCT();
exbuffer.address = „192.168.1.1“;
exbuffer.portno = 9912;
exbuffer.timeout = 5000;
handle = DapiOpenModuleEx(29, 0, exbuffer, 0);
Control of Ethernet modules using the standard method (registry)
This method opens the module via the network configuration stored in the registry.
This means that the application software does not need to know the IP address, as this is stored on the computer in the registry. This makes it easier to distribute software to different computers.
The configuration can be saved in the registry using the ICT-Tool.
In the following example, the module is opened using the standard method:
uint ModulID = 39; (s. delib.h)
uint ModulNr = 0;
handle = DapiOpenModule(ModulID, ModulNr);
Control of Ethernet modules via TCP/IP using our open Ethernet protocol
If required, you can program your own control system yourself. The protocol that describes communication via TCP/IP is open. Control is register-based. A communication protocol has been created for this purpose, which is used to address the registers of the module and thus execute read or write commands. The “Protocols & Register Assignment” manual describes the send and receive frames for communicating with our Ethernet modules.
This method allows you to open and control our Ethernet modules directly via the IP address. Installation of the DELIB setup is not necessary.
In the following example, the module is opened via IP Direct:
DAPI_OPENMODULEEX_STRUCT exbuffer = new DAPI_OPENMODULEEX_STRUCT();
exbuffer.address = „192.168.1.1“;
exbuffer.portno = 9912;
exbuffer.timeout = 5000;
handle = DapiOpenModuleEx(29, 0, exbuffer, 0);
Ansteuerung von Ethernet-Modulen mit Hilfe der IP-Direct-Methode
Mit dieser Methode können Sie unsere Ethernet-Module direkt über die IP-Adresse öffnen und steuern. Eine Installation des DELIB-Setups ist nicht notwendig.
Im folgenden Beispiel wird das Modul über IP-Direct geöffnet:
DAPI_OPENMODULEEX_STRUCT exbuffer = new DAPI_OPENMODULEEX_STRUCT();
exbuffer.address = „192.168.1.1“;
exbuffer.portno = 9912;
exbuffer.timeout = 5000;
handle = DapiOpenModuleEx(29, 0, exbuffer, 0);
Ansteuerung von Ethernet-Modulen mit Hilfe der Standard-Methode (Registry)
Mit dieser Methode wird das Modul über die in der Registry hinterlegten Netzwerkkonfiguration geöffnet.
Dadurch muss die Anwendungssoftware nicht die IP-Adresse kennen, da diese auf dem Rechner in der Registry gespeichert ist. Die Verteilung von Software auf unterschiedliche Rechner ist dadurch einfacher.
Die Konfiguration kann mit Hilfe des ICT-Tools in der Registry abgespeichert werden.
Im folgenden Beispiel wird das Modul über die Standard-Methode geöffnet:
uint ModulID = 39; (s. delib.h)
uint ModulNr = 0;
handle = DapiOpenModule(ModulID, ModulNr);
Ansteuerung von Ethernet-Modulen über TCP/IP über unser offenes Ethernet Protokoll
Bei Bedarf können Sie Ihre eigene Ansteuerung selber programmieren. Das Protokoll, welches die Kommunikation über TCP/IP beschreibt, ist offen gelegt. Die Ansteuerung erfolgt registerbasiert. Hierfür wurde ein Kommunikations-Protokoll erstellt, anhand dessen die Register des Moduls angesprochen werden und somit Lese- oder Schreibbefehle ausgeführt werden. Das Handbuch “Protokolle & Registerbelegung” beschreibt die Sende- und Empfangsrahmen, um mit unseren Ethernet-Modulen zu kommunizieren.
Module mit einem 10/100 Mbit Ethernet-Interface können direkt an einem PC oder an einem Netzwerk-LAN angeschlossen werden. Für die Konfiguration stehen folgende Möglichkeiten zur Auswahl:
Ansteuerung von Ethernet-Modulen mit Hilfe der IP-Direct-Methode
Mit dieser Methode können Sie unsere Ethernet-Module direkt über die IP-Adresse öffnen und steuern. Eine Installation des DELIB-Setups ist nicht notwendig.
Im folgenden Beispiel wird das Modul über IP-Direct geöffnet:
DAPI_OPENMODULEEX_STRUCT exbuffer = new DAPI_OPENMODULEEX_STRUCT();
exbuffer.address = „192.168.1.1“;
exbuffer.portno = 9912;
exbuffer.timeout = 5000;
handle = DapiOpenModuleEx(29, 0, exbuffer, 0);
Ansteuerung von Ethernet-Modulen mit Hilfe der Standard-Methode (Registry)
Mit dieser Methode wird das Modul über die in der Registry hinterlegten Netzwerkkonfiguration geöffnet.
Dadurch muss die Anwendungssoftware nicht die IP-Adresse kennen, da diese auf dem Rechner in der Registry gespeichert ist. Die Verteilung von Software auf unterschiedliche Rechner ist dadurch einfacher.
Die Konfiguration kann mit Hilfe des ICT-Tools in der Registry abgespeichert werden.
Im folgenden Beispiel wird das Modul über die Standard-Methode geöffnet:
uint ModulID = 39; (s. delib.h)
uint ModulNr = 0;
handle = DapiOpenModule(ModulID, ModulNr);
Ansteuerung von Ethernet-Modulen über TCP/IP über unser offenes Ethernet Protokoll
Bei Bedarf können Sie Ihre eigene Ansteuerung selber programmieren. Das Protokoll, welches die Kommunikation über TCP/IP beschreibt, ist offen gelegt. Die Ansteuerung erfolgt registerbasiert. Hierfür wurde ein Kommunikations-Protokoll erstellt, anhand dessen die Register des Moduls angesprochen werden und somit Lese- oder Schreibbefehle ausgeführt werden. Das Handbuch “Protokolle & Registerbelegung” beschreibt die Sende- und Empfangsrahmen, um mit unseren Ethernet-Modulen zu kommunizieren.
This method opens the module using the network configuration stored in the registry.
This means that the application software does not need to know the IP address, as this is stored in the registry on the computer. This makes it easier to distribute software to different computers.
The configuration can be saved in the registry using the ICT-Tool.
In the following example, the module is opened using the standard method:
uint ModulID = 39; (s. delib.h)
uint ModulNr = 0;
handle = DapiOpenModule(ModulID, ModulNr);
Ansteuerung von Ethernet-Modulen mit Hilfe der IP-Direct-Methode
Mit dieser Methode können Sie unsere Ethernet-Module direkt über die IP-Adresse öffnen und steuern. Eine Installation des DELIB-Setups ist nicht notwendig.
Im folgenden Beispiel wird das Modul über IP-Direct geöffnet:
DAPI_OPENMODULEEX_STRUCT exbuffer = new DAPI_OPENMODULEEX_STRUCT();
exbuffer.address = „192.168.1.1“;
exbuffer.portno = 9912;
exbuffer.timeout = 5000;
handle = DapiOpenModuleEx(29, 0, exbuffer, 0);
Ansteuerung von Ethernet-Modulen mit Hilfe der Standard-Methode (Registry)
Mit dieser Methode wird das Modul über die in der Registry hinterlegten Netzwerkkonfiguration geöffnet.
Dadurch muss die Anwendungssoftware nicht die IP-Adresse kennen, da diese auf dem Rechner in der Registry gespeichert ist. Die Verteilung von Software auf unterschiedliche Rechner ist dadurch einfacher.
Die Konfiguration kann mit Hilfe des ICT-Tools in der Registry abgespeichert werden.
Im folgenden Beispiel wird das Modul über die Standard-Methode geöffnet:
uint ModulID = 39; (s. delib.h)
uint ModulNr = 0;
handle = DapiOpenModule(ModulID, ModulNr);
Ansteuerung von Ethernet-Modulen über TCP/IP über unser offenes Ethernet Protokoll
Bei Bedarf können Sie Ihre eigene Ansteuerung selber programmieren. Das Protokoll, welches die Kommunikation über TCP/IP beschreibt, ist offen gelegt. Die Ansteuerung erfolgt registerbasiert. Hierfür wurde ein Kommunikations-Protokoll erstellt, anhand dessen die Register des Moduls angesprochen werden und somit Lese- oder Schreibbefehle ausgeführt werden. Das Handbuch “Protokolle & Registerbelegung” beschreibt die Sende- und Empfangsrahmen, um mit unseren Ethernet-Modulen zu kommunizieren.
Module mit einem 10/100 Mbit Ethernet-Interface können direkt an einem PC oder an einem Netzwerk-LAN angeschlossen werden. Für die Konfiguration stehen folgende Möglichkeiten zur Auswahl:
Ansteuerung von Ethernet-Modulen mit Hilfe der IP-Direct-Methode
Mit dieser Methode können Sie unsere Ethernet-Module direkt über die IP-Adresse öffnen und steuern. Eine Installation des DELIB-Setups ist nicht notwendig.
Im folgenden Beispiel wird das Modul über IP-Direct geöffnet:
DAPI_OPENMODULEEX_STRUCT exbuffer = new DAPI_OPENMODULEEX_STRUCT();
exbuffer.address = „192.168.1.1“;
exbuffer.portno = 9912;
exbuffer.timeout = 5000;
handle = DapiOpenModuleEx(29, 0, exbuffer, 0);
Ansteuerung von Ethernet-Modulen mit Hilfe der Standard-Methode (Registry)
Mit dieser Methode wird das Modul über die in der Registry hinterlegten Netzwerkkonfiguration geöffnet.
Dadurch muss die Anwendungssoftware nicht die IP-Adresse kennen, da diese auf dem Rechner in der Registry gespeichert ist. Die Verteilung von Software auf unterschiedliche Rechner ist dadurch einfacher.
Die Konfiguration kann mit Hilfe des ICT-Tools in der Registry abgespeichert werden.
Im folgenden Beispiel wird das Modul über die Standard-Methode geöffnet:
uint ModulID = 39; (s. delib.h)
uint ModulNr = 0;
handle = DapiOpenModule(ModulID, ModulNr);
Ansteuerung von Ethernet-Modulen über TCP/IP über unser offenes Ethernet Protokoll
Bei Bedarf können Sie Ihre eigene Ansteuerung selber programmieren. Das Protokoll, welches die Kommunikation über TCP/IP beschreibt, ist offen gelegt. Die Ansteuerung erfolgt registerbasiert. Hierfür wurde ein Kommunikations-Protokoll erstellt, anhand dessen die Register des Moduls angesprochen werden und somit Lese- oder Schreibbefehle ausgeführt werden. Das Handbuch “Protokolle & Registerbelegung” beschreibt die Sende- und Empfangsrahmen, um mit unseren Ethernet-Modulen zu kommunizieren.
If necessary, you can program your own control system yourself. The protocol that describes communication via TCP/IP is fully documented. Control is register-based. A communication protocol has been created for this purpose, which is used to address the module’s registers and thus execute read or write commands. The “Protocols & Register Assignment” manual describes the transmission and reception frames for communicating with our Ethernet modules.
Ansteuerung von Ethernet-Modulen mit Hilfe der IP-Direct-Methode
Mit dieser Methode können Sie unsere Ethernet-Module direkt über die IP-Adresse öffnen und steuern. Eine Installation des DELIB-Setups ist nicht notwendig.
Im folgenden Beispiel wird das Modul über IP-Direct geöffnet:
DAPI_OPENMODULEEX_STRUCT exbuffer = new DAPI_OPENMODULEEX_STRUCT();
exbuffer.address = „192.168.1.1“;
exbuffer.portno = 9912;
exbuffer.timeout = 5000;
handle = DapiOpenModuleEx(29, 0, exbuffer, 0);
Ansteuerung von Ethernet-Modulen mit Hilfe der Standard-Methode (Registry)
Mit dieser Methode wird das Modul über die in der Registry hinterlegten Netzwerkkonfiguration geöffnet.
Dadurch muss die Anwendungssoftware nicht die IP-Adresse kennen, da diese auf dem Rechner in der Registry gespeichert ist. Die Verteilung von Software auf unterschiedliche Rechner ist dadurch einfacher.
Die Konfiguration kann mit Hilfe des ICT-Tools in der Registry abgespeichert werden.
Im folgenden Beispiel wird das Modul über die Standard-Methode geöffnet:
uint ModulID = 39; (s. delib.h)
uint ModulNr = 0;
handle = DapiOpenModule(ModulID, ModulNr);
Ansteuerung von Ethernet-Modulen über TCP/IP über unser offenes Ethernet Protokoll
Bei Bedarf können Sie Ihre eigene Ansteuerung selber programmieren. Das Protokoll, welches die Kommunikation über TCP/IP beschreibt, ist offen gelegt. Die Ansteuerung erfolgt registerbasiert. Hierfür wurde ein Kommunikations-Protokoll erstellt, anhand dessen die Register des Moduls angesprochen werden und somit Lese- oder Schreibbefehle ausgeführt werden. Das Handbuch “Protokolle & Registerbelegung” beschreibt die Sende- und Empfangsrahmen, um mit unseren Ethernet-Modulen zu kommunizieren.
Modbus TCP is a protocol based on TCP/IP that is used for communication between different devices. It allows data to be read and written via so-called registers and bits. Standardized function codes are used for this purpose, such as:
General register allocation
| Modbus register (dez) |
Data type | Access | Data size (Bit) |
Description |
| 0 … 9999 | Coil | write / read | 1 | Writing and reading back digital outputs |
| 10000 … 19999 | Discrete Inputs | read | 1 | Read digital inputs |
| 30000 … 39999 | Input Register | read | 16 | Read holder register |
| 40000 … 49999 | Holding Register | write / read | 16 | Write and read back registers |
Modbus TCP is a protocol based on TCP/IP that is used for communication between different devices. It allows data to be read and written via so-called registers and bits. Standardized function codes are used for this purpose, such as:
- Read Coils (FC 01): reads digital outputs (0 or 1).
- Read Discrete Inputs (FC 02): reads digital inputs (0 or 1).
- Read Holding Registers (FC 03): Reads 16-bit values that can also be written (e.g., setpoints).
- Read Input Registers (FC 04): Reads 16-bit values that are read-only (e.g., measured values).
Our modules can be controlled via the Modbus register protocol for quick and easy integration. This protocol allows you to conveniently read and write values, switch digital outputs, or query inputs. The complete protocol is available for download.
Example:
// Writes the digital outputs of channels 1-16
MASTER.WriteMultipleRegisters(SLAVE_ID, 0x0420, 0x03);
// Reads the values from channels 1-16
registerValue = MASTER.ReadHoldingRegisters(SLAVE_ID, 0x0420, NUMREGISTERS);
Management functions
DapiOpenModule
This function opens a specific module.
Description
This function opens a specific module.
Definition
ULONG DapiOpenModule(ULONG moduleID, ULONG nr);
Parameter
moduleID=Specifies the module to be opened (see delib.h)
nr=Specifies which module is to be opened.
nr=0 -> 1. Module
nr=1 -> 2. Module
Return value
handle=Corresponding handle for the module
handle=0 -> Module was not found
Remark
The handle returned by this function is required to identify the module for all other functions.
Programming example
// Open USB module
handle = DapiOpenModule(RO_USB1, 0);
printf(„handle = %x\n“, handle);
if (handle==0)
{
// USB module was not found
printf(„Module could not be opened\n“);
return;
}
DapiCloseModule
This command closes an open module.
Description
This command closes an open module.
Definition
ULONG DapiCloseModule(ULONG handle);
Parameter
handle=This is the handle of an open module
Return value
None
Programming example
// Close module
DapiCloseModule(handle);
DapiGetDELIBVersion
This function returns the installed DELIB version.
Description
This function returns the installed DELIB version.
Definition
ULONG DapiGetDELIBVersion(ULONG mode, ULONG par);
Parameter
mode=Mode with which the version is read out (must always be 0).
par=This parameter is not defined (must always be 0).
Return value
version=Version number of the installed DELIB version [hex]
Programming example
version = DapiGetDELIBVersion(0, 0);
//With version 1.32 installed
version = 132(hex)
DapiSpecialCMDGetModuleConfig
This function returns the hardware configuration (number of input and output channels) of the module.
Description
This function returns the hardware configuration (number of input and output channels) of the module.
Definition
ULONG DapiSpecialCommand(ULONG handle,
DAPI_SPECIAL_CMD_GET_MODULE_CONFIG, par, 0, 0);
Parameter
handle=This is the handle of an open module
Querying the number of digital input channels
par=DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DI
Query number of digital input flip-flops
par=DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DI_FF
Query number of digital input counters (16-bit counter)
par=DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DI_COUNTER
Query number of digital input counters (48-bit counter)
par=DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_CNT48
Querying the number of digital output channels
par=DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DO
Querying the number of digital pulse generator outputs
par=DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_PULSE_GEN
Querying the number of digital PWM outputs
par=DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_PWM_OUT
Querying the number of digital input/output channels
par=DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DX
Querying the number of analog input channels
par=DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_AD
Querying the number of analog output channels
par=DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DA
Query number of temperature channels
par=DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_TEMP
Query number of stepper channels
par=DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_STEPPER
Return value
Querying the number of digital input channels
return=number of digital input channels
Query number of digital input flip-flops
return=number of digital input flip-flops
Query number of digital input counters (16-bit counter)
return=number of digital input counters (16-bit counter)
Query number of digital input counters (48-bit counter)
return=number of digital input counters (48-bit counter)
Querying the number of digital output channels
return=number of digital output channels
Querying the number of digital pulse generator outputs
return=number of digital pulse generator outputs
Querying the number of digital PWM outputs
return=number of digital PWM outputs
Querying the number of digital input/output channels
return=number of digital input/output channels
Querying the number of analog input channels
return=number of analog input channels
Querying the number of analog output channels
return=number of analog output channels
Query number of temperature channels
return=number of temperature channels
Query number of stepper channels
return=number of stepper channels
Programming example
ret=DapiSpecialCommand(handle,
DAPI_SPECIAL_CMD_GET_MODULE_CONFIG,
DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DI, 0, 0);
//Returns the number of digital input channels
ret=DapiSpecialCommand(handle,
DAPI_SPECIAL_CMD_GET_MODULE_CONFIG,
DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DO, 0, 0);
//Returns the number of digital output channels
ret=DapiSpecialCommand(handle,
DAPI_SPECIAL_CMD_GET_MODULE_CONFIG,
DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DX, 0, 0);
//Returns the number of digital input/output channels
ret=DapiSpecialCommand(handle,
DAPI_SPECIAL_CMD_GET_MODULE_CONFIG,
DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_AD, 0, 0);
//Returns the number of analog input channels
ret=DapiSpecialCommand(handle,
DAPI_SPECIAL_CMD_GET_MODULE_CONFIG,
DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DA, 0, 0);
//Returns the number of analog output channels
ret=DapiSpecialCommand(handle,
DAPI_SPECIAL_CMD_GET_MODULE_CONFIG,
DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_STEPPER, 0, 0);
//Returns the number of stepper channels
DapiOpenModuleEx
This function specifically opens a module with an Ethernet interface. The parameters IP address, port number and the duration of the timeout can be defined.
Description
This function specifically opens a module with an Ethernet interface. The parameters IP address, port number and the duration of the timeout can be defined. The module is opened independently of the settings made in the DELIB Configuration Utility.
Definition
ULONG DapiOpenModuleEx(ULONG moduleID, ULONG nr, unsigned char* exbuffer, 0);
Parameter
moduleID = Specifies the module to be opened (see delib.h)
nr = Specifies which module (if several) is to be opened.
nr = 0 -> 1. Module
nr = 1 -> 2. Module
exbuffer = Buffer for IP address, port number and duration of the timeout
Return value
handle = Corresponding handle for the module
handle = 0 -> Module was not found
Remark
The handle returned by this function is required to identify the module for all other functions.
This command is supported by all modules with an Ethernet interface.
Programming example
// Open ETH-Module with parameter
DAPI_OPENMODULEEX_STRUCT open_buffer;
strcpy((char*) open_buffer.address, "192.168.1.10");
open_buffer.portno = 0;
open_buffer.timeout = 5000;
handle = DapiOpenModuleEx(RO_ETH, 0, (unsigned char*) &open_buffer, 0);
printf("Module handle = %x\n", handle);
DapiScanAllModulesAvailable
This function can be used to scan all modules connected to the USB bus.
Description
This function can be used to scan all modules connected to the USB bus.
The module ID and module no. of each module found are determined.
Definition
ULONG DapiScanAllModulesAvailable(uint nr)
Parameter
nr = 0: All modules connected to the USB bus are searched for
nr = i: Reading out the individual connected modules
Return value
Indicates the number of modules found.
Programming example
no_of_modules =
DT.Delib.DapiScanAllModulesAvailable(0);
for (i = 1; i <= no_of_modules; i++)
{
ret = DapiScanAllModulesAvailable(i);
moduleID = ret & 0x0000ffff;
moduleNr = (ret >> 16) & 0xff;
}
Register functions
DapiWriteByte
This command executes a direct register write command to the module.
Description
This command executes a direct register write command to the module.
Definition
void DapiWriteByte(ULONG handle, ULONG adress, ULONG value);
Parameter
handle=This is the handle of an open module
adress=Address to be accessed
value=Specifies the data value that is written (8-bit)
Return value
None
Remark
This should only be used by experienced programmers. This allows direct access to all available registers.
Programming example
// Data is written to register 0x10
DapiWriteByte(handle, 0x10, 0xFF);
DapiWriteWord
This command executes a direct register write command to the module.
Description
This command executes a direct register write command to the module.
Definition
void DapiWriteWord(ULONG handle, ULONG adress, ULONG value);
Parameter
handle=This is the handle of an open module
adress=Address to be accessed
value=Specifies the data value that is written (16-bit)
Return value
None
Remark
This should only be used by experienced programmers. This allows direct access to all available registers.
Programming example
// Data is written to register 0x10
DapiWriteWord(handle, 0x10, 0xFFFF);
DapiWriteLong
This command executes a direct register write command to the module.
Description
This command executes a direct register write command to the module.
Definition
void DapiWriteLong(ULONG handle, ULONG adress, ULONG value);
Parameter
handle=This is the handle of an open module
adress=Address to be accessed
value=Specifies the data value that is written (32-bit)
Return value
None
Remark
This should only be used by experienced programmers. This allows direct access to all available registers.
Programming example
// Data is written to register 0x10
DapiWriteLong(handle, 0x10, 0xFFFFFFFF);
DapiWriteLongLong
This command executes a direct register write command to the module.
Description
This command executes a direct register write command to the module.
Definition
void DapiWriteLongLong(ULONG handle, ULONG adress, ULONGLONG value);
Parameter
handle=This is the handle of an open module
adress=Address to be accessed
value=Specifies the data value that is written (64-bit)
Return value
None
Remark
This should only be used by experienced programmers. This allows direct access to all available registers.
Programming example
// Data is written to register 0x10
DapiWriteLongLong(handle, 0x10, 0xFFFFFFFFFFFFFFFF);
DapiReadByte
This command executes a direct register read command on the module.
Description
This command executes a direct register read command on the module.
Definition
ULONG DapiReadByte(ULONG handle, ULONG adress);
Parameter
handle=This is the handle of an open module
adress=Address to be accessed
Return value
Content of the register to be read (8-bit)
Remark
This should only be used by experienced programmers. This allows direct access to all available registers.
Programmierbeispiel
// Reads 8 bits from the address 0x0
ULONG data;
data = DapiReadByte(handle, 0x0);
DapiReadWord
This command executes a direct register read command on the module.
Description
This command executes a direct register read command on the module.
Definition
ULONG DapiReadWord(ULONG handle, ULONG adress);
Parameter
handle=This is the handle of an open module
adress=Address to be accessed
Return value
Content of the register to be read (16-bit)
Remark
This should only be used by experienced programmers. This allows direct access to all available registers.
Programming example
// Reads 16 bits from the address 0x0
ULONG data;
data = DapiReadWord(handle, 0x0);
DapiReadLong
This command executes a direct register read command on the module.
Description
This command executes a direct register read command on the module.
Definition
ULONG DapiReadLong(ULONG handle, ULONG adress);
Parameter
handle=This is the handle of an open module
adress=Address to be accessed
Return value
Content of the register to be read (32-bit)
Remark
This should only be used by experienced programmers. This allows direct access to all available registers.
Programming example
// Reads 32 bits from the address 0x0
ULONG data;
data = DapiReadLong(handle, 0x0);
DapiReadLongLong
This command executes a direct register read command on the module.
Description
This command executes a direct register read command on the module.
Definition
ULONGLONG DapiReadLongLong(ULONG handle, ULONG address);
Parameter
handle=This is the handle of an open module
address=Address to be accessed
Return value
Content of the register to be read (64-bit)
Remark
This should only be used by experienced programmers. This allows direct access to all available registers.
Programming example
// Reads 64 bits from the address 0x0
ULONGLONG data;
data = DapiReadLongLong(handle, 0x0);
Analog input functions
DapiADSetMode
This command configures the voltage range for an A/D converter.
Description
This command configures the voltage range for an A/D converter.
Definition
void DapiADSetMode(ULONG handle, ULONG ch, ULONG mode);
Parameter
handle=This is the handle of an open module
ch=Indicates the channel of the A/D converter (0 .. )
mode=Indicates the mode for the channel
Return value
None
Remark
The following modes are supported:
(these depend on the A/D module used)
Unipolar voltages (does not apply to modules of the CAN-Box series)
DAPI_ADDA_MODE_16BIT_UNIPOL_10V
DAPI_ADDA_MODE_16BIT_UNIPOL_5V
DAPI_ADDA_MODE_16BIT_UNIPOL_2V5
Unipolar voltages of the CAN-Box series
DAPI_ADDA_MODE_16BIT_UNIPOL_40V
(nur CAN-Box 24V-Version)
DAPI_ADDA_MODE_16BIT_UNIPOL_60V
(nur CAN-Box 48V-Version)
Bipolar voltages
DAPI_ADDA_MODE_16BIT_BIPOL_10V
DAPI_ADDA_MODE_16BIT_BIPOL_5V
DAPI_ADDA_MODE_16BIT_BIPOL_2V5
Currents
DAPI_ADDA_MODE_16BIT_0_20mA
DAPI_ADDA_MODE_16BIT_4_20mA
DAPI_ADDA_MODE_16BIT_0_24mA
DAPI_ADDA_MODE_16BIT_0_50mA
Programming example
// Sets channel 0 to 0 ... 10V mode
DapiADSetMode(handle, 0, DAPI_ADDA_MODE_16BIT_UNIPOL_10V);
DapiADGetMode
This command reads back the set mode of an A/D converter. For a mode description, see DapiADSetMode.
Description
This command reads back the set mode of an A/D converter. For a description of the mode, see DapiADSetMode.
Definition
ULONG DapiADGetMode(ULONG handle, ULONG ch);
Parameter
handle=This is the handle of an open module
ch=Indicates the channel of the A/D converter (0 .. )
Return value
Mode of the A/D converter
Programming example
// Reads back the current mode of channel 1
unsigned long mode;
mode = DapiADGetMode(handle, 0);
// Check mode
if(mode == DAPI_ADDA_MODE_16BIT_UNIPOL_10V)
{
printf("Mode is 0 .. 10V");
}
DapiADGet
This command reads a data value from a channel of an A/D converter.
Description
This command reads a data value from a channel of an A/D converter.
Definition
ULONG DapiADGet(ULONG handle, ULONG ch);
Parameter
handle=This is the handle of an open module
ch=Indicates the channel of the A/D converter (0 .. )
Return value
Value from the A/D converter in digits
Remark
The value read back must be interpreted based on the set mode. If the mode is set to 0 ... 10V, a value of 0x8000 corresponds to 5V. However, if the mode is set to -10 ... 10V mode is set, the value 0x8000 corresponds to 0V.
Programming example
// Reads the value of channel 1
unsigned long data;
data = DapiADGet(handle, 0);
DapiADGetVolt
This command reads a data value from one channel of an A/D converter in volts.
Description
This command reads a data value from one channel of an A/D converter in volts.
Definition
float DapiADGetVolt(ULONG handle, ULONG ch);
Parameter
handle=This is the handle of an open module
ch=Indicates the channel of the A/D converter (0 .. )
Return value
Value from the A/D converter in volts
Programming example
// Reads the value of channel 1 in volts
float data;
data = DapiADGetVolt(handle, 0);
DapiADGetmA
This command reads a data value of a channel of an A/D converter in mA.
Description
This command reads a data value of a channel of an A/D converter in mA.
Definition
float DapiADGetmA(ULONG handle, ULONG ch);
Parameter
handle=This is the handle of an open module
ch=Indicates the channel of the A/D converter (0 .. )
Return value
Value from A/D converter in mA
Remark
This command is module-dependent. Of course, it only works if the module also supports current mode.
Programming example
// Reads the value of channel 1 in mA
float data;
data = DapiADGetmA(handle, 0);
DapiReadMultipleAD
This command saves the values of certain neighboring channels of an A/D converter simultaneously in an intermediate buffer. The values can then be read out one after the other.
Description
This command saves the values of certain neighboring channels of an A/D converter simultaneously in an intermediate buffer.
The values can then be read out one after the other. The advantage of this is that the A/D values are buffered simultaneously and the values can then be queried more quickly (compared to the DapiADGet command).
Definition
void DapiSpecialCommand(ULONG handle, DAPI_SPECIAL_CMD_AD, DAPI_SPECIAL_AD_READ_MULTIPLE_AD, ULONG start_ch, ULONG end_ch);
Parameter
handle=This is the handle of an open module.
start_ch=Specifies the start channel of the A/D converter from which the values are buffered (0, 1, 2, ..).
end_ch=Specifies the end channel of the A/D converter up to which the values are buffered (0, 1, 2, ...).
Return value
None
Remark
The values buffered with the DapiReadMultipleAD command can then be read with the DapiADGetVolt, DapiADGetmA or DapiADGet commands. To ensure that the buffered value is actually read, the parameter "ch" must be logically linked with 0x8000 "or" for these functions (see examples).
Programming example
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_AD, DAPI_SPECIAL_AD_READ_MULTIPLE_AD, 0, 15);
// Buffers the values of A/D channel 0..15
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_AD, DAPI_SPECIAL_AD_READ_MULTIPLE_AD, 0, 63);
// Buffers the values of A/D channel 0..63
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_AD, DAPI_SPECIAL_AD_READ_MULTIPLE_AD, 16, 31);
// Buffers the values of A/D channel 16..31
value = DapiADGetVolt(handle, 0x8000 | 0);
// Returns the buffered value of A/D channel 0 in volts.
value = DapiADGetmA(handle, 0x8000 | 15);
// Returns the buffered value of A/D channel 15 in mA.
value = DapiADGet(handle, 0x8000 | 63);
// Returns the buffered value of A/D channel 63 in digits.
DapiSpecialADFilterSet
This command can be used to set the A/D filter level of your A/D module.
Explanation
A/D converters with higher resolution are very precise measuring instruments that can detect even the smallest changes in the measurement signal. In practice
it often happens that electrical or electromagnetic disturbance variables affect the measurement signal via the connecting cable and distort it. The measurement signals can be smoothed and optimized with the help of an A/D filter. The software-based filter we use has already been integrated into the microcontroller that controls the A/D converter. Various filter levels can be set by software command and also
read back. The filter principle is based on averaging a sum of measurements. The higher the filter level is selected, the more measurements are used to calculate the average value. However, this also means that the sampling rate of the A/D converter is reduced as the filter level increases.
Description
This command can be used to set the A/D filter level of your A/D module. Depending on the module, the adjustable filter level may vary.
For a module with several submodules, the A/D filter level can be determined individually for each submodule.
If a 0 is transferred as the filter level, the filter level is deactivated.
Definition
void DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_AD, cmd, par1, par2);
Parameter
handle=This is the handle of an open module.
cmd=DAPI_SPECIAL_AD_FILTER_SET
par1=((filterlevel & 0xff) << 8) | (submodule_nr & 0xff)
filterlevel: specifies which filter level is to be set
submodule_nr: specifies the submodule on which the filter is to be set.
If the module has no submodules, the value 0xff is passed.
par2 = 0
Return value
None.
Remark
Each time the module is restarted, the A/D filter is initially switched off and can be
can be activated if required. It is therefore advisable to activate the A/D filter in the
initialization of your project.
Programming example
filterlevel = 10
submodule_nr = 0
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_AD,
DAPI_SPECIAL_AD_FILTER_SET, ((filterlevel & 0xff) << 8)
| (submodule_nr & 0xff) , 0);
// A/D filter of submodule 0 is set to 10
filterlevel = 5
submodule_nr = 3
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_AD,
DAPI_SPECIAL_AD_FILTER_SET, ((filterlevel & 0xff) << 8)
| (submodule_nr & 0xff) , 0);
// A/D filter of submodule 3 is set to 5
filterlevel = 6
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_AD,
DAPI_SPECIAL_AD_FILTER_SET, ((filterlevel & 0xff) << 8)
| (0xff & 0xff) , 0);
// A/D filter of the main module is set to 6 (only for modules without
submodule)
filterlevel = 2
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_AD,
DAPI_SPECIAL_AD_FILTER_SET, ((filterlevel & 0xff) << 8)
| (0xff & 0xff) , 0);
// A/D filter of the main module is set to 2 (only for modules without
submodule)
DapiSpecialADFilterGet
This command can be used to read out the A/D filter level of the A/D module.
Description
This command can be used to read out the A/D filter level of the A/D module.
For a module with submodules, the submodule number must be transferred.
Definition
void DT.Delib.DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_AD, cmd, par1, par2);
Parameter
handle=This is the handle of an open module.
cmd=DAPI_SPECIAL_AD_FILTER_GET
par1=(submodule_nr & 0xff)
submodule_nr: specifies the submodule from which the filter is to be read.
If the module has no submodules, the value 0xff is transferred
par2 = 0
Return value
A/D filter level
Programming example
unsigned long filterlevel = DapiSpecialCommand(handle,
DAPI_SPECIAL_CMD_AD, DAPI_SPECIAL_AD_FILTER_GET, (0 &
0xff) , 0);
// A/D filter of submodule 0 is read
unsigned long filterlevel = DapiSpecialCommand(handle,
DAPI_SPECIAL_CMD_AD, DAPI_SPECIAL_AD_FILTER_GET, (5 &
0xff) , 0);
// A/D filter of submodule 5 is read
unsigned long filterlevel = DapiSpecialCommand(handle,
DAPI_SPECIAL_CMD_AD, DAPI_SPECIAL_AD_FILTER_GET, (0xff
& 0xff) , 0);
// A/D filter of the main module is read(only for modules without
submodule)
DapiSpecialADMittelwertValueSet
This command can be used to set the time interval in seconds for averaging your A/D module.
Explanation
This function can be used to smooth measured values and reduce random fluctuations or noise in the A/D signal.
By averaging over an adjustable time period, more stable and better comparable results are obtained.
A key feature is the flexible adjustment of the time period in seconds, allowing the smoothing to be optimally adapted to different requirements.
Description
This command can be used to set the time interval in seconds for averaging your A/D module. Within this time, the recorded measured values are collected and combined into an average value.
For a module with multiple submodules, the averaging time interval can be defined individually for each submodule.
Definition void DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_AD, cmd, par1, par2);
Parameters
handle = This is the handle of an opened module.
cmd = DAPI_SPECIAL_AD_MITTELWERT_VALUE_SET
par1 = ((average& 0xff) << 8) | (submodule_nr & 0xff)
average = Specifies after how many seconds the average of the A/D measurements is to be calculated.
submodule_nr = Specifies on which submodule the averaging is to be applied. If the module has no submodules, the value 0xff is passed.
par2 = 0
Return value
None.
Note
After each restart of the module, A/D averaging is initially disabled and can be activated if required. It is therefore recommended to define A/D averaging during the initialization of your project.
Programming example
average = 10
submodule_nr = 2
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_AD,
DAPI_SPECIAL_AD_MITTELWERT_VALUE_SET, ((average& 0xff) << 8)
| (submodule_nr & 0xff) , 0);
// The average of all received A/D values from submodule 2 is calculated after 10 seconds
average = 5
submodule_nr = 3
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_AD,
DAPI_SPECIAL_AD_MITTELWERT_VALUE_SET, ((average& 0xff) << 8)
| (submodule_nr & 0xff) , 0);
// The average of all received A/D values from submodule 3 is calculated after 5 seconds
average = 6
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_AD,
DAPI_SPECIAL_AD_MITTELWERT_VALUE_SET, ((average& 0xff) << 8)
| (0xff & 0xff) , 0);
// The average of all received A/D values of the main module is calculated after 6 seconds (only for modules without submodule)
average = 2
DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_AD,
DAPI_SPECIAL_AD_MITTELWERT_VALUE_SET, ((average& 0xff) << 8)
| (0xff & 0xff) , 0);
// The average of all received A/D values of the main module is calculated after 2 seconds (only for modules without submodule)
DapiSpecialADMittelwertValueGet
This command can be used to read out the time interval used for A/D averaging.
Description
This command can be used to read out the time interval used for A/D averaging.
For a module with submodules, the submodule number must be provided.
Definition void DT.Delib.DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_AD, cmd, par1, par2);
Parameters
handle = This is the handle of an open module.
cmd = DAPI_SPECIAL_AD_MITTELWERT_VALUE_GET
par1 = (submodule_nr & 0xff)
submodule_nr = Specifies the submodule from which the time interval for averaging is to be read. If the module has no submodules, the value 0xff is passed.
par2 = 0
Return value
Time interval for averaging in seconds.
Programming example
submodule_nr = 2
unsigned long average = DapiSpecialCommand(handle,
DAPI_SPECIAL_CMD_AD, DAPI_SPECIAL_AD_MITTELWERT_VALUE_GET, (0 &
0xff) , 0);
// Time interval in seconds for averaging for submodule 2 is read out
submodule_nr = 5
unsigned long average = DapiSpecialCommand(handle,
DAPI_SPECIAL_CMD_AD, DAPI_SPECIAL_AD_MITTELWERT_VALUE_GET, (5 &
0xff) , 0);
// Time interval in seconds for averaging for submodule 5 is read out
unsigned long average = DapiSpecialCommand(handle,
DAPI_SPECIAL_CMD_AD, DAPI_SPECIAL_AD_MITTELWERT_VALUE_GET, (0xff
& 0xff) , 0);
// Time interval in seconds for averaging of the main module is read out (only for modules without submodule)
DapiSpecialADMittelwertCounterGet
This command can be used to read the currently elapsed time in seconds used for averaging.
This command can be used to read the currently elapsed time in seconds used for averaging.
For a module with submodules, the submodule number must be provided.
Definition void DT.Delib.DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_AD, cmd, par1, par2);
Parameters
handle = This is the handle of an open module.
cmd = DAPI_SPECIAL_AD_MITTELWERT_COUNTER_GET
par1 = (submodule_nr & 0xff)
submodule_nr = Specifies the submodule from which the elapsed averaging time is to be read. If the module has no submodules, the value 0xff is passed.
par2 = 0
Return value
Time span for averaging in seconds.
Programming example
submodule_nr = 2
unsigned long elapsed_time = DapiSpecialCommand(handle,
DAPI_SPECIAL_CMD_AD, DAPI_SPECIAL_AD_MITTELWERT_COUNTER_GET, (0 &
0xff) , 0);
// The already elapsed averaging time is read for submodule 2
submodule_nr = 5
unsigned long elapsed_time = DapiSpecialCommand(handle,
DAPI_SPECIAL_CMD_AD, DAPI_SPECIAL_AD_MITTELWERT_COUNTER_GET, (5 &
0xff) , 0);
// The already elapsed averaging time is read for submodule 5
unsigned long elapsed_time = DapiSpecialCommand(handle,
DAPI_SPECIAL_CMD_AD, DAPI_SPECIAL_AD_MITTELWERT_COUNTER_GET, (0xff
& 0xff) , 0);
// The already elapsed averaging time of the main module is read (only for modules without submodule)
Error handling
DapiGetLastError
This function returns the last error recorded.
Description
This function returns the last recorded error. If an error has occurred, it must be cleared with DapiClearLastError(), otherwise every call to DapiGetLastError() will return the "old" error.
If several modules are to be used, the use of DapiGetLastErrorByHandle() is recommended.
Definition
ULONG DapiGetLastError(void);
Parameter
None
Return value
Error code
0=no error. (see delib_error_codes.h)
Programming example
BOOL IsError()
{
unsigned char msg[500];
unsigned long error_code = DapiGetLastError();
if (error_code != DAPI_ERR_NONE)
{
DapiGetLastErrorText((unsigned char*) msg, sizeof(msg));
printf("Error Code = 0x%x * Message = %s\n", error_code, msg);
DapiClearLastError();
return TRUE;
}
return FALSE;
}
DapiGetLastErrorByHandle
This function returns the last error recorded for a specific module using the handle.
Description
This function returns the last error recorded for a specific module using the handle. If an error has occurred, it must be cleared with DapiClearLastErrorByHandle(), otherwise every call to DapiGetLastErrorByHandle() will return the "old" error.
Definition
ULONG DapiGetLastErrorByHandle(ULONG handle);
Parameter
handle=This is the handle of an open module
Return value
Error code
0=no error. (see delib_error_codes.h)
Programming example
BOOL IsError(ULONG handle)
{
unsigned long error_code = DapiGetLastErrorByHandle(handle);
if (error_code != DAPI_ERR_NONE)
{
printf("Error detected on handle 0x%x - Error Code = 0x%x\n", handle, error_code);
DapiClearLastErrorByHandle(handle);
return TRUE;
}
return FALSE;
}
DapiGetLastErrorText
This function reads out the text of the last error recorded.
Description
This function reads out the text of the last recorded error. If an error has occurred, it must be cleared with DapiClearLastError(), otherwise every call to DapiGetLastErrorText() will return the "old" error.
Definition
ULONG DapiGetLastErrorText(unsigned char * msg, unsigned long msg_length);
Parameter
msg = Buffer for the text to be received
msg_length = Length of the text buffer
Programming example
BOOL IsError()
{
unsigned char msg[500];
unsigned long error_code = DapiGetLastError();
if (error_code != DAPI_ERR_NONE)
{
DapiGetLastErrorText((unsigned char*) msg, sizeof(msg));
printf("Error Code = 0x%x * Message = %s\n", error_code, msg);
DapiClearLastError();
return TRUE;
}
return FALSE;
}
DapiClearLastError
This function deletes the last error that was recorded with DapiGetLastError().
Description
This function deletes the last error that was recorded with DapiGetLastError().
Definition
void DapiClearLastError(void);
Parameter
None
Return value
None
Programming example
BOOL IsError()
{
unsigned char msg[500];
unsigned long error_code = DapiGetLastError();
if (error_code != DAPI_ERR_NONE)
{
DapiGetLastErrorText((unsigned char*) msg, sizeof(msg));
printf("Error Code = 0x%x * Message = %s\n", error_code, msg);
DapiClearLastError();
return TRUE;
}
return FALSE;
}
DapiClearLastErrorByHandle
This function deletes the last error of a specific module (handle) that was recorded with DapiGetLastErrorByHandle().
Description
This function deletes the last error of a specific module (handle) that was registered with DapiGetLastErrorByHandle().
Definition
void DapiClearLastErrorByHandle(ULONG handle);
Parameter
handle=This is the handle of an open module.
Return value
None
Programming example
BOOL IsError(ULONG handle)
{
unsigned long error_code = DapiGetLastErrorByHandle(handle);
if (error_code != DAPI_ERR_NONE)
{
printf("Error detected on handle 0x%x - Error Code = 0x%x\n", handle, error_code);
DapiClearLastErrorByHandle(handle);
return TRUE;
}
return FALSE;
}
Test functions
DapiPing
This command checks the connection to an open module.
Description
This command checks the connection to an open module.
Definition
ULONG DapiPing(ULONG handle, ULONG value);
Parameter
handle=This is the handle of an open module
value=Transferred test value, in the value range of 0-255 (8-bit), to the module
Return value
The test value transferred with "value" must be returned here
Web interface
All DEDITEC products with an Ethernet interface have a graphical web interface that allows you to access the module directly. No apps or additional programs are required for operation other than an Internet browser. You can easily log in to the module from any smartphone, PC, or tablet to manage the device, check status values, or switch outputs.
The integrated user menu allows you to assign a password to prevent unauthorized access to the module. You can also configure network settings and run various services.
The following I/O functions are currently accessible via the web interface:
- Digital inputs: Query statuses, read counters
- Digital outputs: Switch outputs on or off
- Analog inputs: Reading voltage and current values
- Analog outputs: Output voltage and current values
General
The board name of the module can be entered here, which can be used to address the module via DHCP.
The IP protection function prevents the IP address from being read.
Network configuration
All network settings for the module can be configured directly in the "Network configuration" menu.
User management
In the "User management" menu, you can set the login details for accessing the web interface.
Using the "Session valid time" entry, you can specify the period of inactivity after which the user should be automatically logged out.
Status / Reboot
In the "Status / Reboot" menu, you can check the currently installed firmware version, reset the module to factory settings, and perform a restart.
Digital Inputs
The image shows a list of the first 16 digital inputs (CH0 ... CH15) of the module. Depending on the module variant, the next 16 inputs can be displayed via a drop-down menu.
The "State" column indicates whether the signal state at the respective input is high (ON) or low (OFF).
The counted pulses can be read via the "Counter Value." The counter reading is reset to 0 after each hard reset.
Digital Outputs
The image shows a list of the first 16 digital outputs (CH0 ... CH15) of the module. Depending on the module variant, the next 16 outputs can be displayed via a drop-down menu.
An on/off button allows the outputs to be switched on or off individually or all together.
The actual switching status of the outputs can be read back via the "Readback" column.
Analog Inputs
The desired operating mode can be set using the “A/D Mode” drop-down menu.
Analog Outputs
The desired D/A mode is selected via a drop-down menu.
The desired current or voltage value is then entered manually in the "Value" field and written to the outputs via the "SET" button.
The "Readback" column shows the current voltage or current output of the D/A converter.
I/O-Control APP for Android™
Features:
- Separate storage of network settings for private and public networks
- Better clarity thanks to configurable I/O names
- Configurable refresh of all I/Os
The following I/Os are supported:
- up to 128 analog inputs (0..10V, 0..5V, +/- 10V, and +/- 5V)
- up to 64 analog outputs (0..10V, 0..5V, +/- 10V, and +/- 5V)
- up to 128 digital inputs and outputs
Network settings
Module configuration
You can also select which I/Os are to be controlled here.
Digital inputs
The digital inputs are polled at an adjustable interval.
Digital outputs
In the digital outputs section, the channels can be switched on or off individually. It is also possible to switch all channels on or off.
Analog inputs
For the analog inputs, you can choose from the measuring ranges 0..10V, 0..5V, +/- 10V, or +/- 5V. The A/D channels are queried automatically at a configurable interval.
Analog outputs
Here you can set analog outputs in the measuring range 0..10V, 0..5V, +/- 10V, or +/- 5V.
Settings
This image shows the settings for analog outputs. Here, each channel can be given a name.
In addition, you can specify here whether and at what intervals the analog outputs are read back.
These settings are available for all I/Os.
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.
Step 2
Insert the operating tool firmly into the side opening in the direction of the conductor connection.
Step 3
Now insert the stripped conductor into the open clamp contact.
Step 4
Pull out the operating tool again.
Step 5
Check that the conductor is properly connected. It should now no longer be possible to pull it out easily.
Manual
Manual UC series
Quickstart - Hardware description - Software description - ICT-Tool
- 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
ICT-Tool + DELIB for Windows (64-bit)
For Windows 11/10, Windows 7, Windows 8, Vista, XP and 2000
Software package for the 64-bit version of the ICT-Tool and the DELIB driver library.
The following operating systems are compatible:
64-bit:
- Windows 10/11 x64
- Windows 8 x64
- Windows 7 x64
- Windows Server 2012 x64
- Windows Server 2008 x64
- Windows Vista x64
- Windows XP x64
- Windows Server 2003 x64
- Windows 2000 x64
Supplied software
ICT-Tool x64
- Updating the DEDITEC module-firmware
- Assigning module addresses
- Module-specific settings
- Configuration of CAN modules
- Test and diagnosis of module functions
- Configuration of the watchdog stick
Replaces the following software
- DT-Flasher x64
- DELIB Module Demo x64
- CAN Configuration Utility x64
- DELIB Module Config x64
- DELIB Configuration Utility x64
- Watchdog Configuration Utility x64
DELIB Command Line Interface x64
Enables the execution of DELIB commands in the command line.
ICT-Tool + DELIB for Windows (32-bit)
For Windows 11/10, Windows 7, Windows 8, Vista, XP and 2000
Software package for the 32-bit version of the ICT-Tool and the DELIB driver library.
The following operating systems are compatible:
32-bit:
-
-
- Windows 10/11
- Windows 8
- Windows 7
- Windows Server 2012
- Windows Server 2008
- Windows Vista
- Windows XP
- Windows Server 2003
- Windows 2000
-
Supplied software
ICT-Tool x32
-
-
- Updating the DEDITEC module-firmware
- Assigning module addresses
- Module-specific settings
- Configuration of CAN modules
- Test and diagnosis of module functions
- Configuration of the watchdog stick
-
Replaces the following software
-
-
- DT-Flasher
- DELIB Module Demo
- CAN Configuration Utility
- DELIB Module Config
- DELIB Configuration Utility
- Watchdog Configuration Utility
-
Attention:
With this version of the driver library, only 32-bit applications can be created, which can then be executed on 32- and 64-bit systems.
DELIB driver library for Linux (32/64-bit)
For 32/64-bit Linux distributions from kernel 2.6.x. Version 2.73 from 28.10.2024
DELIB driver library for Linux distributions (32/64-bit) from kernel 2.6.x
This driver package contains the following components
- DELIB USB driver
- DELIB Ethernet driver
- DELIB CLI
DELIB USB driver
Support for the following products:
- NET series (via USB interface)
- RO-USB series
- BS-USB series
- USB mini-sticks
- USB watchdog
- USB-OPTION-8 / USB-RELAY-8
- USB-TTL-32 / USB-TTL-64
Note:
With the standard version of the USB driver, several USB products with different module IDs (e.g. one RO-USB and one USB-OPTOIN-8) can be addressed. No further driver installation is required.
If several USB products with the same module ID (e.g. a USB-OPTOIN-8 and a USB-RELAIS-8) are to be addressed, the Linux FTDI driver must also be installed. You can find the FTDI driver at http://www.ftdichip.com.
DELIB Ethernet driver
Support for the following products:
- NET series (via Ethernet interface)
- RO-ETH series
- RO-ETH/LC series
- BS-ETH series
- ETH-OPTION-8 / ETH-RELAY-8
- ETH-TTL-64
DELIB CLI
With the DELIB CLI (Command Line Interface) for Linux, all commands for digital and analog I/Os can be set directly via the command line
Manual
Manual for ICT-Tool and DELIB
Software Description - ICT-Tool - DELIB API Reference
Software Description
- Control options via DELIB, protocol level, DELIB CLI, graphical applications
- DELIB driver library, DELIB sample sources, DELIB for Linux
- Web interface (only for Ethernet modules)
- DELIB API and its functions
ICT-Tool
- Add module to PC
- Configure module/interface (Ethernet, USB, CAN, Serial)
- Settings for M2M and Event Control (only for supported modules)
- Test and diagnose module
- Install firmware updates
- Save/load module configurations using a separate file
DELIB API Reference
- Directory structure of DELIB
- Management functions
- Error handling
- Manage digital inputs and outputs
- Manage analog inputs and outputs
- Manage software FIFO
- Manage output timeout
- Register read and write commands
Download
Hardware updates (firmware flash file package)
Firmware flash file package for the ICT tool
This package contains the latest firmware files for the following product series:
- STARTER series
- BS series
- RO series
- NET series
- UC series
- CAN-IO-Box
- Development accessories
The firmware flash file package can alternatively be downloaded via the ICT tool.
5-pin plug connector
Enables the power supply to be connected to the DEDITEC module.
- Type: Phoenix Contact® - 1876343
- 100 % mismatch protected
- For all conductor types from 0.2 mm² to 2.5 mm²
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²
Actuating tool for Wago connectors
Used to open and close the terminal contacts on the WAGO® connectors.
- Type: WAGO® - 734-231
5-pin plug connector
Enables the power supply to be connected to the DEDITEC module.
- Type: Phoenix Contact® - 1876343
- 100 % mismatch protected
- For all conductor types from 0.2 mm² to 2.5 mm²
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²
Actuating tool for Wago connectors
Used to open and close the terminal contacts on the WAGO® connectors.
- Type: WAGO® - 734-231
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
Top hat rail
Top-hat rail for mounting our control technology modules.
- DIN rail according to DIN EN 50022
- Type: Phoenix Contact® - 1208131
- Dimensions in mm: 450 x 35 x 7.5 (L x W x H)
24V/2A power supply unit for top-hat rail mounting
The DR-4524 from Mean Well is a 48W power supply unit for DIN rail mounting for industrial applications. It offers protection against short circuit, overload, overvoltage and overheating.
- Input voltage range: 85 V.. 264 V AC / 120 V DC ... 370 V DC
- Output voltage: 24 V DC
- Output current: 2 A
- Rated power: 48 W
Typical Application Areas:
- Industrial sensor data acquisition:
The analog inputs are suitable for precise acquisition of physical measurement variables such as pressure, temperature, or fill levels in industrial processes. - Laboratory and testing technology:
The Modbus TCP analog module is ideally suited for experimental setups, data acquisition, and calibrations where high accuracy and reliability are essential. - Process data acquisition in production:
Ideal for capturing continuous process values in manufacturing plants in order to make production workflows transparent and analyzable.
Comparison of UC-ETH-AD2-16ISO with common market products
Interfaces & Communication |
|||
| Feature | Market Comparison | Advantages of the DEDITEC UC-ETH-AD2-16ISO</th > | Practical Benefits of the modules |
|---|---|---|---|
| Supported protocols | Usually only TCP | HTTP, UDP, TCP, DHCP, Modbus‑TCP | Expands application possibilities in modern network and IoT infrastructures. |
| Ethernet Signal Isolation | Not always galvanically isolated | Galvanically isolated Ethernet interface for safe communication | Protects connected systems from interference voltages and increases communication stability in industrial networks. |
| Galvanic isolation of the CAN interface | A galvanically isolated CAN interface is not standard on all devices. | Electrically isolated CAN interface rated up to 500 V for reliable communication in industrial environments. | Improves interference immunity and protects communication in harsh industrial environments. |
Analog inputs |
|||
| Feature | Market Comparison | Advantages of the DEDITEC UC-ETH-AD2-16ISO</th > | Practical Benefits of the modules |
| Current and voltage measurement | Some providers offer only voltage or only current | Both signal types supported | Enables the use of different sensor types without additional signal converters, thereby reducing hardware and wiring costs. |
| Resolution and accuracy | Typically 8–12 bit | High‑resolution 16‑bit for precise signal control | Improves measurement accuracy and enables reliable evaluation of even small signal changes. |
| Firmware filtering | External filtering required | Smoothing and averaging directly in the module; filters adjustable | Reduces measurement noise and ensures more stable input values without external filter hardware. |
| Galvanic isolation | Often, there is no isolation from the power supply | Electrical isolation for the module’s power supply | Protects connected systems from interference voltages and prevents interactions between measurement circuits and the power supply. |
| Galvanic isolation between all channels | Often a common reference potential for all channels | Galvanic isolation up to 500 V between all channels | Enables measurements in environments with different reference potentials and prevents compensation currents between channels. |
Automation & Diagnostics |
|||
| Feature | Market Comparison | Advantages of the DEDITEC UC-ETH-AD2-16ISO</th > | Practical Benefits of the modules |
| Remote access | Barely possible | Direct access via web and Modbus‑TCP | Allows for configuration and monitoring without physical presence, thereby supporting efficient maintenance processes. |
| Diagnostic tools | Mostly not available | Extensive diagnostic capabilities integrated in the ICT tool | Simplifies commissioning, troubleshooting, and long-term analysis through centralized, integrated diagnostic functions. |
| Automated control and monitoring | Additional control PC required | Configurable event control enables automated process monitoring without a control PC | Reduces the need for external control logic and enables automated processes directly within the module. |
| High reliability thanks to M2M functionality | A control PC is required | Built-in M2M functionality enables autonomous operation without a PC | Ensures continued operation even in the event of a control PC failure and increases system availability. |
Hardware flexibility |
|||
| Feature | Market Comparison | Advantages of the DEDITEC UC-ETH-AD2-16ISO</th > | Practical Benefits of the modules |
| Supply voltage | Usually fixed (e.g., +24 V) | Flexible +12 V DC … +28 V DC | Facilitates use in various power supply configurations and reduces the need for additional power supplies. |
| EMC stability | Low-cost OEM modules often susceptible to interference | Industrial‑grade EMC design | Ensures low-interference operation in industrial environments with high electromagnetic interference. |
Software & Integration |
|||
| Feature | Market Comparison | Advantages of the DEDITEC UC-ETH-AD2-16ISO</th > | Practical Benefits of the modules |
| Software integration | Limited drivers | DELIB library for C, C++, C#, Java, VB | Simplifies development through standardized programming interfaces and reduces the effort required for custom driver adaptations. |
| Example programs | Barely available or only upon request | Example programs can be downloaded for free | Accelerates implementation and facilitates the transition to project-specific applications. |
| Firmware updates | Often paid or limited | Free for life | Ensures long-term functionality and enables improvements without additional licensing costs. |
| Example code | Fewer languages or restricted examples | Extensive examples for C, C++, C#, Java, VB, LabView | Supports various development environments and facilitates integration into existing software landscapes. |
| Response times | Partially higher latency with standard I/O | Very fast firmware | Improves real-time performance and enables reliable processing of time-critical signals. |
| System integration | Proprietary systems complicate integration | Easy integration into PLCs, PCs, and test benches | Facilitates integration into existing automation and test systems without extensive modifications. |
| Test system integration | Competitors often more expensive or less flexible | Ideal for automotive and test bench applications | Supports reproducible measurement and test procedures and reduces integration effort in complex test bench environments. |
Mechanical & physical properties |
|||
| Feature | Market Comparison | Advantages of the DEDITEC UC-ETH-AD2-16ISO</th > | Practical Benefits of the modules |
| Mounting | Depending on the supplier, different or less standard designs may be used. | Mounting on a 35 x 7.5 mm DIN rail for use in control cabinets and decentralized I/O systems. | Enables quick and standards-compliant integration into existing control cabinets. |
Reliability |
|||
| Feature | Market Comparison | Advantages of the DEDITEC UC-ETH-AD2-16ISO</th > | Practical Benefits of the modules |
| Long-term availability | Typically 3–5 years | 10‑year guaranteed availability | Simplifies long-term plant planning and reduces risks associated with early product discontinuations. |
| Firmware updates | Often paid or limited | Free for life | Ensures continuous functional improvement without additional operating costs. |
| ICT tool | Often multiple tools, fewer functions | One tool for commissioning, diagnostics, loopback testing, long‑term simulation | Simplifies commissioning, diagnostics, and testing procedures through a centralized software solution. |
| Production location | Many manufacturers produce in Asia | Made in Germany | Enables short supply chains, consistent quality assurance, and a reliable supply of spare parts. |
| MTBF | Low-cost OEM modules with shorter lifespan | High MTBF values | Reduces the probability of failure and increases availability in continuous-operation applications. |
| Failure rate | Higher failure rates with low‑cost I/O | Very low field failure rates | Minimizes unplanned downtime and reduces maintenance and service costs. |
| Spare parts availability | Often early discontinuation | Long‑term spare parts availability | Facilitates maintenance and modernization of existing systems over many years. |
Service and support |
|||
| Feature | Market Comparison | Advantages of the DEDITEC UC-ETH-AD2-16ISO</th > | Practical Benefits of the modules |
| Support quality | Call centers or external service providers | Direct developer support | Enables fast and technically sound problem-solving without the need to escalate issues through external service providers. |
| Response time | Sometimes several days | Very fast response, often same day | Reduces downtime and speeds up the restoration of system operations when technical issues arise. |
| Customization | Rare or very expensive | Custom hardware/firmware possible | Enables project-specific solutions without the need for time-consuming in-house development or additional hardware components. |
| Documentation | Often minimal or incomplete | Comprehensive and practical documentation | Simplifies commissioning and reduces the need for follow-up inquiries thanks to clearly structured and comprehensive technical documentation. |
| Consulting | Often only sales support | Technicians instead of general sales staff | Ensures application-oriented support directly tailored to technical requirements. |
Economy |
|||
| Feature | Market Comparison | Advantages of the DEDITEC UC-ETH-AD2-16ISO</th > | Practical Benefits of the modules |
| Price-performance ratio | Major brands significantly more expensive | Very good price‑performance ratio | Reduces total cost per channel and enables cost-effective system expansions. |
| License costs | Modbus/features often require additional payment | No additional costs for protocols | Simplifies cost planning and prevents unexpected follow-up costs associated with functional or protocol expansions. |
| Series prices | Large manufacturers often inflexible | Attractive volume pricing | Simplifies budget planning for larger volumes and enables cost-effective scaling of projects. |
Install the installation program and check the module functions.



























