OneSoft devices communication protocol

Supported device types and versions
Communication line configuration
Communication station configuration
Station protocol parameters
I/O tag configuration
Literature
Changes and modifications
Document revisions

Supported device types and versions

---

This protocol supports data acquisition (as regards SOFTCONTROL and OMOS device 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, 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 non parity),

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

Protocol line parameters

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

In the configuration dialog window of station you can choose a device in which you preset 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 a technical documentation from a producer. At the end of data block you can find the following information:

From this information it results that the value for "Data block size" and "Checksum after" is 316 (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 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 protocol. You can set the following station parameters:

Table 2

Note related to the parameters "Begin of write block" and "End of write block":
These parameters are useful for SOFTCONTROL and OMOS in case of value writing.

SOFTCONTROL: The documentation shows the information in the data block of response as follows:

It marks the beginning of data block with writing possibility. In this case, the value is 156. The whole data block is written in different color in documentation.

OMOS: The setting of "Begin of write block" is 50 for all module types. The value of "End of write block" is 111.

I/O tag configuration

---

I/O tags: Di, Ai, Ci, TiA, Ao, Co

In configuration of I/O tag address you must define the following parameters:

• A position of value start in data block („Position:“). If regards I/O tags of Di type, you can also define a bit number (0 to 7 for single-byte values, 0 to 15 for double-byte and 0 to 31 for four-byte). The address is written as Position.Bit, e.g. "24.0" means that the position = 24, the bit number = 0.

• Value type:

  • „BYTE“ – 1 byte unsigned,

  • „INT“ – 2 byte integer signed,

  • „LONG“ – 4 bytes integer signed,

  • „WORD“ – 2 byte word unsigned,

  • „ULONG“ – 4 byte word unsigned,

  • „FLOAT“ – 4 byte float,

  • „DOUBLE“ – 8 byte float (only for Maxtronic 05).

The values, their meaning, the address parameter, technical units, multiply coefficient, are stated in Table 3. For SOFTCONTROL devices, the address parameter "Position" can be found in technical documentation. The address is the number in square brackets behind the word "sprava", e.g.:

In this example, the address "Position" is 24.

You can configure one I/O tag of TiA type (a actual time of a meter with minute accuracy) for each station. A time in data block is always on the same position, therefore you need not configure the parameter "Position:" (it is not applicable for SOFTCONTROL).

Table 3