Tus neeg siv phau ntawv

Devices and Features
There are quite a lot of (feature) devices being created. This chapter gives you more information on
them. Given the amount of possible features it’s not really doable to list them all. But here is some
general information.
Features that are related to an OpenTherm MsgID
Most features have a MsgID reference. This is the ID which is used in the OpenTherm protocol. These
IDs carry different information. All of these are converted to feature values.
Byte values from -127..128 or 0..255. Each ID can have max. 2 of these.
Double byte values from 0..65535 or -32768..32767
Double byte fractional (1/256) values from -128 ..127 and 255/256
th
(127.99609375).
These features are all set to show 2 decimals. Your thermostat or boiler may only support
0.1 increases though.
Bit values (flags): false or true, which become 0 resp. 100 and have status set to their
meaning). Each ID can have max. 16 of these.
Noteworthy:
MsgID20 has a button which sends the SC command to the OTGW to sync the clock with
the current time of your HS4 system.
See:
https://otgw.tclcode.com/firmware.html#cmdsc
The following MsgIDs are counters and have a hidden “button” to reset each counter (if
supported by your boiler). No button has been created, so you can’t accidentally reset any
of these counters. If you do want to add the button, please add a Single Value Control
with a value of -1. This is applicable to the following features: MsgID116 Burner Starts,
MsgID117 Pump Starts, MsgID118 DHW Pump/Valve Starts, MsgID119 DHW Burner
Starts, MsgID120 Burner Operation Hours, MsgID121 CH Pump Operation Hours,
MsgID122 DHW Pump/Valve Operation Hours, MsgID123 DHW Burner Operation Hours
See:
https://otgw.tclcode.com/firmware.html#cmdrs
Though it seems that OpenTherm is only used in countries where degrees are expressed
in Celsius, this plugin does support Fahrenheit. At the time of creation of every feature,
the global HS4 setting for that will be checked (Setup > General > Other Settings > Temps
Fahrenheit/Temps Celsius). If the setting is Fahrenheit, the suffix will be set to °F and
otherwise it will be set to °C.
The Temperature Temporary and Temperature Constant features get whole Fahrenheit
values, rather than converted Celsius values. However, behind the dropdown are values
in Celsius. So if you pick a value from the dropdown, it will send the converted value to the
OTGW.
A value will be converted to °F only if the setting is still valid while the value is being
updated. Features will not be changed from °F to °C - and vice versa - if the global setting
is changed. If you want that, please manually change each suffix (or remove and add the
OTGW again if you don’t care much about device references).
Please note that this plugin interprets some messages differently than Opentherm
Monitor. For example MsgID56 DHW Setpoint will show you what the boiler says the
setpoint is, instead of what the thermostat guesses it might be:
T10383C00 Write-Data DHW setpoint (MsgID=56): 60.00
BE0382800 Data-Inv DHW setpoint (MsgID=56): 40.00 Boiler says “No, setpoint is
actually 40.00).
Other features
Then there are features that are not directly related to Msg IDs. Here is a list of all of them:
Connection Status, which shows you if the particular OTGW is Disconnected or
Connected and has buttons to Disconnect, (Re)Connect or send the PS=0 command.
Which is useful if, prior to using this plugin, you have used a solution which used the PS=1
summaries, which stops the OTGW from showing regular OpenTherm messages. In other
words, this should get the messages going again.
Error 01/Error 02/Error 03/Error 04. Please see:
https://otgw.tclcode.com/firmware.html#errors