1,970
edits
Changes
Created page with "==Heating system valve type executor== ===Example of description in XML=== <syntaxhighlight lang="xml" line> <item type="valve-heating" addr="100:48" name="Hall" temperature-..."
==Heating system valve type executor==
===Example of description in XML===
<syntaxhighlight lang="xml" line>
<item type="valve-heating" addr="100:48" name="Hall" temperature-sensors="119:10;119:11" automation="Cold" undefined-behavior="on" sensor-cr="348:35" sensor-cr-hi="30" sensor-cr-lo="10">
<automation name="Hot" temperature-level="8" temperature-lag="0.2">
<time-interval temperature-level="27" start-time="10:00" end-time="22:00" week-days="su;sa"/>
<time-interval temperature-level="26" start-time="10:00" end-time="22:00" week-days="mo;tu;we;th;fr"/>
</automation>
<automation name="Cold" temperature-level="25" temperature-lag="0.7"/>
</item>
</syntaxhighlight>
===Additional parameters===
{|class="wikitable
|-
!Name!!type and variety!!description!!default value
|-
|temperature-sensors||list||list of valve temperature sensors (for automation) || -
|-
|automation||string||name of current automation mode||-
|-
|sub-type||enum||warm-floor||-
|-
|temperature-lag||number||hysteresis range on either side from set-point temperature Set in automation tag. The decimal symbol is dot.||0.5
|-
|undefined-behavior||enum<br>on/off/last||valve position in case of sensors readings absence||last
|-
|sensor-cr||list||temperature-sensor measuring the maximum and minimum critical temperature||-
|-
|sensor-cr-hi||number||upper temperature limit, to disable warm floor in case of overheating||-
|-
|sensor-cr-lo||number||lower temperature limit, to activate the warm floor in case of overcooling.||-
|-
|t-min||number||lower temperature limit to set||0
|-
|t-max||number||upper temperature limit to set||32
|}
===Automation parameters (optional element)===
{|class="wikitable
|-
!Name!!type and variety!!description
|-
|name*||string||Device name in the control interface
|-
|temperature-level*||number||Temperature level for the intervals not specified in time-interval tags
|}
<nowiki>*</nowiki> – required fields
===Parameters of time-interval (optional element):===
{|class="wikitable
|-
!Name!!type and variety!!description
|-
|temperature-level*||Number||temperature level for this time interval
|-
|start-time*||HH:MM||interval starting time
|-
|end-time*||HH:MM||interval ending time
|-
|week-days||list<br>mo;tu;we;th;fr;su;sa||list of week days when this interval is active
|}
* – required fields
===Device status as for event (1 byte)===
{|class="wikitable
|-
!Byte number!!Description
|-
|0||Device status.<br>0 bit:<br>0 – zone is off<br>1 – zone is on<br>4-7 bits – number of current automation mode.<br>Number is depending on order of automation description in logic.
|}
===Device status upon status request (6 bytes)===
{|class="wikitable
|-
!Byte!!Description
|-
|0||Device status.<br>0 bit:<br>0 – zone is off<br>1 – zone is on<br>4-7 bits – number of current automation mode.<br>Number is depending on order of automation description in logic.
|-
|1-2||Set-point temperature, low-high bytes
|-
|3-4||Middle temperature of connected sensors, low-high bytes
|-
|5||254 – "Always off" mode<br>255 – "Manual" mode
|}
===Possible variants of setting the status===
{|class="wikitable
|-
!Byte!!Description
|-
|0||0 – off<br>1 – on<br>0xFF – Change the status for the opposite one
|}
===Example of description in XML===
<syntaxhighlight lang="xml" line>
<item type="valve-heating" addr="100:48" name="Hall" temperature-sensors="119:10;119:11" automation="Cold" undefined-behavior="on" sensor-cr="348:35" sensor-cr-hi="30" sensor-cr-lo="10">
<automation name="Hot" temperature-level="8" temperature-lag="0.2">
<time-interval temperature-level="27" start-time="10:00" end-time="22:00" week-days="su;sa"/>
<time-interval temperature-level="26" start-time="10:00" end-time="22:00" week-days="mo;tu;we;th;fr"/>
</automation>
<automation name="Cold" temperature-level="25" temperature-lag="0.7"/>
</item>
</syntaxhighlight>
===Additional parameters===
{|class="wikitable
|-
!Name!!type and variety!!description!!default value
|-
|temperature-sensors||list||list of valve temperature sensors (for automation) || -
|-
|automation||string||name of current automation mode||-
|-
|sub-type||enum||warm-floor||-
|-
|temperature-lag||number||hysteresis range on either side from set-point temperature Set in automation tag. The decimal symbol is dot.||0.5
|-
|undefined-behavior||enum<br>on/off/last||valve position in case of sensors readings absence||last
|-
|sensor-cr||list||temperature-sensor measuring the maximum and minimum critical temperature||-
|-
|sensor-cr-hi||number||upper temperature limit, to disable warm floor in case of overheating||-
|-
|sensor-cr-lo||number||lower temperature limit, to activate the warm floor in case of overcooling.||-
|-
|t-min||number||lower temperature limit to set||0
|-
|t-max||number||upper temperature limit to set||32
|}
===Automation parameters (optional element)===
{|class="wikitable
|-
!Name!!type and variety!!description
|-
|name*||string||Device name in the control interface
|-
|temperature-level*||number||Temperature level for the intervals not specified in time-interval tags
|}
<nowiki>*</nowiki> – required fields
===Parameters of time-interval (optional element):===
{|class="wikitable
|-
!Name!!type and variety!!description
|-
|temperature-level*||Number||temperature level for this time interval
|-
|start-time*||HH:MM||interval starting time
|-
|end-time*||HH:MM||interval ending time
|-
|week-days||list<br>mo;tu;we;th;fr;su;sa||list of week days when this interval is active
|}
* – required fields
===Device status as for event (1 byte)===
{|class="wikitable
|-
!Byte number!!Description
|-
|0||Device status.<br>0 bit:<br>0 – zone is off<br>1 – zone is on<br>4-7 bits – number of current automation mode.<br>Number is depending on order of automation description in logic.
|}
===Device status upon status request (6 bytes)===
{|class="wikitable
|-
!Byte!!Description
|-
|0||Device status.<br>0 bit:<br>0 – zone is off<br>1 – zone is on<br>4-7 bits – number of current automation mode.<br>Number is depending on order of automation description in logic.
|-
|1-2||Set-point temperature, low-high bytes
|-
|3-4||Middle temperature of connected sensors, low-high bytes
|-
|5||254 – "Always off" mode<br>255 – "Manual" mode
|}
===Possible variants of setting the status===
{|class="wikitable
|-
!Byte!!Description
|-
|0||0 – off<br>1 – on<br>0xFF – Change the status for the opposite one
|}