RS-232/RS-485 module with 8/16/32/64 * inputs and 8/16/32/64 * outputs

0 customer reviews

ab  776,48

 
To our advantages

 

New feature!

Extended input filter for Digital-IN / Timeout protection function for Digital-Out.
For more information, see the Description and Technical Data tabs!

Availability: In Stock SKU: RO-SER-O8-64-R8-64 Category:

The RO-SER-O8-64-R8-64 module is available in versions with 8, 16, 32 or 64 inputs and outputs. For the digital inputs AC optocouplers are used, while reed relays were used for the digital outputs. The serial standards RS-232 or RS-485 are available as interfaces. In addition, the existing USB 2.0 port can also be used.

  • RS-232/RS-485 interface with galvanic isolation
  • Open RS-232/485 protocol, plain text mode
  • USB 2.0 interface with up to 480 Mbit
  • 8/16/32/64 Digital inputs: 15V – 30V AC/DC (optional 5V – 15V)
  • 8/16/32/64 relay outputs: 1A
  • 16 bit counter per input channel (up to 100Hz)
  • LED status display per input and output channel
  • Timeout protection function

Digital inputs

With our optocoupler inputs, digital signal states can be recorded within a voltage range of 5V to 30V AC or DC. Input and output circuits are galvanically isolated from each other up to 2.5kV.

 

Digital In Input Filter

With our Digital-In modules, an input filter can be set in a time interval of 1ms…255ms to filter interference pulses.

This means that AC signals can also be detected cleanly.

 

Counter

Each input has a 16 bit counter that can count up to 65535 pulses. If the maximum counter value is exceeded, the counting process starts again from zero. By means of a software command, the current status of all input counters can be read from the module simultaneously.

 

Recording of status changes

Status changes that occur between the readout cycles are reliably detected by internal flip-flops and can be read out separately by software. In addition, such an event is signalled by a status LED. Resetting is done automatically after the flip-flops have been read out.


Relais 1A

With the option “Relay outputs (1A)” reed relays with normally open (NO) function are used. They are suitable for smaller switching capacities of up to 1A and have a service life of well over 100 million switching cycles. The electrical isolation between input and output circuit is up to 1.5kV.

 

Fail-safe mode

The fail-safe mode is a safety function in which the DEDITEC module switches to a previously configured, safe switching state in the event of a connection failure.
This is intended to prevent connected installations or systems from continuing to run in an uncontrolled manner.

 

Three switching states can be defined for each digital output: a) Switched off, b) Switched on or c) Unchanged.

 

The fail-safe circuit is triggered by a timeout protection function. If the control unit no longer receives any commands from the control PC within a previously defined period of time, the timeout function comes into effect. The cause of a timeout can be a loss of connection between the control PC and the DEDITEC control system or failure of the control PC.

 

Timeout modes

Three timeout modes are available:

 

A) “Normal mode” is valid once and must be reactivated manually by software command after each timeout event. The customer application still has access to all controller outputs.

 

B) In “Auto reactivate mode”, the timeout function is automatically reactivated after communication with the control PC has been re-established. The customer application still has access to all outputs of the control unit.

 

C) The “Secure outputs mode” blocks access to the outputs after the timeout event. Unlocking can only be carried out by software command. This is an important safety aspect


LEDs

Each digital input and output has a separate LED that lights up when the signal state is active. Furthermore, the status of the operating voltage, the communication with the interface, error events or the occurrence of a timeout can be displayed.


Connectors

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 eject and locking mechanism. All conductor types up to 1.5mm² can be connected.


Software and control

Our DELIB driver library, which is included with the product, makes it easy to address the product via our API.

 

We offer support for the following programming languages:

  • C
  • C++
  • C#
  • VB
  • VBA
  • VB.Net
  • Java
  • Delphi
  • LabVIEW

We offer support for the following operating systems:

  • Windows 10 (32bit/64bit)
  • Windows 8/8.1 (32bit/64bit)
  • Windows 7 (32bit/64bit)
  • Windows Vista (32bit/64bit)
  • Windows XP (32bit/64bit)
  • Windows Server 2003 (32bit/64bit)
  • Windows 2000
  • Linux

Corresponding programming examples can be found in the “Software” section of the products or are included on the driver CD.


General

Power supply + 12V to +24V DC (via two-pin pluggable screw terminal)
LEDs • Operating voltage
• Interface activity
• ERROR
• Input state change(only for digital inputs)
• Timeout shutdown
• I/O access
• One LED per in-/output
Connectors • Type: Wago Kontakttechnik 713-1108/037-000
• Pluggable 16 pole female connector with locking mechanism
• 100 % malfunction protected
• 1-conductor connection for all types of conductors up to 1.5mm²
DIN rail mounting TS 35
Operating temperature +10°C .. +50°C
Dimensions with 8 I/Os 122mm x 85mm x 51,5mm  (HxWxD)
Dimensions with 16 I/Os 122mm x 126 mm x 51,5 mm (HxWxD)
Dimensions with 32 I/Os 122mm x 208 mm x 51,5 mm (HxWxD)
Dimensions with 64 I/Os 122mm x 372 mm x 51,5 mm (HxWxD)

RS-232 / RS-485 – Interface

Interface • RS-232/RS-485
• Baudrate: 300 – 115.200 Baud
• Galvanic isolation up to 500 V
• Connection via 9 pin D-Sub connector
DIP switch • Activating a base configuration (preferential mode with 115kBd, module address = 0)
• Activating  the configuration via DIP switch
• Activating the Text Mode
• Setting the baud rate

USB-Interface

USB-Interface
• Connection: type B
• USB 2.0 / USB 1.1 interface with up to 480Mbit

Digital inputs

Optocoupler inputs • 15V to 30V DC/AC signal voltage (optional 5V – 15V DC/AC)
• Galvanic isolation between input and output circuit : up to 2.5kV AC for 1 minute
• Maximum input current: 14mA
Input filter • Default value 0ms
• Value range 0 (off),  1(ms)…255(ms)
Input counter • 16 bit counter per channel
• Maximum possible counting operations: 65535 / channel
• Reset to zero after memory overflow
• Internal counting logic up to 100Hz
• Programmable filter for input channels (flip-flop and counter):
• Minimum low or high pulse duration: 5ms…255ms
Input state flags (flip-flops) • Detects a change from low to high and high to low level
• Detects the input state change between two readout processes
• Input state flag is reset during readout

Digital outputs

Timeout-Protection-Function • Simple and uncomplicated setting of the timeout protection function possible via software
• Time-definable automatic activation of the timeout protection function in the
Timeout case (between 0.1 seconds and 6553 seconds)
• In the timeout case, digital outputs can be activated, deactivated or left unchanged
• 3 different timeout modes: “normal”, “auto reactive” and “secure outputs” for different procedures in case of a timeout event.
In “secure outputs” timeout mode, access to the outputs is blocked after a timeout event, thus preventing further access to the outputs.
Unlocking must be done by an additional software command.

Relay outputs type II

Relay up to 1A • Typ: SIL05-1A72D
• Property: Normally open contact (NO)
• Max. switching voltage: 36V AC / DC
• Max. switching current: 0.5 A AC / DC
• Max. Transport current: 1A AC / DC
• Max. switching capacity: 10 W
• Galvanic isolation between contact and coil: 1.5 kV RMS /1 min
• Lifetime: up to 100 million switching cycles

Additional information

Weight N/A
Number of digital inputs/outputs

, , ,

 

 

 

General information on the ICT tool

We have developed the new ICT tool to make commissioning our products as easy and straightforward as possible.
This tool combines all the important functions of our old programs, such as the Configuration Utility, Module Demo and DT-Flasher, in one.
With the ICT tool, you can now easily configure, test, diagnose, flash and debug our products.
In the following chapters, we would like to introduce you to our new all-in-one software in more detail.

Module selection

Here you can integrate your modules into the ICT tool by clicking on the “+” symbol, so that you can then configure or test them.


Start screen

Here you can find some important information about your selected module.
In addition, you can display the manual of the module as PDF or HTML version here.
Under “Show module IDs” you can call up all available module IDs. This ID is needed to integrate our products into your software projects.


ICT Treeview

In the treeview on the left side of the program window, you can see the respective forms that are supported by your module.
With a click you can then display this form in the right part of the program and perform possible configurations or tests.

Configuration

Configuration of the serial modules

Our serial modules of the RO-series and NET-series are able to handle the standards RS-232 and RS-485. At delivery the modules are always designed for RS-232 operation, but can be reconfigured to RS-485 by changing the jumper positions on the module. For further information please refer to the manual of the respective product.

 


Setting the RS-232 / RS-485 parameters via DIP switches

By means of DIP switches the following parameters can be set:

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

More details about the control and some programming examples can be found in the programming section.

General Handling

DapiOpenModule
This function opens a particular module.

DapiOpenModule

 

Description

This function opens a specific module

 

Definition

ULONG DapiOpenModule(ULONG moduleID, ULONG nr);

 

Parameters

moduleID=Specifies the module to be opened (see delib.h)
nr=Specifies which one (in case of several modules) should be opened.
nr=0 -> 1st module
nr=1 -> 2nd module

 

Return-Value

handle=Corresponding handle for the module
handle=0 -> module was not found

 

Comment

The handle returned by this function is needed 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(“Modul konnte nicht geöffnet werden\n”);
return;
}

DapiCloseModule
This command closes an opened module.

DapiCloseModule

 

Description

This command closes an open module.

 

Definition

ULONG DapiCloseModule(ULONG handle);

 

Parameters

handle=This is the handle of an open module

 

Return-Value

None

 

Programming example

// Close module
DapiCloseModule(handle);

DapiGetLastError
This function returns the last registered error. If an error has occurred, it must be deleted with DapiClearLastError(), otherwise any call of DapiGetLastError() will return the "old" error. If multiple modules are used, the use of DapiGetLastErrorByHandle() is recommended.

DapiGetLastError

 

Description

This function returns the last detected error. If an error occurred, it must be cleared with DapiClearLastError(), otherwise any call to DapiGetLastError() will return the “old” error.
If more than one module should be used, it is recommended to use DapiGetLastLastErrorByHandle().

 

Definition

ULONG DapiGetLastError(void);

 

Parameters

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 registered error of a particular module (handle). If an error has occurred, it must be deleted with DapiClearLastErrorByHandle(), otherwise any call of DapiGetLastErrorByHandle() will return the "old" error.

DapiGetLastErrorByHandle

 

Description

This function returns the last detected error of a specific module (handle). If an error occurred, it must be cleared with DapiClearLastErrorByHandle(), otherwise any call to DapiGetLastErrorByHandle() will return the “old” error.

 

Definition

ULONG DapiGetLastErrorByHandle(ULONG handle);

 

Parameters

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 the text of the last registered error. If an error has occurred, it must be cleared with DapiClearLastError(), otherwise every call of DapiGetLastErrorText() returns the "old" error. Definition

DapiGetLastErrorText

 

Description

This function reads the text of the last detected error. If an error occurred, it must be cleared with DapiClearLastError(), otherwise any call to DapiGetLastErrorText() will return the “old” error.

 

Definition

ULONG DapiGetLastErrorText(unsigned char * msg, unsigned long msg_length);

 

Parameters

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 registered with DapiGetLastError().

DapiClearLastError

Description

This function deletes the last error registered with DapiGetLastError().

 

Definition

void DapiGetLastError(void);

 

Parameters

None

 

Return value

None

 

Example program

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 particular module (handle), which was registered with DapiGetLastErrorByHandle().

DapiClearLastErrorByHandle

 

Description

This function deletes the last error of a particular module (handle), which was registered with DapiGetLastErrorByHandle().

 

Definition

void DapiClearLastErrorByHandle(ULONG handle);

 

Parameters

handle=This is the handle of an opened module.

 

Return value

None

 

Example program

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

DapiGetDELIBVersion
This function returns the installed DELIB version.

DapiGetDELIBVersion

 

Description

This function returns the installed DELIB version.

 

Definition

ULONG DapiGetDELIBVersion(ULONG mode, ULONG par);

 

Parameters

mode=Mode with which the version is read (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 installed version 1.32 version = 132(hex)

DapiOpenModuleEx
This function opens a specific module with ethernet interface.The particularity of this command is,that parameters like IP-address, portnumber and the duration of the timeout can be specified. The opening of the module is independent of the DELIB Configuration Utility settings.

DapiOpenModuleEx

 

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

 

Parameters

moduleID = Specifies the module to be opened (see delib.h)
nr = Specifies which one (in case of several modules) is to be opened
nr = 0 -> 1st module
nr = 1 -> 2nd 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

 

Comment

The handle returned by this function is required to identify the module for all other functions.
This command is supported by all modules with 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);

Digital output functions

DapiDOSet1
This is the command to set a single output.

DapiDOSet1

 

Description

This command sets a single output.

 

Definition

void DapiDOSet1(ULONG handle, ULONG ch, ULONG data);

 

Parameters

handle=This is the handle of an open module
ch= Specifies the number of the output to be set (0 .. )
data= Specifies the data value to be written (0 / 1)

 

Return-Value

None

 

Requirements

The following SW feature bits must be supported by the module:

 

DAPI_SW_FEATURE_BIT_CFG_DO

The following conditions for the transfer parameters must be met:

maxCh = DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_GET_MODULE_CONFIG, DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DO, 0, 0)
maxCh > ch

DapiDOSet8
This command sets 8 digital outputs simultaneously.

DapiDOSet8

 

Description

This command sets 8 digital outputs simultaneously.

 

Definition

void DapiDOSet8(ULONG handle, ULONG ch, ULONG data);

 

Parameters

handle=This is the handle of an open module
ch= Specifies the number of the output from which writing is to start (0, 8, 16, 24, 32, ..)
data=Specifies the data values to be written

 

Return-Value

None

DapiDOSet16
This command sets 16 digital outputs simultaneously.

DapiDOSet16

 

Description

This command sets 16 digital outputs simultaneously.

 

Definition

void DapiDOSet16(ULONG handle, ULONG ch, ULONG data);

 

Parameters

handle=This is the handle of an open module
ch= Specifies the number of the output from which writing is to start (0, 16, 32, ..)
data=Specifies the data values to be written

 

Return-Value

None

DapiDOSet32
This command sets 32 digital outputs simultaneously.

DapiDOSet32

 

Description

This command sets 32 digital outputs simultaneously.

 

Definition

void DapiDOSet32(ULONG handle, ULONG ch, ULONG data);

 

Parameters

handle=This is the handle of an open module
ch= Specifies the number of the output from which writing is to start (0, 32, 64, ..)
data=Specifies the data values to be written

 

Return-Value

None

 

Programming example

// Write a value to the outputs
data = 0x0000ff00; // outputs 9-16 are set to 1
DapiDOSet32(handle, 0, data); // Chan Start = 0
printf(“Write to outputs data=0x%x\n”, data);
printf(“key for further\n”);
getch();
// —————————————————-
// Write a value to the outputs
data = 0x80000000; // Output 32 is set to 1
DapiDOSet32(handle, 0, data); // Chan Start = 0
printf(“Write to outputs data=0x%x\n”, data);
printf(“key for further\n”);
getch();
// —————————————————-
// Write a value to the outputs
data = 0x80000000; // Output 64 is set to 1
DapiDOSet32(handle, 32, data); // Chan Start = 32
printf(“Write to outputs data=0x%x\n”, data);
printf(“key for further\n”);
getch();

DapiDOSet64
This command is to set 64 digital outputs.

DapiDOSet64

 

Description

This command sets 64 digital outputs simultaneously.

 

Definition

void DapiDOSet64(ULONG handle, ULONG ch, ULONGLONG data);

 

Parameters

handle=This is the handle of an open module
ch= Specifies the number of the output from which writing is to start (0, 64, ..)
data=Specifies the data values to be written

 

Return-Value

None

DapiDOClrBit32
With this command you can change the states of outputs to 0 without changing the states of the neighboring outputs.

DapiDOClrBit32

 

Description

This command can be used to switch outputs selectively to 0 without changing the states of adjacent outputs.

 

Definition

void DapiDOClrBit32(uint handle, uint ch, uint data);

 

Parameters

handle = This is the handle of an open module
ch = Specifies the number of the output from which writing is to start
data = Specifies the data value to be written (up to 32 bits)

 

Return-Value

None

 

Comment

Only the bits with a value of 1 in the data parameter are considered by the command.

 

Programming example

data = 0x1; // Output 0 would be changed to 0. The states of outputs 1-31 won’t be changed
DapiDOSetBit32(handle, 0, data);

data = 0xf; // Outputs 0-3 would be changed to 0. The states of outputs 4-31 won’t be changed
DapiDOSetBit32(handle, 0, data);

data = 0xff; // Outputs 0-7 would be changed to 0. The states of outputs 8-31 won’t be changed
DapiDOSetBit32(handle, 0, data);

data = 0xff000000; // Outputs 23-31 would be changed to 0. The states of outputs 0-21 won’t be changed
DapiDOSetBit32(handle, 0, data);

DapiDOSet1_WithTimer
This function sets a digital output (ch) to a value (data - 0 or 1) for a specified time in msec.

DapiDOSet1_WithTimer

 

Description

This function sets a digital output (ch) to a value (data – 0 or 1) for a certain time in ms.

 

Definition

void DapiDOSet1_WithTimer(ULONG handle, ULONG ch, ULONG data, ULONG time_ms);

 

Parameters

handle=This is the handle of an open module
ch= Specifies the number of the output to be set (0 .. )
data= Specifies the data value to be written (0 / 1)
time_ms=Specifies the time in which the output is set [ms].

 

Return-Value

None

 

Comment

This command is supported by all output modules of the NET series as well as by our RO-O8-R8 module.
This command loses its validity if it is overwritten with other values.
If you want to deactivate the command, it must be overwritten with time_ms=0.

 

Programming example

DapiDOSet1_WithTimer(handle, 2, 1, 1000);
//Setting channel 2 for 1000msec to 1

DapiDOSetBit32
With this command you can change the states of outputs to 1 without changing the states of the neighboring outputs.

DapiDOSetBit32

 

Description

This command can be used to switch outputs selectively to 1 without changing the states of adjacent outputs.

 

Definition

void DapiDOSetBit32(uint handle, uint ch, uint data);

 

Parameters

handle = This is the handle of an open module
ch = Specifies the number of the output from which writing is to start
data = Specifies the data value to be written (up to 32 bits)

 

Return-Value

None

 

Comment

Only the bits with a value of 1 in the data parameter are considered by the command.

 

Programming example

data = 0x1; // Output 0 would be changed to 1. The states of outputs 1-31 won’t be changed
DapiDOSetBit32(handle, 0, data);

data = 0xf; // Outputs 0-3 would be changed to 1. The states of outputs 4-31 won’t be changed
DapiDOSetBit32(handle, 0, data);

data = 0xff; // Outputs 0-7 would be changed to 1. The states of outputs 8-31 won’t be changed
DapiDOSetBit32(handle, 0, data);

data = 0xff000000; // Outputs 23-31 would be changed to 1. The states of outputs 0-21 won’t be changed
DapiDOSetBit32(handle, 0, data);

DapiDOReadback32
This command reads back the 32 digital outputs.

DapiDOReadback32

 

Description

This command reads back the 32 digital outputs.

 

Definition

ULONG DapiDOReadback32(ULONG handle, ULONG ch);

 

Parameters

handle=This is the handle of an open module
ch= Specifies the number of the output from which the read back is to be performed (0, 32, 64, ..)

 

Return-Value

Status of 32 outputs.

DapiDOReadback64
This command reads the current PWM frequency of the module

DapiDOReadback32

 

Description

This command reads back the 32 digital outputs.

 

Definition

ULONG DapiDOReadback32(ULONG handle, ULONG ch);

 

Parameters

handle=This is the handle of an open module
ch= Specifies the number of the output from which the read back is to be performed (0, 32, 64, ..)

 

Return-Value

Status of 32 outputs.

Digital input functions

DapiDIGet1
This command reads a single digital input.

DapiDIGet1

 

Description

This command reads a single digital input.

 

Definition

ULONG DapiDIGet1(ULONG handle, ULONG ch);

 

Parameters

handle=This is the handle of an open module
ch= Specifies the number of the input to be read (0, 1, 2, 3, .. )

 

Return-Value

Status of the input (0/1)

 

Requirements

The following SW feature bits must be supported by the module:

DAPI_SW_FEATURE_BIT_CFG_DI

The following conditions for the transfer parameters must be met:

maxCh = DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_GET_MODULE_CONFIG, DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DI, 0, 0)
maxCh > ch

DapiDIGet8
This command reads 8 digital inputs simultaneously.

DapiDIGet8

 

Description

This command reads 8 digital inputs simultaneously.

 

Definition

ULONG DapiDIGet8(ULONG handle, ULONG ch);

 

Parameters

handle=This is the handle of an open module
ch= Specifies the number of the input from which the read is to start (0, 8, 16, 24, .. )

 

Return-Value

Status of the read inputs

 

Requirements

The following SW feature bits must be supported by the module:

DAPI_SW_FEATURE_BIT_CFG_DI

The following conditions for the transfer parameters must be met:

maxCh = DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_GET_MODULE_CONFIG, DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DI, 0, 0)
maxCh > ch ch must be 0, 8, 16, …

DapiDIGet16
This command reads 16 digital inputs simultaneously.

DapiDIGet16

 

Description

This command reads 16 digital inputs simultaneously.

 

Definition

ULONG DapiDIGet16(ULONG handle, ULONG ch);

 

Parameters

handle=This is the handle of an open module
ch= Specifies the number of the input from which the read is to start (0, 16, 32, …)

 

Return-Value

Zustand der gelesen Eingänge

 

Requirements

The following SW feature bits must be supported by the module:

DAPI_SW_FEATURE_BIT_CFG_DI

The following conditions for the transfer parameters must be met:

maxCh = DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_GET_MODULE_CONFIG, DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DI, 0, 0)
maxCh > ch ch must be 0, 16, 32, …

DapiDIGet32
This command reads 32 digital inputs simultaneously.

DapiDIGet32

 

Description

This command reads 32 digital inputs simultaneously.

 

Definition

ULONG DapiDIGet32(ULONG handle, ULONG ch);

 

Parameters

handle=This is the handle of an open module
ch= Specifies the number of the input from which the read is to start (0, 32, 64, ..)

 

Return-Value

Status of the read inputs

 

Requirements

The following SW feature bits must be supported by the module:

DAPI_SW_FEATURE_BIT_CFG_DI

The following conditions for the transfer parameters must be met:

maxCh = DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_GET_MODULE_CONFIG, DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DI, 0, 0)
maxCh > ch ch must be 0, 32, 64, …

 

Programming example

unsigned long data;
// —————————————————-
// Read a value from the inputs (input 1-31)
data = (unsigned long) DapiDIGet32(handle, 0);
// Chan start = 0
printf(“Input 0-31 : 0x%x\n”, data);
printf(“key for further\n”);
getch();
// —————————————————-
// Read a value from the inputs (input 32-64)
data = (unsigned long) DapiDIGet32(handle, 32);
// Chan Start = 32
printf(“Input 32-64 : 0x%x\n”, data);
printf(“key for further\n”);
getch();

DapiDIGet64
This command reads 64 digital inputs simultaneously.

DapiDIGet64

 

Description

This command reads 64 digital inputs simultaneously.

 

Definition

ULONGLONG DapiDIGet64(ULONG handle, ULONG ch);

 

Parameters

handle=This is the handle of an open module
ch= Specifies the number of the input from which the read is to start (0, 64, ..)

 

Return-Value

Status of the read inputs

 

Requirements

The following SW feature bits must be supported by the module:

DAPI_SW_FEATURE_BIT_CFG_DI

The following conditions for the transfer parameters must be met:

maxCh = DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_GET_MODULE_CONFIG, DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DI, 0, 0)
maxCh > ch ch must be 0 or 64

DapiDIGetFF32
This command reads the flip-flops from the inputs and resets them. (Input state change).

DapiDIGetFF32

 

Description

This command reads the flip-flops of the inputs and resets them.
(input state change)

 

Definition

ULONG DapiDIGetFF32(ULONG handle, ULONG ch);

 

Parameters

handle=This is the handle of an open module
ch= Specifies the number of the input from which the read is to start (0, 32, 64, ..)

 

Return-Value

Status of 32 input status changes

 

Requirements

The following SW feature bits must be supported by the module:

DAPI_SW_FEATURE_BIT_CFG_DI_FF

The following conditions for the transfer parameters must be met:

maxCh = DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_GET_MODULE_CONFIG, DAPI_SPECIAL_GET_MODULE_CONFIG_PAR_DI_FF, 0, 0)
maxCh > ch ch must be 0, 32, 64, …

Software FIFO-functions

DapiSpecialCommand - DapiSpecialCMDSWFifo
This command is used to set the software FIFO of the NET-Modules

DapiSpecialCommand-DapiSpecialCMDSWFifo

 

Description

This command is used to set the software FIFO.
DAPI_SPECIAL_CMD_SW_FIFO commands only work with the NET series.

 

Definition

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO, cmd, fifo_instance, par2);

 

Parameters

handle = This is the handle of an open module
cmd = function to be executed
fifo_instance = Specifies the instance of the software FIFO. So far there is only instance 0
par2 = value that is passed to the function

Remark

Always define the submodule first with the DapiSpecialSWFifoSetSubmodule command!

DapiSpecialCommand - DapiSpecialSWFifoSetSubmodule
This command specifies to which submodule the data of the software FIFO are transferred

DapiSpecialCommand-DapiSpecialSWFifoSetSubmodule

 

Description

This command specifies to which submodule the data of the software FIFO are transferred.

 

Definition

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO, cmd, fifo_instance, par2);

 

Parameters

cmd = DAPI_SPECIAL_SW_FIFO_SET_SUBMODULE
fifo_instance = Specifies the instance of the software FIFO
par2 = indicates the number of the submodule (0, 1, 2, 3, …)

 

Programming example

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO,
DAPI_SPECIAL_SW_FIFO_SET_SUBMODULE, fifo_instance, 2);
//The software FIFO transfers the data to submodule 2.

DapiSpecialCommand - DapiSpecialSWFifoGetSubmodule
This command returns the number of the submodule to which the data is transferred

DapiSpecialCommand – DapiSpecialSWFifoGetSubmodule

 

Description

This command returns the number of the submodule to which the data is transferred.

 

Definition

ULONG DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO, cmd, fifo_instance, 0);

 

Parameters

cmd = DAPI_SPECIAL_SW_FIFO_GET_SUBMODULE
fifo_instance = Specifies the instance of the software FIFO

 

Return value

Number of the submodule (0, 1, 2, 3, …)

 

Programming example

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO,
DAPI_SPECIAL_SW_FIFO_SET_SUBMODULE, fifo_instance, 2);
//The software FIFO transfers the data to submodule 2.

DapiSpecialCommand - DapiSpecialSWFifoActivate
This command activates the Fifo data transfer within the NET modules.

DapiSpecialCommand-DapiSpecialSWFifoActivate

 

Description

This command activates the Fifo data transfer within the NET modules.

 

Definition

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO, cmd, fifo_instance, 0);

 

Parameters

cmd = DAPI_SPECIAL_SW_FIFO_ACTIVATE
fifo_instance = Specifies the instance of the software FIFO

 

Programming example

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO,
DAPI_SPECIAL_SW_FIFO_ACTIVATE, fifo_instance, 0);
//The automatic output of the D/A converter is activated.

DapiSpecialCommand - DapiSpecialSWFifoDeactivate
This command deactivates the Fifo data transfer within the NET modules

DapiSpecialCommand-DapiSpecialSWFifoDeactivate

 

Description

This command deactivates the Fifo data transfer within the NET modules.

 

Definition

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO, cmd, fifo_instance, 0);

 

Parameters

cmd = DAPI_SPECIAL_SW_FIFO_DEACTIVATE
fifo_instance = Specifies the instance of the software FIFO

 

Programming example

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO,
DAPI_SPECIAL_SW_FIFO_DEACTIVATE, fifo_instance, 0);
//The automatic output of the D/A converter is deactivated.

DapiSpecialCommand - DapiSpecialSWFifoGetActivity
This command gets the status of the FIFO transmission to the D/A converter (whether active or inactive)

DapiSpecialCommand – DapiSpecialSWFifoGetActivity

 

Description

This command gets the status of the FIFO transmission to the D/A converter (whether active or inactive).

 

Definition

ULONG DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO, cmd, fifo_instance, 0);

 

Parameters

cmd = DAPI_SPECIAL_SW_FIFO_GET_ACTIVITY
fifo_instance = Specifies the instance of the software FIFO

 

Return value

Return = 0 (transmission is deactivated)
Return = 1 (transmission is activated)

 

Programming example

unsigned long ret = DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO,
DAPI_SPECIAL_SW_FIFO_GET_ACTIVITY, fifo_instance, 0);
printf(“Status = %lu\n”, ret);
//transfer status is retrieved

DapiSpecialCommand - DapiSpecialSWFifoInitAndClear
This command deletes existing data from the software FIFO memory and returns the FIFO mechanism to its original state

DapiSpecialCommand – DapiSpecialSWFifoInitAndClear

 

Description

This command deletes existing data from the software FIFO memory and returns the FIFO mechanism to its original state.

 

Definition

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO, cmd, fifo_instance, 0);

 

Parameters

cmd = DAPI_SPECIAL_SW_FIFO_INIT_AND_CLEAR
fifo_instance = Specifies the instance of the software FIFO

 

Programming example

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO,
DAPI_SPECIAL_SW_FIFO_INIT_AND_CLEAR, fifo_instance, 0);
//existing data is deleted from the FIFO memory.

DapiSpecialCommand - DapiSpecialSWFifoIOActivate
This command activates the FIFO I/O input/output.

DapiSpecialCommand – DapiSpecialSWFifoIOActivate

 

Description

This command activates the FIFO I/O input/output.

 

Definition

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO, cmd, fifo_instance, 0);

 

Parameters

cmd = DAPI_SPECIAL_SW_FIFO_IO_ACTIVATE
fifo_instance = Gibt die Instanz des Software FIFO an

 

Programming example

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO,
DAPI_SPECIAL_SW_FIFO_IO_ACTIVATE, fifo_instance, 0);
//The automatic output of the FIFO to the module is activated.

DapiSpecialCommand - DapiSpecialSWFifoIODeactivate
This command disables the FIFO I/O input/output.

DapiSpecialCommand – DapiSpecialSWFifoIODeactivate

 

Description

This command disables the FIFO I/O input/output.

 

Definition

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO, cmd, fifo_instance, 0);

 

Parameters

cmd = DAPI_SPECIAL_SW_FIFO_IO_DEACTIVATE
fifo_instance = Gibt die Instanz des Software FIFO an

 

Programming example

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO,
DAPI_SPECIAL_SW_FIFO_IO_DEACTIVATE, fifo_instance, 0);
//The automatic output of the FIFO to the module is deactivated.

DapiSpecialCommand - DapiSpecialSWFifoSetChannel
This command specifies the A/D channels to which the FIFO data is to be transferred, specifying the start and end channels

DapiSpecialCommand – DapiSpecialSWFifoSetChannel

 

Description

This command specifies the A/D channels to which the FIFO data is to be transferred, specifying the start and end channels.

 

Definition

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO, cmd, fifo_instance, ch);

 

Parameters

cmd = DAPI_SPECIAL_SW_FIFO_SET_CHANNEL
fifo_instance = Specifies the instance of the software FIFO
ch = specification of the start and end channel

 

Programming example

unsigned long ch_start = 0; //Start with D/A Channel 0
unsigned long ch_end = 1; //End with D/A Channel 1

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO,
DAPI_SPECIAL_SW_FIFO_SET_Channel, fifo_instance,
((ch_end << 8) & 0xff00) | (ch_start & 0xff);
//The start and end channel is defined

DapiSpecialCommand - DapiSpecialSWFifoGetChannel
This command shows the D/A channels to which the data is transferred

DapiSpecialCommand-DapiSpecialSWFifoGetChannel

 

Description

This command shows the D/A channels to which the data is transferred.

 

Definition

ULONG DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO, cmd, fifo_instance, 0);

 

Parameters

cmd = DAPI_SPECIAL_SW_FIFO_GET_CHANNEL
fifo_instance = Specifies the instance of the software FIFO

 

Return value

Number of the A/D channels
Bit 0-7 Start channel
Bit 8-15 End channel

 

Programming example

unsigned long ret = DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO,
DAPI_SPECIAL_SW_FIFO_GET_CHANNEL, fifo_instance, 0);
printf(“Channel = %lu\n”, ret);
//Shows on which A/D channels the data is transferred.

DapiSpecialCommand - DapiSpecialSWFifoSetFrequencyHz
This command specifies the frequency interval (in Hertz) from the FIFO to the module

DapiSpecialCommand-DapiSpecialSWFifoSetFrequencyHz

 

Description

This command specifies the frequency interval (in Hertz) from the FIFO to the module.

 

Definition

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO, cmd, fifo_instance, par2);

 

Parameters

cmd = DAPI_SPECIAL_SW_FIFO_SET_FREQUENCY_HZ
fifo_instance = Specifies the instance of the software FIFO
par2 = frequency interval in Hertz (Hz)

 

Programming example

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO,
DAPI_SPECIAL_SW_FIFO_SET_FREQUENCY_HZ, fifo_instance, 10);
//Sets the frequency interval to 10Hz.

DapiSpecialCommand - DapiSpecialSWFifoGETFrequencyHz
This command returns the previously set frequency interval in Hertz

DapiSpecialCommand-DapiSpecialSWFifoGETFrequencyHz

 

Description

This command returns the previously set frequency interval in Hertz.

 

Definition

ULONG DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO, cmd, fifo_instance, 0);

 

Parameters

cmd = DAPI_SPECIAL_SW_FIFO_GET_FREQUENCY_HZ
fifo_instance = Specifies the instance of the software FIFO

 

Return value

Frequency interval in Hertz (Hz)

 

Programming example

unsigned long ret = DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO,
DAPI_SPECIAL_SW_FIFO_GET_FREQUENCY_HZ, fifo_instance, 0);
printf(“Frequency = %lu (Hz)\n”, ret);
//Displays the previously set frequency interval.

DapiSpecialCommand - DapiSpecialSWFifoGetBytesFree
This command is used to read the free bytes in the software FIFO buffer

DapiSpecialCommand-DapiSpecialSWFifoGetBytesFree

 

Description

This command is used to read the free bytes in the software FIFO buffer.

 

Definition

ULONG DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO, cmd, fifo_instance, 0);

 

Parameters

cmd = DAPI_SPECIAL_SW_FIFO_GET_BYTES_FREE
fifo_instance = Specifies the instance of the software FIFO

 

Return value

Free bytes of the software FIFO

 

Programming example

unsigned long ret = DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO,
DAPI_SPECIAL_SW_FIFO_GET_BYTES_FREE, fifo_instance, 0);
printf(“Free memory = %lu\n”, ret);
//Output the remaining free bytes of the memory.

DapiSpecialCommand - DapiSpecialSWFifoGetBytesPerSample
This command specifies how many bytes are required for writing to the D/A converter

DapiSpecialCommand-DapiSpecialSWFifoGetBytesPerSample

 

Description

This command specifies how many bytes are required for writing to the D/A converter.
Example: If 3 D/A channels are written to a 16 bit (2 byte) D/A converter, 3×2 bytes are required per sample. So the value 6 will be returned.

 

Definition

ULONG DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO, cmd, fifo_instance, 0);

 

Parameters

cmd = DAPI_SPECIAL_SW_FIFO_GET_BYTES_PER_SAMPLE
fifo_instance = Specifies the instance of the software FIFO

 

Return value

Bytes required per sample

 

Programming example

unsigned long ret = DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO,
DAPI_SPECIAL_SW_FIFO_GET_BYTES_PER_SAMPLE, fifo_instance, 0);
printf(“Required bytes = %lu\n”, ret);
//Output of the required bytes per sample.

DapiSpecialCommand - DapiSpecialSWFifoGetBytesPerSample
This command specifies how many bytes are required for writing to the D/A converter

DapiSpecialCommand-DapiSpecialSWFifoGetBytesPerSample

 

Description

This command specifies how many bytes are required for writing to the D/A converter.
Example: If 3 D/A channels are written to a 16 bit (2 byte) D/A converter, 3×2 bytes are required per sample. So the value 6 will be returned.

 

Definition

ULONG DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO, cmd, fifo_instance, 0);

 

Parameters

cmd = DAPI_SPECIAL_SW_FIFO_GET_BYTES_PER_SAMPLE
fifo_instance = Specifies the instance of the software FIFO

 

Return value

Bytes required per sample

 

Programming example

unsigned long ret = DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO,
DAPI_SPECIAL_SW_FIFO_GET_BYTES_PER_SAMPLE, fifo_instance, 0);
printf(“Required bytes = %lu\n”, ret);
//Output of the required bytes per sample.

DapiSpecialCommand - DapiSpecialSWFifoSetMode
This command sets the software FIFO mode

DapiSpecialCommand-DapiSpecialSWFifoSetMode

 

Description

This command sets the software FIFO mode. This command is not yet supported in the current firmware.

 

Definition

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO, cmd, fifo_instance, par2);

 

Parameters

cmd = DAPI_SPECIAL_SW_FIFO_SET_MODE
fifo_instance = Specifies the instance of the software FIFO
par2 = Software FIFO Mode

 

Programming example

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO,
DAPI_SPECIAL_SW_FIFO_SET_MODE, fifo_instance, 0);
//The software FIFO mode is set.

DapiSpecialCommand - DapiSpecialSWFifoGetMode
This command returns the previously set FIFO mode

DapiSpecialCommand-DapiSpecialSWFifoGetMode

 

Description

This command returns the previously set FIFO mode. Currently this mode is not yet supported in the firmware.

 

Definition

ULONG DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO, cmd, fifo_instance, 0);

 

Parameters

cmd = DAPI_SPECIAL_SW_FIFO_GET_MODE
fifo_instance = Specifies the instance of the software FIFO

 

Return value

FIFO Software Mode

 

Programming example

unsigned long ret = DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO,
DAPI_SPECIAL_SW_FIFO_GET_MODE, fifo_instance, 0);
printf(“Mode = %lu\n”, ret);
//Get the previously set FIFO mode.

DapiSpecialCommand - DapiSpecialSWFifoGetStatus
This command can be used to retrieve status values

DapiSpecialCommand-DapiSpecialSWFifoGetStatus

 

Beschreibung

This command can be used to retrieve status values.

 

Definition

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO, cmd, fifo_instance, 0);

 

Parameter

cmd = DAPI_SPECIAL_SW_FIFO_GET_STATUS
fifo_instance = Specifies the instance of the software FIFO

 

Return-Value

Description
(FIFO status generates a return value…)
Return value in hex
DAPI_SPECIAL_SW_FIFO_STATUS_IS_ACTIVE … when the output of the D/A converter is active 0x01
DAPI_SPECIAL_SW_FIFO_STATUS_IO_IS_ACTIVE … if the output of the FIFO I/O is active 0x02
DAPI_SPECIAL_SW_FIFO_STATUS_FIFO_OVERFLOW … if too much data is written into the FIFO 0x04
DAPI_SPECIAL_SW_FIFO_STATUS_FIFO_UNDERRUN … when the FIFO runs empty 0x08
DAPI_SPECIAL_SW_FIFO_STATUS_FIFO_OUT_OF_SYNC … if the FIFO communication within the modules is interrupted 0x10

Programming example

unsigned long ret;

ret = DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_SW_FIFO,DAPI_SPECIAL_SW_FIFO_GET_STATUS, fifo_instance, 0);
if((ret & 0x01) != 0) {printf(“is_active”);}
if((ret & 0x02) != 0) {printf(“io_is_active”);}
if((ret & 0x04) != 0) {printf(“fifo_overflow”);}
if((ret & 0x08) != 0) {printf(“fifo_underrun”);}
if((ret & 0x10) != 0) {printf(“fifo_out_of_sync);}

DapiSpecialCommand - DapiSpecialCMDAD
This command controls the Software FIFO of a A/D converter.

DapiSpecialCommand-DapiSpecialCMDAD

 

Description

This command manages the control of the software FIFO of an A/D converter.

 

Definition

ULONG DapiSpecialCommand(ULONG handle, DAPI_SPECIAL_CMD_AD, ULONG cmd, ULONG ch_range, ULONG par0);

 

Parameters

handle = This is the handle of an open module
ch_range = Indicates the number of the A/D converter module (see example or file delib.h)

 

Initialize FIFO

cmd=DAPI_SPECIAL_RO_AD_FIFO_INIT
par0=not defined

Activate FIFO
cmd=DAPI_SPECIAL_RO_AD_FIFO_ACTIVATE
par0=not defined

Deactivate FIFO
cmd=DAPI_SPECIAL_RO_AD_FIFO_DEACTIVATE
par0=not defined

Set FIFO interval
cmd=DAPI_SPECIAL_RO_AD_FIFO_SET_INTERVAL_MS
par0=interval [msec]

Set FIFO for an A/D converter channel
cmd=DAPI_SPECIAL_RO_AD_FIFO_SET_CHANNEL
par0=16 bit value for A/D channels that are written to the FIFO. Each bit stands for one channel (Bit0 -> AD0, Bit1 -> AD1, … Bit15 -> AD15).
If the bit is set, the corresponding A/D channel is active.

Request FIFO status
cmd=DAPI_SPECIAL_RO_AD_FIFO_GET_STATUS
par0=not defined

 

Return-Value

cmd=DAPI_SPECIAL_RO_AD_FIFO_INIT
no return value

cmd=DAPI_SPECIAL_RO_AD_FIFO_ACTIVATE
no return value

cmd=DAPI_SPECIAL_RO_AD_FIFO_DEACTIVATE
no return value

cmd=DAPI_SPECIAL_RO_AD_FIFO_SET_INTERVAL_MS
no return value

cmd=DAPI_SPECIAL_RO_AD_FIFO_SET_CHANNEL
no return value

cmd=DAPI_SPECIAL_RO_AD_FIFO_GET_STATUS
return=current FIFO status

Value [hex] Meaning Explanation 0x80 RO_FIFO_STATUS_MASK_MEASURE_ENABLED FIFO is active 0x40 RO_FIFO_STATUS_MASK_TEST_DATA
0x20 RO_FIFO_STATUS_MASK_OVERFLOW FIFO Buffer is full 0x10 RO_FIFO_STATUS_MASK_UNDERRUN
0x08 RO_FIFO_STATUS_FULL_256_BYTE 256 Byte data available 0x04 RO_FIFO_STATUS_FULL_64_BYTE 64 Byte data available 0x02 RO_FIFO_STATUS_FULL_16_BYTE 16 Byte data available 0x01 RO_FIFO_STATUS_FULL_1_BYTE 1 Byte data available

 

Programming example

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_AD, DAPI_SPECIAL_RO_AD_FIFO_DEACTIVATE, DAPI_SPECIAL_AD_CH0_CH15, 0);
// deactivates the current AD-FIFO recording for AD module0 (channel 0 to 15)

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_AD, DAPI_SPECIAL_RO_AD_FIFO_INIT, DAPI_SPECIAL_AD_CH0_CH15, 0);
// initializing a new AD-FIFO recording for AD module 0 (channel 0 to 15)

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_AD, DAPI_SPECIAL_RO_AD_FIFO_SET_INTERVAL_MS, DAPI_SPECIAL_AD_CH0_CH15, 100);
// Set the AD-FIFO interval for recording to 100 ms for AD module 0 (channel 0 to 15).

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_AD, DAPI_SPECIAL_RO_AD_FIFO_SET_CHANNEL, DAPI_SPECIAL_AD_CH0_CH15, 0x1051);
// set the A/D channels to be recorded for AD module 0 (channel 0 to 15)
// 0x1051 [hex] = 0001 0000 0101 0001 0001 [bin]
// the following channels are recorded: AD0, AD4, AD6 and AD12

DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_AD, DAPI_SPECIAL_RO_AD_FIFO_ACTIVATE, DAPI_SPECIAL_AD_CH0_CH15, 0);
// starts / activates the recording

status = DapiSpecialCommand(handle, DAPI_SPECIAL_CMD_AD, DAPI_SPECIAL_RO_AD_FIFO_GET_STATUS, DAPI_SPECIAL_AD_CH0_CH15, 0);
// get the current AD-FIFO status

DapiWriteFifo
This command writes data records into the software FIFO

DapiWriteFifo

 

Description

This command writes data records into the software FIFO.

 

Definition

DapiWriteFifo(ULONG handle, ULONG fifo_instance, ULONG type, UCHAR * buffer, ULONG buffer_length);

 

Parameters

handle=This is the handle of an open module
fifo_instance=Gives the instance of the software FIFO
type=Gives the FIFO type
buffer=Buffer for the record to be sent
buffer_length=Length of the buffer

 

Programming example

DapiWriteFifo(handle, fifo_instance, 0, buff, pos);
//Writes the data set to the software FIFO.

DapiReadFifo
This command reads the Software-FIFO of the RO-Modules

DapiReadFifo

 

Description

This command reads the software FIFO. The data sets read out are deleted from the module’s software FIFO after reading.

 

Definition

ULONG DapiReadFifo(ULONG handle, ULONG type, UCHAR * buffer, ULONG buffer_length);

 

Parameters

handle=This is the handle of an open module
fifo_instance=Gives the instance of the software FIFO
type=Gives the FIFO type
buffer=Buffer for the record to be received
buffer_length=Length of the buffer

 

Return-Value

Length of the read FIFO data records

 

Structure of a FIFO data record (example with 2 active AD channels, AD0 and AD4)

Byte || Meaning || Value [hex]

0 RO_FIFO_ID_START 0xf0

1 FIFO type
2 Time stamp (Bit0..Bit7)
3 Time stamp (Bit8..Bit15)
4 Active A/D channels (Bit0..Bit7) 0x11

5 Active A/D channels (Bit8..Bit15) 0x00

6 A/D value channel 0 (Bit0..Bit7)
7 A/D value channel 0 (Bit8..Bit15)
8 A/D value channel 4 (Bit0..Bit7)
9 A/D value channel 4 (Bit8..Bit15)
10 RO_FIFO_ID_END 0xf1

FIFO data set = 7 bytes ID + (2 x number of active A/D channels) bytes data

 

RO_FIFO_ID_START

Signals the beginning of a new FIFO data record. The RO_FIFO_ID_START always has the value 0xf0 [hex].

 

FIFO type

Specifies the FIFO type (e.g. RO_FIFO_ID_TYPE_AD16M0 for A/D-FIFO)

 

Time stamp

Specifies the 16 bit time stamp of the current record. The time reference here is the time of activation of the FIFO.
If the time stamp overflows, it is reset to 0.

 

Active A/D channels

Specifies a 16 bit value for the currently active A/D channels. Each bit represents one channel (Bit0 -> AD0, Bit1 -> AD1, … Bit15 -> AD15).
If the bit is set, the corresponding A/D channel is active

RO_FIFO_ID_END
Signals the end of a FIFO data record. The RO_FIFO_ID_END always has the value 0xf1 [hex].

 

Comment

This command is only supported by our RO-ETH series modules.
Please note that the software FIFO must be activated or initialized with the command “DapiSpecialCMDAD”.

 

Programming example

bytes_received = DapiReadFifo(handle, DAPI_FIFO_TYPE_READ_AD_FIFO, buffer, sizeof(buffer));
// Reads the Software FIFO

Block diagram RO-O16

RO-O16

Connection example Relay

Connection example

Connection example Optoin

Connection example

Screwless connector system

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

 

Handling

Step 1

Remove the operating tool from the scope of delivery.

Step 2

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

Step 3

Now insert the stripped conductor into the open terminal contact.

Schritt 4

Pull the operating tool out again.

Step 5

Check the correct connection of the conductor. It should now no longer be possible to pull it out easily.

Manual RO-Serie
Hard- and Software-description
Download
  • Description of the measurement modules
  • Configuration of the different module interfaces
  • Installation of the DELIB driver library

 


DELIB driver library

Manual of the DELIB driver library
Documentation of all functions for the driver library
Download
  • Windows 10, 8, Vista, 7, XP, 2000 andLinux
  • Moduel open/close functions
  • Digital inputs: reading 1 / 8 / 16 / 32 / 64 bit
  • Digital outputs: Write 1 / 8 / 16 / 32 / 64 bit
  • A/D Lesen: read, read_volt, read_mA, A/D Modus einstellen
  • D/A schreiben: write, write_volt, write_mA, D/A-Modus einstellen
DELIB (64-bit) driver library for Windows
For Windows 11/10, Windows 7, Windows 8, Vista, XP and 2000
Download

Installation file for the 64 bit DELIB driver library.

The following operating systems are supported:

64 bit

  • Windows 11/10 x64
  • Windows 7 x64
  • Windows 8 x64
  • Windows Server 2012 x64
  • Windows Server 2008 x64
  • Windows Vista x64
  • Windows XP x64
  • Windows Server 2003 x64

Included software

  • DT-Flasher x64
    Software to update DEDITEC module to the latest version
  • DELIB Configuration Utility x64
    Set configuration of module addresses
  • DELIB Module Config x64
    Configuration of module-specific settings
  • CAN Configuration Utility x64
    Set configuration of CAN modules
  • DELIB Module Demo x64
    Enables manual switching of a module
  • DELIB Command Line Interface x64
    Enables the execution of DELIB commands in the command line
  • Watchdog Configuration Utility x64
    Set configuration of a watchdog stick
DELIB (32-bit) driver library for Windows
For Windows 11/10, Windows 7, Windows 8, Vista, XP and 2000
Download

Installation file for the 32-bit version of the DELIB driver library.

The following operating systems are compatible:
32-Bit

    • Windows 11/10
    • Windows 7
    • Windows 8
    • Windows Server 2012
    • Windows Server 2008
    • Windows Vista
    • Windows XP
    • Windows Server 2003

64-Bit

  • Windows 10 x64
  • Windows 7 x64
  • Windows 8 x64
  • Windows Server 2012 x64
  • Windows Server 2008 x64
  • Windows Vista x64
  • Windows XP x64
  • Windows Server 2003 x64

Included software

  • DT-Flasher
    Software to update DEDITEC module to the latest version
  • DELIB Configuration Utility
    Set configuration of module addresses
  • DELIB Module Config
    Configuration of module-specific settings
  • CAN Configuration Utility
    Set configuration of CAN modules
  • DELIB Module Demo
    Enables manual switching of a module
  • DELIB Command Line Interface
    Enables the execution of DELIB commands in the command line
  • Watchdog Configuration Utility
    Set configuration of a watchdog stick

Attention:

With this version of the driver library, only 32-bit applications can be created, which can then be run on 32- and 64-bit systems.

DELIB driver library for Linux (32/64-bit)
For 32/64-bit Linux distributions starting with kernel 2.6.x
Download

DELIB driver library for Linux distributions (32/64-bit) starting with kernel 2.6.x

This driver package includes the following components:

  • DELIB USB driver
  • DELIB Ethernet driver
  • DELIB CLI

DELIB USB driver

Supports the following products:

  • NET-Series (via USB interface)
  • RO-USB-Series
  • BS-USB-Series
  • USB-Mini-Sticks
  • USB-Watchdog
  • USB-OPTION-8 / USB-RELAIS-8
  • USB-TTL-32 / USB-TTL-64

Note:

With the standard USB driver, you can access several USB products with different module IDs (for example one RO-USB and one USB-OPTOIN-8). Therefore, no additional driver installation is required.

If you want to access several USB products with the same module ID (for example one USB-OPTOIN-8 and one USB-RELAIS-8), you have to install additionally the Linux FTDI driver. The FTDI driver can be found at http://www.ftdichip.com.

 

DELIB Ethernet driver

Supports the following products:

  • NET-Series (via Ethernet Interface)
  • RO-ETH-Series
  • RO-ETH/LC-Series
  • BS-ETH-Serie
  • ETH-OPTION-8 / ETH-RELAIS-8
  • ETH-TTL-64

DELIB CLI

With the DELIB CLI (Command Line Interface) for Linux it is possible so controll all I/O’s over the command-line.

 

DELIB - Sample-Sources - Installer (approx. 10 MB)
Sample programs for different programming languages (Also in DELIB Setup included)
Download

Sample programs for different programming languages (Also in DELIB Setup included)

  • C (Microsoft Visual C++ 6.0, Borland C)
  • C++ (Microsoft Visual C++ 6.0)
  • C# (Microsoft Visual C# 2008 to 2015)
  • Delphi (Borland Delphi 7)
  • VB (Microsoft Visual Basic 6.0)
  • VB.NET (Microsoft Visual Basic 2008 to 2015)
  • Java (Java native interface)
  • Java.dll (Ethernet protocol for ethernet products)

 


Download

Hardware-Updates (Firmware)
Flash files for the DT-Flasher
Download

The flash files can also be downloaded directly in the DT-Flasher.

This package contains firmware files for the following products:

STARTER-series:

  • USB-MINI-Sticks
  • USB-8-er Opto/Relay
  • Ethernet 8-er Opto/Relay
  • USB-TTL I/O
  • Ethernet-TTL I/O

BS-series:

  • BS-CAN Module
  • BS-ETH Module
  • BS-USB Module
  • BS-SER Module

RO-series Interfaces:

  • RO-USB
  • RO-SER
  • RO-ETH
  • RO-ETH/LC
  • RO-CAN

RO-series I/Os:

  • AD / DA Module
  • CNT8 / CNT-IGR
  • O8-R8 Time module
  • PT100
  • Stepper2

Development accessories

  • USB Controller 8
  • USB Watchdog Stick

DEDITEC driver CD

DEDITEC Driver CD with many helpful tools and manuals for commissioning your DEDITEC products.

  • DELIB driver library for Windows
  • Test and configuration software
  • Manuals
  • Data sheets
  • Example programs for C++, C#, VB, VB.Net, Delphi, LabVIEW

2 pin plug connector

Allows the power supply to be connected to the DEDITEC module

  • Type: Phoenix Contact 1783287
  • 100 % malfunction protected
  • For all conductor types from 0.2mm² to 2.5mm²

16 pol connector

Required to connect your application to the DEDITEC module

  • Type: Wago Kontakttechnik 713-1108/037-000
  • Pluggable female connector with locking mechanism
  • 100 % malfunction protected
  • 1-wire connection for all types of conductors up to 1.5mm²

Tool for wiring connectors

Serves to open and close the clamp contacts on the Wago connectors.
  • Type: Wago Kontakttechnik 734-231

2 meter USB A/B connection cable

2 meter USB connection cable A to B.

  • Type: Plug A to plug B
  • length: 1,8m

DSUB-9 connection cable

DSUB-9 extension cable. Female to male 1,8 Meter

Optional input voltage range 5V..15V RO

With this option the input voltage range of the RO-OPTOIN modules can be reduced to 5V to 15V. There are always 4 channels per ordered quantity converted by us.

  • Input voltage range 5V to 15V AC / DC
  • 4 channels

8-times relay powermodule (switching capacity 40V/10A), which can be controlled by relays/opto-couplers

The MOD-REL8_10A has eight changeover relays with a switching capacity of 48V/10A AC or 30V/8A DC. It can be used as additional power stage for our digital output modules. The normally open contacts of a digital output module, e.g. a RO-USB-REL16, are simply connected in parallel to the inputs of this power stage. Additionally this module requires a power supply of 24V DC.

  • Power stage for all digital output modules
  • 8 change-over contact relay (CO) / 48V / 10A AC or. 30V / 8A DC
  • 24V power supply
  • Pluggable terminal strips for the connection wiring
  • Potential-free inputs (no control voltage required)

USB watchdog stick with 2 relays for shift operations

This USB-WATCHDOG-STICK monitors your operating PC or server and can reset the hardware independently in case of a program crash. Simply integrate the function of the Watchdog Stick into your application. As soon as a timeout occurs and the watchdog stick is no longer periodically reset, the two relay outputs are switched through. With an appropriate connection cabling, for example, the PC reset could be activated, an external SMS modem can send warnings or a connected siren signals an alarm. With the help of our free configuration tool, you can define how the relays should switch in case of an error.

  • USB 2.0 / USB 1.1 interface
  • Watchdog function
  • Monitoring your control PC or server
  • Timeout times adjustable from 10ms to 10h
  • Windows Watchdog API
  • 2 NO contact relay (NO)
  • Connection cable with DSUB9 socket (approx. 1.8m)

Power supply 24V/2A for DIN rail mounting

The DR-4524 from Mean Well is a 48W rail mount power supply for industrial applications. It offers protection against short circuit, overload, overvoltage and overheating.

  • Input voltage range: 85V… 264V AC / 120V DC … 370V DC
  • Output voltage: 24V DC
  • Output current: 2A
  • Nominal power: 48W

12V din rail relay

PLC interface for limiting continuous currents up to 10A, consisting of basic terminal with screw connection and pluggable miniature relay. Mountable on NS 35/7.5 mounting rail.

  • Nominal voltage: 230V AC / 220V DC
  • Switching voltage: 250 V AC/DC
  • 1 changeover contact
  • Reverse polarity protection, freewheeling diode
  • LED for voltage indication
  • Phoenix Contact, 2967617, PLC-RSC- 12DC/21HC

24V din rail relay

PLC interface for limiting continuous currents up to 10A, consisting of basic terminal with screw connection and pluggable miniature relay. Mountable on NS 35/7.5 DIN rail.

  • Nominal voltage: 24V AC/DC
  • Switching voltage: 250 V AC/DC
  • 1 changeover contact
  • Reverse polarity protection, freewheeling diode
  • LED for voltage indication
  • Phoenix Contact, 2967633, PLC-RSC- 24UC/21HC

230V din rail relay

With this 230V relay can you reduce your voltage to 12V. The 12V signal can be read by our opto coupler inputs.

  • Max switching current 250V AC
  • Coil current 4,5mA

16 pol connector

Required to connect your application to the DEDITEC module

  • Type: Wago Kontakttechnik 713-1108/037-000
  • Pluggable female connector with locking mechanism
  • 100 % malfunction protected
  • 1-wire connection for all types of conductors up to 1.5mm²

Strain relief plate for 16 or 18 pole Wago connectors

A strain relief plate that can be mounted centrally between the conductor entries facilitates the plugging and unplugging process and allows easy access to the actuation openings even when wired.

  • Type: Wago / 713-127
  • Suitable for 16/18 pole female connectors with conductor connection
  • Mating and unmating aid for Wago connectors
  • Strain relief of the individual wired conductors
  • Easy mounting

Tool for wiring connectors

Serves to open and close the clamp contacts on the Wago connectors.
  • Type: Wago Kontakttechnik 734-231

DIN Rail

Top-hat rail for mounting our control technology modules.

  • Top-hat rail according to DIN EN 50022
  • Type: Phoenix Contact / 1208131
  • Dimensions in mm: 450 x 35 x 7.5 (L x W x D)

Reviews

There are no reviews yet.

Be the first to review “RS-232/RS-485 module with 8/16/32/64 * inputs and 8/16/32/64 * outputs”

Your email address will not be published. Required fields are marked *