3,388
edits
Changes
Updating to match new version of source page
<languages/>
===Example of description in XML===
<syntaxhighlight lang="xml" line>
<item addr="201:50" automation="mode1" cfgid="62" name="vent" co2-sensors="997:1" type="vent">
<automation alg="eco" name="mode" co2-level="800">
<time-interval end-time="15:00" start-time="07:00" co2-level="850" week-days="mo;tu;we;th;fr"/>
<time-interval end-time="18:00" start-time="09:00" co2-level="900" week-days="sa;su"/>
</automation>
<automation alg="fast" name="mode1" co2-level="600">
<time-interval end-time="18:00" start-time="09:00" co2-level="650" week-days="mo;tu;we;th;fr"/>
<time-interval end-time="20:00" start-time="12:00" co2-level="700" week-days="sa;su"/>
</automation>
</item>
</syntaxhighlight>
===Additional parameters===
{|class="wikitable"
|-
!Name!!type and variety!!description!!default value
|-
|co2-sensors||list||list of valve co2 sensors (for automation)||-
|-
|automation||string||name of current automation mode||-
|-
|undefined-behavior||0-250/on/off/last||ventilation position in case of sensors readings absence (off – 0; on – 250)||last
|-
|P0||0-100||minimal power for turning on fan||last
|-
|alg||string||eco/fast/boost alg||-
|-
|limit-fan||number(0-250)|| max power
|-
|ctrl-change1||number(0-250)|| min level of power change (one time per "ctrl-ticks" attr) if defined||5
|-
|ctrl-change2||number(0-250)||min level of power change||-
|-
|ctrl-ticks||number(0-3825)||power change by "ctrl-change1" timeout||-
|}
===Automation parameters (optional element)===
{|class="wikitable"
|-
!Name!!type and variety!!description
|-
|name*||string||Device name in the control interface
|-
|co2-level*||number||Temperature level for the intervals not specified in time-interval tags
|-
|alg||string||eco/fast/boost alg
|-
|limit-fan||number(0-250)||max power
|-
|ctrl-change1||number(0-250)||min level of power change (one time per "ctrl-ticks" attr) if defined
|-
|ctrl-change2||number(0-250)||min level of power change
|-
|ctrl-ticks||number(0-3825)||power change by "ctrl-change1" timeout
|}
<nowiki>*</nowiki> – required fields
===Parameters of time-interval (optional element)===
{|class="wikitable"
|-
!Name!!type and variety!!description
|-
|co2-level*||Number||co2 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
|-
|alg||string||eco/fast/boost alg
|-
|limit-fan||number(0-250)||max power
|}
<nowiki>*</nowiki> – required fields
===Device status upon status request (7 bytes)===
{|class="wikitable"
|-
!Byte number!!Bit number!!Description
|-
|0||0<br>1<br>3<br>4-7||On/Off<br>Fan On/Off<br>Boost On/Off<br>Integration algorithm (slow,medium,fast,boost)
|-
|1-2||8-23||CO2 setpoint (<-100 - no automation)
|-
|3-4||24-39||CO2 current (<-100 - no automation or undefined all CO2 sensors)
|-
|5||40-43<br>44-47||Current automation time interval index<br>Current automation index
|-
|6||48-55||Current fan level (0-250)
|-
|7||56<br>57<br>61<br>62<br>63||Error: Has undefined CO2 sensor(s)<br>Error: Has no any defined CO2 sensor<br>Error: low power for accessing setpoint<br>Error: fan state is undef<br>Reserved
|}
===Possible variants of setting the status===
====1-byte====
{|class="wikitable"
|-
!Byte!!Description
|-
|0||0 – off<br>1 – on<br>0xFF – Change the status for the opposite one
|}
====2-bytes====
{|class="wikitable"
|-
!Byte!!Description
|-
|0||0 – off<br>1 – on<br>0xFF – Change the status for the opposite one<br>0xFE – do not change
|-
|1||0-250 – Power
|}
===Example of description in XML===
<syntaxhighlight lang="xml" line>
<item addr="201:50" automation="mode1" cfgid="62" name="vent" co2-sensors="997:1" type="vent">
<automation alg="eco" name="mode" co2-level="800">
<time-interval end-time="15:00" start-time="07:00" co2-level="850" week-days="mo;tu;we;th;fr"/>
<time-interval end-time="18:00" start-time="09:00" co2-level="900" week-days="sa;su"/>
</automation>
<automation alg="fast" name="mode1" co2-level="600">
<time-interval end-time="18:00" start-time="09:00" co2-level="650" week-days="mo;tu;we;th;fr"/>
<time-interval end-time="20:00" start-time="12:00" co2-level="700" week-days="sa;su"/>
</automation>
</item>
</syntaxhighlight>
===Additional parameters===
{|class="wikitable"
|-
!Name!!type and variety!!description!!default value
|-
|co2-sensors||list||list of valve co2 sensors (for automation)||-
|-
|automation||string||name of current automation mode||-
|-
|undefined-behavior||0-250/on/off/last||ventilation position in case of sensors readings absence (off – 0; on – 250)||last
|-
|P0||0-100||minimal power for turning on fan||last
|-
|alg||string||eco/fast/boost alg||-
|-
|limit-fan||number(0-250)|| max power
|-
|ctrl-change1||number(0-250)|| min level of power change (one time per "ctrl-ticks" attr) if defined||5
|-
|ctrl-change2||number(0-250)||min level of power change||-
|-
|ctrl-ticks||number(0-3825)||power change by "ctrl-change1" timeout||-
|}
===Automation parameters (optional element)===
{|class="wikitable"
|-
!Name!!type and variety!!description
|-
|name*||string||Device name in the control interface
|-
|co2-level*||number||Temperature level for the intervals not specified in time-interval tags
|-
|alg||string||eco/fast/boost alg
|-
|limit-fan||number(0-250)||max power
|-
|ctrl-change1||number(0-250)||min level of power change (one time per "ctrl-ticks" attr) if defined
|-
|ctrl-change2||number(0-250)||min level of power change
|-
|ctrl-ticks||number(0-3825)||power change by "ctrl-change1" timeout
|}
<nowiki>*</nowiki> – required fields
===Parameters of time-interval (optional element)===
{|class="wikitable"
|-
!Name!!type and variety!!description
|-
|co2-level*||Number||co2 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
|-
|alg||string||eco/fast/boost alg
|-
|limit-fan||number(0-250)||max power
|}
<nowiki>*</nowiki> – required fields
===Device status upon status request (7 bytes)===
{|class="wikitable"
|-
!Byte number!!Bit number!!Description
|-
|0||0<br>1<br>3<br>4-7||On/Off<br>Fan On/Off<br>Boost On/Off<br>Integration algorithm (slow,medium,fast,boost)
|-
|1-2||8-23||CO2 setpoint (<-100 - no automation)
|-
|3-4||24-39||CO2 current (<-100 - no automation or undefined all CO2 sensors)
|-
|5||40-43<br>44-47||Current automation time interval index<br>Current automation index
|-
|6||48-55||Current fan level (0-250)
|-
|7||56<br>57<br>61<br>62<br>63||Error: Has undefined CO2 sensor(s)<br>Error: Has no any defined CO2 sensor<br>Error: low power for accessing setpoint<br>Error: fan state is undef<br>Reserved
|}
===Possible variants of setting the status===
====1-byte====
{|class="wikitable"
|-
!Byte!!Description
|-
|0||0 – off<br>1 – on<br>0xFF – Change the status for the opposite one
|}
====2-bytes====
{|class="wikitable"
|-
!Byte!!Description
|-
|0||0 – off<br>1 – on<br>0xFF – Change the status for the opposite one<br>0xFE – do not change
|-
|1||0-250 – Power
|}