Page tree
Skip to end of metadata
Go to start of metadata

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

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

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:

/***********************************************************************/
 
 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 (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

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 of the request when no answer is received. ms 1000
Max Wait Retry Number of repeated readings of response until it is completed. - 8
Retry Count Maximum number of repeated requests. - 3
Request Repetition Number of repeated request sent before reading the answer. - 1
OMOS Device Communication with OMOS. YES/NO NO
OMOS ICS Module ICS address of module of OMOS (module SYSTEM=0, other modules UK/TUV as per configuration). - 0
Maxtronic 05 Communication with MAXTRONIC 05. YES/NO NO
SoftControl Device Communication with SOFTCONTROL. YES/NO NO
Begin of Write Block Begin index of data block for writing to SOFTCONTROL/OMOS (see note). - 156
End of Write Block End index of data block for writing to SOFTCONTROL/OMOS (see note). - 283

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:

/***************** beginning of parameters change ***************************/
 
 //VZT-A TUV1 ------
 pmc=tzmi[5] *10; sprava[156] // 50-z 1.TEPLOTNA HLADINA
 pmc=tzmi[6] *10; sprava[158] // 51-z 2.TEPLOTNA HLADINA 
...

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.:

pmc=ttuv2          *10; sprava[ 24] //   8 - VLHKOST A 

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

ELTRONIC
Value Tech. units Position Value type Multiply coefficient
Analog value 1   9 INT 10
Analog value 2   11 INT 10
Analog value 3   13 INT 10
Analog value 4   15 INT 10
El. power M1 kW (MW) 17 INT 100
El. power M2 kW (MW) 19 INT 100
El. work M1 kWh (MWh) 25 LONG 10
El. work M2 kWh (MWh) 29 LONG 10
Running time M1 min 33 LONG  
Running time M2 min 37 LONG  
Date of reset M1   41 LONG  
Date of reset M2   45 LONG  
Phys. size of analog value A1   49 INT  
Phys. size of analog value A2   51 INT  
Phys. size of analog value A3   53 INT  
Phys. size of analog value A4   55 INT  
Real time of interval M1 min 57 INT  
Real time of interval M2 min 63 INT  
Dimension of quantity M1 (MWh,kWh,MW,kW)   61 INT  
Dimension of quantity M2 (MWh,kWh,MW,kW)   63 INT  
Set 1/4 hour max. M1   69 INT 10
Set 1/4 hour max. M2   71 INT 10
Actual 1/4 hour work M1   73 INT 10
Actual 1/4 hour work M2   75 INT 10
FC200 ST
Value Tech. units Position Value type Multiply coefficient
Steam temperature °C 9 INT 10
Condensing temperature °C 11 INT 10
Steam pressure abs. kPa 13 INT  
Mass flow rate - steam t,kg / hour 17 INT  
Mass flow rate - condensate t,kg / hour 19 INT  
Heat rate - steam MW, kW 21 INT  
Heat rate - condensate MW, kW 23 INT  
Heat steam MWh, kWh 25 LONG 100
Heat condensate MWh, kWh 29 LONG 100
Running time - circuit 1 min 33 LONG  
Running time - circuit 2 min 37 LONG  
Date of reset - circuit 1   41 LONG  
Date of reset - circuit 2   45 LONG  
Steam quantity t, kg 49 LONG 100
Condensate quantity m3, lit. 53 LONG 100
Heat under limit of saturation - steam kWh, MWh 69 LONG 100
Differential pressure - steam kPa 73 INT 100
Differential pressure - condensate kPa 75 INT 100
Lower limit of manometer - steam kPa 77 INT  
Lower limit of manometer - condensate kPa 79 INT  
Superheating - steam °C 83 INT 10
FC200 WM
Value Tech. unit Position Value type Multiply coefficient
Temperature Output °C 9 INT 10
Temperature Reverse °C 11 INT 10
Method of flow measurement O - 3   13 INT  
Flow m3,l / hour 17 INT 10
Heat rate MW, kW 21 INT 100
Quantity of heat MWh, kWh 25 LONG 100
Running time min 33 LONG  
Water quantity m3, l 49 LONG 100
Size 0 - m3/t, 1 - l/kg   61 INT  
Delta P kPa 73 INT 100
Water enthalpy - output kJ / kg 83 INT  
Water enthalpy - reverse kJ / kg 85 INT  
MAXTRONIC
Value Tech. unit Position Value type Multiply coefficient
Temperature - output M.1 °C 9 INT 10
Temperature - reverse M.1 °C 11 INT 10
Temperature - output M.2 °C 13 INT 10
Temperature - reverse M.2 °C 15 INT 10
Flow M.1 m3 / hour 17 INT 10
Flow M.2 m3 / hour 19 INT 10
Temperature power M.1 MW 21 INT 100
Temperature power M.2 MW 23 INT 100
Quantity of heat M.1 MWh 25 LONG 100
Quantity of heat M.2 MWh 29 LONG 100
Running time M1 min 33 LONG  
Running time M2 min 37 LONG  
Max. 1/4 hour power M1 MW 49 INT 100
K factor M1 imp / m3 51 INT  
Actual 1/4 hour power M1 MW 53 INT 100
K factor M2 imp / m3 55 INT  
Water quantity M1 m3 73 LONG 100
Water quantity M2 m3 77 LONG 100
STEAMTRONIC B
Value Tech. unit Position Value type Multiply coefficient
Steam temperature °C 9 INT 10
Temperature condensate °C 11 INT 10
Steam pressure kPa 13 INT  
Steam flow t / hour 17 INT 100
Flow - condensate m3 / hour 19 INT 100
Heat rate - steam MW 21 INT 100
Heat rate - condensate MW 23 INT 100
Total heat - steam MWh 25 LONG 100
Quantity of heat - condensate MWh 29 LONG 100
Running time of device min 33 LONG  
Total heat T<satur MWh 37 LONG 100
Amount of steam ton 49 LONG 100
Quantity of condensate m3 53 LONG 100
Interval heat MWh 69 LONG 100
Lower limit of manometer kPa 77 INT  
Higher limit of manometer kPa 79 INT  
STEAMTRONIC D
Value Tech. unit Position Value type Multiply coefficient
Steam temperature M.1 °C 9 INT 10
Temperature of condensate M.2 °C 11 INT 10
Steam pressure M.2 kPa 13 INT  
Flow M.1 kg,t / hour 17 INT 100
Flow M.2 l,m3 / hour 19 INT 100
Temperature - output M.1 kW, MW 21 INT 100
Temperature - output M.2 kW, MW 23 INT 100
Quantity of heat M.1 kWh, MWh 25 LONG 100
Quantity of heat M.2 kWh, MWh 29 LONG 100
Running time M1 min 33 LONG  
Quantity of heat under limit of density kWh, MWh 37 LONG 100
Amount of steam M1 kg, t 49 LONG 100
Quantity of condensate l, m3 53 LONG 100
Time when T < Tdens. min 57 LONG  
Measuring steam 0 - t/MW, 1 - kg/kW   61 INT  
Measuring condensate 0 -m3/MW, 1 –l/kW   63 INT  
Lower value on manometer kPa 77 INT  
Higher value on manometer kPa 79 INT  
Superheat of steam °C 83 INT 10

Note: I/O tags whose values are multiplied by coefficient in a meter must be converted to the technical units (I/O tag configuration, tab "Conversion") by a linear conversion according to Table 4:

Table 4

Multiply coefficient Linear conversion – coeff. A Linear conversion – coeff. B
10 0.1 0
100 0.01 0

Warning: I/O tags of Ci type that are modified by linear conversion will lost the accuracy on decimal positions (value will be approximated to integer numbers). We recommend you to use Ai type.

Literature


-

Changes and modifications


-

Document revisions


  • Ver. 1.0 – September 8, 2000 – Creation of document.
  • Ver. 1.1 - January 23, 2002 - Support of SOFTCONTROL device, modification of document.
  • Ver. 1.2 - November 26, 2009 - Support of OMOS device, modification of document.
  • Ver. 1.3 - December 5, 2011 - Support of Maxtronic 05.
Write a comment…