OneSoft

OneSoft

OneSoft devices communication protocol

Supported device types and versions


This protocol supports data acquisition (in the case of SOFTCONTROL and OMOS devices, also data writing) from both the heat meters and control systems produced by OneSoft s.r.o. Prievidza.

The communication supports and was tested for these devices:

ELTRONIC, FC200 ST, FC200 WM, FC200 GS, MAXTRONIC 05, MAXTRONIC 15D, STEAMTRONIC B, STEAMTRONIC D, SOFTCONTROL, OMOS

Communication line configuration


  • Communication line category: Serial, SerialOverUDP Device Redundant.

  • Serial line parameters:

    • Baud rate (it depends on the device settings),

    • Parity (usually none parity),

    • Handshaking depending on the type of converter RS232/RS485. Set Transmit and Receive delay to approx. 60 ms for the converters that are controlled by RTS signal.

Protocol line parameters

Parameter

Meaning

Unit

Default value

Scan Mode (read-only)

Configuration of passive mode (Scan only) in which no requests are sent, only responses processed.

-

NO

Wait Timeout in Scan Mode

The delay between reading data in Scan Mode.

ss.mss

0.5

Communication station configuration


  • Communication protocol: OneSoft Devices

  • Station address requires to set these parameters:

    • Device ID (from 0 up to 65535).

    • Data block size (see Table 2).

    • End of range for calculation the checksum „Checksum after: “ (see Table1).

Table 1

Device type

Data block size

Checksum after

Device type

Data block size

Checksum after

ELTRONIC

93

91

FC200 ST

93

91

FC200 WM

92

90

MAXTRONIC

93

91

STEAMTRONIC B

93

90

STEAMTRONIC D

93

91

OMOS

0

0

MAXTRONIC 05

0

0

MAXTRONIC 15D

0

0

In the configuration dialog window of the station, you can choose a device that presets the values from Table 1.

For SOFTCONTROL devices, the setting of data block size is different than block size for calculating the checksum depending on firmware in the particular application. We recommend you to ask for technical documentation from a producer. At the end of the data block you can find the following information:

/***********************************************************************/ sprava[314] = 0x22 ; sprava[315] = 0xcc ; // end of transmission } /***********************************************************************/ /* number of transmitted bytes = 315 */ /***********************************************************************/

From this information, it results that the value for "Data block size" and "Checksum after" is 316 (the number of transmitted bytes is in fact 315+1). 

OMOS devices do not need this parameter. You can set zero values. When configuring OMOS stations, remember that the device consists of several separate modules. Each module is configured as a separate station. See the parameter of station protocol "OMOS ICS module".

OMOS devices can be time-synchronized - the parameter "Synchronization period" on the tab "Time parameter" in station configuration should be enabled.

Station protocol parameters


Communication station - configuration dialog box - Protocol parameters tab.
These parameters influence some optional parameters of the protocol. You can set the following station parameters:

Table 2

Parameter

Meaning

Unit

Default value

Wait Before Request

Delay that is used before each request.

ms

100

Wait First Timeout

First delay before reading the response after sending the request.

ms

500

Wait Timeout

Timeout between readings of response until it is completed.

ms

400

Retry Timeout

Delay before resending the request when no answer is received.

ms

1000

Max Wait Retry

The number of repeated readings of response until it is completed.

-

8