Difference between revisions of "Airzone"

From HSYCO
Jump to navigation Jump to search
 
(10 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
[http://www.airzoneitalia.it Airzone] is a control framework for ducted air conditioning systems which allows for the control of several zones independently.  
 
[http://www.airzoneitalia.it Airzone] is a control framework for ducted air conditioning systems which allows for the control of several zones independently.  
  
This I/O server provides support for this Airzone systems: INNOBUS, FLEXA, ANTREE and CEN.
+
This I/O server provides support for this Airzone systems: INNOBUS, FLEXA, ANTREE and CEN (ModBus protocol before year 2020).
  
 
[[Category:I/O Server]]
 
[[Category:I/O Server]]
Line 28: Line 28:
  
 
== HSYCO Configuration ==
 
== HSYCO Configuration ==
 +
Add an AIRZONE I/O Server in the [[Settings#I/O Servers|I/O Servers section of the Settings]] and set its parameters:
 +
 +
=== Communication ===
 +
*'''Comm ID''': the modbus gateway the device is connected to and its modbus address (separated by “/”). You can both specify the IP address of the gateway or the name of the corresponding CommPort.
 +
 +
=== High Availability ===
 +
*'''Shutdown when inactive''': defaults to true.
  
 
=== Options ===
 
=== Options ===
Line 153: Line 160:
 
|combheating
 
|combheating
 
|-
 
|-
|dehumid<sup>[[#note2|[Note 2]]]</sup>
+
|style="white-space:nowrap"|dehumid<sup>[[#note2|[Note 2]]]</sup>
  
 
|-
 
|-
Line 248: Line 255:
 
|-
 
|-
  
|rowspan="2" |config.motregulationtype<sup>[[#note1|[Note 1]]]</sup>
+
|rowspan="2"|config.motregulationtype<sup>[[#note1|[Note 1]]]</sup>
 
|on/off
 
|on/off
 
|W
 
|W
Line 1,028: Line 1,035:
 
|-
 
|-
  
|rowspan="2" |z<n>.error
+
|rowspan="2" |time
 
|0
 
|0
 
|W
 
|W
Line 1,039: Line 1,046:
  
 
== User Interface ==
 
== User Interface ==
 
You can use the [[airzone]] object in the Project Editor to easily and quickly create the Airzone user interface.
 
  
 
=== Airzone Object ===
 
=== Airzone Object ===
 
The Airzone object creates the Web user interface for the Airzone control framework. There is no need to write any additional EVENTS or Java code.
 
 
The Airzone object is listed in the Project Editor’s new object list only when at least one Airzone I/O Server is defined.
 
  
 
{{:Airzone_(UI Object)}}
 
{{:Airzone_(UI Object)}}
  
 
=== UISET Actions ===
 
=== UISET Actions ===
You can use any object that accepts a text attribute, [[usually]] text, but also [[marquee]] and others, to display the status of the system according to the following table:
 
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 1,432: Line 1,432:
  
 
For instance, setting the name of a user button to '<ioserver_id>.z1.power' and its param field to 'flip', will result in having a switch for zone 1. Naming it '<ioserver_id>.z1.mode' with a valid working mode as param (e.g. 'stop' or 'cold') will result in a button for setting the mode of the zone.
 
For instance, setting the name of a user button to '<ioserver_id>.z1.power' and its param field to 'flip', will result in having a switch for zone 1. Naming it '<ioserver_id>.z1.mode' with a valid working mode as param (e.g. 'stop' or 'cold') will result in a button for setting the mode of the zone.
 
  
 
== Release Notes ==
 
== Release Notes ==

Latest revision as of 14:29, 10 March 2022

Airzone is a control framework for ducted air conditioning systems which allows for the control of several zones independently.

This I/O server provides support for this Airzone systems: INNOBUS, FLEXA, ANTREE and CEN (ModBus protocol before year 2020).

Communication

Airzone communicates with HSYCO through a modbus connection employing a RS-485 gateway.

RS-485 parameters:

Baud rate 19200
Data bits 8
Stop bit 1
Parity even
Flow control none

HSYCO Configuration

Add an AIRZONE I/O Server in the I/O Servers section of the Settings and set its parameters:

Communication

  • Comm ID: the modbus gateway the device is connected to and its modbus address (separated by “/”). You can both specify the IP address of the gateway or the name of the corresponding CommPort.

High Availability

  • Shutdown when inactive: defaults to true.

Options

ID Default Values Description
gui true true enable support for the UI object, UISET actions and USER commands
false disable UI support
startupevents false true generate IO events also during the driver’s start-up phase
false start generating events only after HSYCO is aligned with the current status of the system
pollinterval 20 n > 0 the data acquisition interval, in seconds
version 1 1 use protocol version 1
2 use protocol version 2

Datapoints

ID Value R/W Description
connection online R connection established
offline R HSYCO can't connect to the panel
z<n>.name[Note 2] <text> R the name of zone <n> is set to <text>
power 0 R the system is off
W turn off the system
1 R the system is on
W turn on the system
setpoint.temp <val> W set the setpoint temperature of all the zones to <val>
temp.unit c R the system unit for the temperature is set to °C/10
f R the system unit for the temperature is set to °F
mode stop RW read/write the working mode of the system
cold
heatpump
ventilation
heatingfloor
combheating
dehumid[Note 2]
mode.eco[Note 1] 0 W set the Eco-Sleep mode off on all the zones
1 W set the Eco-Sleep mode on on all the zones
mode.control manual W set the control mode of all the zones to manual
automatic W set the control mode of all the zones to automatic
mode.hold 0 W disable the touch hold of the system
1 W enable the touch hold of the system
mode.fanspeed auto R the fancoil fan speed of the system is set to automatic
W set the fancoil fan speed of the system to automatic
1 R the fancoil fan speed of the system is set to speed 1
W set the fancoil fan speed of the system to speed 1
2 R the fancoil fan speed of the system is set to speed 2
W set the fancoil fan speed of the system to speed 2
3 R the fancoil fan speed of the system is set to speed 3
W set the fancoil fan speed of the system to speed 3
flip W cycle on the fancoil fan speed status following the order: auto - 1 - 2 - 3 - auto ...
mode.sleep[Note 2] off W set sleep mode to off on all zones
30 W set sleep mode to 30 minutes on all zone
60 W set sleep mode to 60 minutes on all zones
90 W set sleep mode to 90 minutes on all zones
flip W cycle on the sleep mode status following the order: off - 30 - 60 - 90 - off ...
config.motregulationtype[Note 1] on/off W set the motorization regulation type of all the zones to "on/off"
proportional W set the motorization regulation type of all the zones to "proportional"
config.motcontrolled[Note 1] 0 W disable the control of the motorization on all the zones
1 W enable the control of the motorization on all the zones
config.ac[Note 2] 0 W disable air conditioning on all zones
1 W enable air conditioning on all zones
config.heatingfloorctrl 0 W disable the heating floor controller on all zones
1 W enable the heating floor controller on all zones
config.angle.heating 90 W write the intelligent motorized grille opening angle on heating mode (expressed in °) on all the zones
50
45
40
config.angle.cooling 90 W write the intelligent motorized grille opening angle on cooling mode (expressed in °) on all the zones
50
45
40
config.minairdamper 0 W disabled the minimum air damper control on all the zones
1 W enabled the minimum air damper control on all the zones
config.probe off W set the local probe to off on all zones
remote W set the remote probe as input on all zones
floor W set the probe as electrical heating floor protection on all zones
config.ecoinput disabled W disable the Eco-Sleep activation input on all zones
open W enable the Eco-Sleep activation input in “normally open” mode on all zones
closed W enable the Eco-Sleep activation input in “normally closed” mode on all zones
config.forcedoffinput[Note 1] disabled W disable the local forced off input on all zones
open W enable the local forced off input in “normally open” mode on all zones
closed W enable the local forced off input in “normally closed” mode on all zones
z<n>.power 0 R the zone is off
W turn off the zone
1 R the zone is on
W turn on the zone
flip W switch the status of the zone
z<n>.setpoint.temp <val> R the setpoint temperature of this zone is set to <val>
W set the setpoint temperature of the zone to <val>
up W increase the setpoint temperature of 0.5 °C or 1°F depending on the system settings
down W decrease the setpoint temperature of 0.5 °C or 1°F depending on the system settings
z<n>.localtemp <val> R the local temperature is <val>
z<n>.remotetemp <val> R the temperature measured by the remote probe is <val>
z<n>.temp <val> R the temperature measured by the input probe of this zone is <val>.

For protocol version 1, if the 'z<n>.config.probe' datapoint has value 'remote', then <val> corresponds to the value of the 'z<n>.remotetemp' datapoint, otherwise to the value of the 'z<n>.localtemp' datapoint. For protocol version 2, if the 'z<n>.config.probe' datapoint has value '1', then <val> corresponds to the value of the 'z<n>.remotetemp' datapoint, otherwise to the value of the 'z<n>.localtemp' datapoint.

z<n>.mode.eco[Note 1] 0 R the Eco-Sleep mode is disabled for zone <n>
W set the Eco-Sleep mode off for zone <n>
1 R the Eco-Sleep mode is active for zone <n>
W set the Eco-Sleep mode on for zone <n>
flip W switch the Eco-Sleep mode status of zone <n>
z<n>.mode.control manual R the control mode for zone <n> is set to manual
W set the control mode of zone <n> to manual
automatic R the control mode for zone <n> is set to automatic
W set the control mode of zone <n> to automatic
flip W switch the control mode of zone <n>
z<n>.mode.hold 0 R the touch hold is disabled on zone <n>
W disable the touch hold of zone <n>
1 R the touch hold is enabled on zone <n>
W enable the touch hold of zone <n>
z<n>.mode.fanspeed auto R the fancoil fan speed of zone <n> is set to automatic
W set the fancoil fan speed of zone <n> to automatic
1 R the fancoil fan speed of zone <n> is set to speed 1
W set the fancoil fan speed of zone <n> to speed 1
2 R the fancoil fan speed of zone <n> is set to speed 2
W set the fancoil fan speed of zone <n> to speed 2
3 R the fancoil fan speed of zone <n> is set to speed 3
W set the fancoil fan speed of zone <n> to speed 3
flip W cycle on the fancoil fan speed status following the order: auto - 1 - 2 - 3 - auto ...
z<n>.mode.fancoilpower[Note 1] 0 R the activation status of the fancoil of this zone if set to off
1 R the activation status of the fancoil of this zone if set to on
z<n>.mode.sleep[Note 2] off R sleep mode is off on zone <n>
W set sleep mode to off on zone <n>
30 R sleep mode is set to 30 minutes on zone <n>
W set sleep mode to 30 minutes on zone <n>
60 R sleep mode is set to 60 minutes on zone <n>
W set sleep mode to 60 minutes on zone <n>
90 R sleep mode is set to 90 minutes on zone <n>
W set sleep mode to 90 minutes on zone <n>
flip W cycle on the sleep mode status following the order: off - 30 - 60 - 90 - off ...
z<n>.mode.prog[Note 2] 0 R time programming is disabled on this zone
1 R time programming is enabled on this zone
z<n>.mode stop RW read/write the working mode of zone <n>. It is possible to write the working mode of a zone only if it is configured as master (setting the working mode of a master zone will also change the mode of all the zones connected to the same controller)
cold
heatpump
ventilation
heatingfloor
combheating
dehumid[Note 2]
z<n>.config.master 0 R zone <n> is not configured as master
W set zone <n> as not master
1 R zone <n> is configured as master
W set zone <n> as master
z<n>.config.motregulationtype[Note 1] on/off R the motorization regulation type of zone <n> is set to "on/off"
W set the motorization regulation type of zone <n> to "on/off"
proportional R the motorization regulation type of zone <n> is set to "proportional"
W set the motorization regulation type of zone <n> to "proportional"
z<n>.config.motcontrolled[Note 1] 0 R the control of the motorization is disabled on zone <n>
W disable the control of the motorization on zone <n>
1 R the control of the motorization is enabled on zone <n>
W enable the control of the motorization on zone <n>
z<n>.config.ac[Note 2] 0 R air conditioning is disabled on zone <n>
W disable air conditioning on zone <n>
1 R air conditioning is enabled on zone <n>
W enable air conditioning on zone <n>
z<n>.config.heatingfloorctrl 0 R the heating floor controller is disabled on zone <n>
W disable the heating floor controller on zone <n>
1 R the heating floor controller is enabled on zone <n>
W enable the heating floor controller on zone <n>
z<n>.config.antifreeze[Note 2] 0 R antifreeze function not configured on zone <n>
1 R antifreeze function configured on zone <n>
z<n>.config.angle.heating 90 RW read/write the intelligent motorized grille opening angle on heating mode (expressed in °)
50
45
40
z<n>.config.angle.cooling 90 RW read/write the intelligent motorized grille opening angle on cooling mode (expressed in °)
50
45
40
z<n>.config.minairdamper 0 R the minimum air damper control on zone <n> is disabled
W disabled the minimum air damper control on zone <n>
1 R the minimum air damper control on zone <n> is enabled
W enabled the minimum air damper control on zone <n>
z<n>.config.probe off[Note 1] R the local probe is off on zone <n>
W set the local probe to off on zone <n>
remote[Note 1] R the remote probe temperature is set to be the input temperature on zone <n>
W set the remote probe as input on zone <n>
floor[Note 1] R the probe is used as electrical heating floor protection probe on zone <n>
W set the probe as electrical heating floor protection on zone <n>
0[Note 2] R remote probe not connected on zone <n>
1[Note 2] R remote probe connected on zone <n>
z<n>.config.ecoinput disabled R the Eco-Sleep activation input is disabled on zone <n>
W disable the Eco-Sleep activation input on zone <n>
open R the Eco-Sleep activation input is enabled and set to “normally open” mode on zone <n>
W enable the Eco-Sleep activation input in “normally open” mode on zone <n>
closed R the Eco-Sleep activation input is enabled and set to “normally closed” mode on zone <n>
W enable the Eco-Sleep activation input in “normally closed” mode on zone <n>
z<n>.config.forcedoffinput[Note 1] disabled R the local forced off input is disabled on zone <n>
W disable the local forced off input on zone <n>
open R the local forced off input is enabled and set to “normally open” mode on zone <n>
W enable the local forced off input in “normally open” mode on zone <n>
closed R the local forced off input is enabled and set to “normally closed” mode on zone <n>
W enable the local forced off input in “normally closed” mode on zone <n>
z<n>.status.outlet 0 R the motorized outlet is closed on zone <n>
1 R the motorized outlet is open on zone <n>
z<n>.status.motor 0 R the outlet motor is inactive on zone <n>
1 R the outlet motor is active on zone <n>
z<n>.status.heatingfloor 0 R the heating floor is inactive on zone <n>
1 R the heating floor is active on zone <n>
z<n>.status.moduletype outlet R the module type of zone <n> is motorized outlet
fancoil R the module type of zone <n> is fancoil module
z<n>.status.ecoinput[Note 1] 0 R the module Eco-Sleep input is inactive on zone <n>
1 R the module Eco-Sleep input is active on zone <n>
z<n>.status.onoffinput[Note 1] 0 R the module on/off input is inactive on zone <n>
1 R the module on/off input is active on zone <n>
z<n>.status.fanspeed 0 R the fancoil ventilation is off on zone <n>
1 R the fancoil ventilation speed is set to 1 on zone <n>
2 R the fancoil ventilation speed is set to 2 on zone <n>
3 R the fancoil ventilation speed is set to 3 on zone <n>
z<n>.status.propopening 1 R the proportional opening status is set to step 1 on zone <n>
2 R the proportional opening status is set to step 2 on zone <n>
3 R the proportional opening status is set to step 3 on zone <n>
4 R the proportional opening status is set to step 4 on zone <n>
z<n>.status.thermconnection 0 R the thermostat is not connected to zone <n>
1 R the thermostat is connected to zone <n>
z<n>.status.antifreeze[Note 2] 0 R antifreeze function not active on zone <n>
1 R antifreeze function active on zone <n>
z<n>.error.motconnection 0 R the motor is properly connected to the module of zone <n>
1 R the motor is not connected to the module of zone <n>
z<n>.error.motblock 0 R the motor is not blocked zone <n>
1 R the motor is blocked on zone <n>
z<n>.error.probeopen 0 R the probe input is not in open circuit on zone <n>
1 R the probe input is in open circuit on zone <n>
z<n>.error.probeshort 0 R the probe input is not in short circuit on zone <n>
1 R the probe input is in short circuit on zone <n>
z<n>.error.config 0 R the configuration is OK on zone <n>
1 R the configuration is not compatible with zone <n>
z<n>.error.comm 0 R communication with remote probe OK on zone <n>
1 R communication with remote probe lost on zone <n>
z<n>.error 0 R none of the above errors is active on zone <n>
1 R at least one of the above errors is active on zone <n>
time 0 W unset the system time
<d>:<h>:<m> W set the system time to the specified value. <d> indicates the day (1 = Monday, ..., 7 = Sunday) <h> specifies the hour (from 0 to 23) and <m> the minutes (from 1 to 59). For instance a value of “2:13:10” represents the time 1:10 pm of Tuesday.

User Interface

Airzone Object

The user interface for the Airzone control framework:

File:UI Object airzone.png

The (airzone) object is listed in the Project Editor’s new object list only when at least one Airzone I/O Server is defined.

Parameters

  • server id: the server ID. Supports Redirect variables
  • zone: the zone. Supports Redirect variables
  • position: the object's position. Use the pixels or rows and columns coordinates format

Syntax

(airzone <server id>; <zone>; <position>)

E.g.

(airzone serverid; zone; x10y20)

UISET Actions

ID Attribute Set to
connection.label.online visible true when datapoint connection = online
false when datapoint connection = offline
connection.label.offline visible true when datapoint connection = offline
false when datapoint connection = online
z<n>.name[Note 2] value name of zone <n>
power.label.on visible true when the system is on
false when the system is off
power.label.off visible true when the system is off
false when the system is on
mode.label.stop visible true when the working mode of the system is set to 'stop'
false when the working mode of the system is not set to 'stop'
mode.label.cold visible true when the working mode of the system is set to 'cold'
false when the working mode of the system is not set to 'cold'
mode.label.heatpump visible true when the working mode of the system is set to 'heatpump'
false when the working mode of the system is not set to 'heatpump'
mode.label.ventilation visible true when the working mode of the system is set to 'ventilation'
false when the working mode of the system is not set to 'ventilation'
mode.label.heatingfloor visible true when the working mode of the system is set to 'heatingfloor'
false when the working mode of the system is not set to 'heatingfloor'
mode.label.combheating visible true when the working mode of the system is set to 'combheating'
false when the working mode of the system is not set to 'combheating'
mode.label.dehumid[Note 2] visible true when the working mode of the system is set to 'dehumid'
false when the working mode of the system is not set to 'dehumid'
mode.fanspeed.label.auto visible true when the fancoil fan speed of the system is set to 'auto'
false when the fancoil fan speed of the system is not set to 'auto'
mode.fanspeed.label.1 visible true when the fancoil fan speed of the system is set to 1
false when the fancoil fan speed of the system is not set to 1
mode.fanspeed.label.2 visible true when the fancoil fan speed of the system is set to 2
false when the fancoil fan speed of the system is not set to 2
mode.fanspeed.label.3 visible true when the fancoil fan speed of the system is set to 3
false when the fancoil fan speed of the system is not set to 3
z<n>.power.label.on visible true when zone <n> is on
false when zone <n> is off
z<n>.power.label.off visible true when zone <n> is off
false when zone <n> is on
z<n>.localtemp value the local temperature of zone <n> in °C or °F depending on the system settings
z<n>.remotetemp value the remote probe temperature of zone <n> in °C or °F depending on the system settings
z<n>.temp value the value of datapoint 'z<n>.temp' depending on the protocol version
z<n>.setpoint.temp value the setpoint temperature of zone <n> in °C or °F depending on the system settings
visible true when zone <n> is on and set to manual control mode
false when zone <n> is off or not manual mode
z<n>.mode.eco.label.on[Note 1] visible true when zone <n> is set to Eco-Sleep mode
false when zone <n> is not set to Eco-Sleep mode
z<n>.mode.eco.label.off[Note 1] visible true when zone <n> is not set to Eco-Sleep mode
false when zone <n> is set to Eco-Sleep mode
z<n>.mode.sleep[Note 2] value the current time set for the sleep mode or “OFF” if disabled
z<n>.mode.label.stop visible true when the working mode of zone <n> is set to 'stop'
false when the working mode of zone <n> is not set to 'stop'
z<n>.mode.label.cold visible true when the working mode of zone <n> is set to 'cold'
false when the working mode of zone <n> is not set to 'cold'
z<n>.mode.label.heatpump visible true when the working mode of zone <n> is set to 'heatpump'
false when the working mode of zone <n> is not set to 'heatpump'
z<n>.mode.label.ventilation visible true when the working mode of zone <n> is set to 'ventilation'
false when the working mode of zone <n> is not set to 'ventilation'
z<n>.mode.label.heatingfloor visible true when the working mode of zone <n> is set to 'heatingfloor'
false when the working mode of zone <n> is not set to 'heatingfloor'
z<n>.mode.label.combheating visible true when the working mode of zone <n> is set to 'combheating'
false when the working mode of zone <n> is not set to 'combheating'
z<n>.mode.label.dehumid[Note 2] visible true when the working mode of zone <n> is set to 'dehumid'
false when the working mode of zone <n> is not set to 'dehumid'
z<n>.mode.control.manual visible true when the control mode of zone <n> is set to 'manual'
false when the control mode of zone <n> is set to 'automatic'
z<n>.mode.control.automatic visible true when the control mode of zone <n> is set to 'automatic'
false when the control mode of zone <n> is set to 'manual'
z<n>.mode.fanspeed.label.auto visible true when the fancoil fan speed of zone <n> is set to 'auto'
false when the fancoil fan speed of zone <n> is not set to 'auto'
z<n>.mode.fanspeed.label.1 visible true when the fancoil fan speed of zone <n> is set to 1
false when the fancoil fan speed of zone <n> is not set to 1
z<n>.mode.fanspeed.label.2 visible true when the fancoil fan speed of zone <n> is set to 2
false when the fancoil fan speed of zone <n> is not set to 2
z<n>.mode.fanspeed.label.3 visible true when the fancoil fan speed of zone <n> is set to 3
false when the fancoil fan speed of zone <n> is not set to 3
z<n>.status.motor.label.on visible true when the the outlet motor of zone <n> is active
false when the the outlet motor of zone <n> is not active
z<n>.status.motor.label.off visible true when the the outlet motor of zone <n> is not active
false when the the outlet motor of zone <n> is active
z<n>.error.label.0 visible true when zone <n> is correctly working
false when zone <n> is in an error state
z<n>.error.label.1 visible true when zone <n> is in an error state
false when zone <n> is correctly working

Note 1 
Only for protocol version 1

Note 2 
Only for protocol version 2

USER Commands

To send a user command to the I/O Server just set the name to the ID of a writable (W) datapoint and the parameter to one of the possible values.

For instance, setting the name of a user button to '<ioserver_id>.z1.power' and its param field to 'flip', will result in having a switch for zone 1. Naming it '<ioserver_id>.z1.mode' with a valid working mode as param (e.g. 'stop' or 'cold') will result in a button for setting the mode of the zone.

Release Notes

3.1.0

  • Added support for protocol version 2

3.0.0

  • Initial release


Airzone, Innobus, Flexa, and Antree are registered trademarks of Airzone.