Airzone
Jump to navigation
Jump to search
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.
Contents
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
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> | |
| z<n>.error | 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
You can use the airzone object in the Project Editor to easily and quickly create the Airzone user interface.
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.
The user interface for the Airzone control framework:
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
- zone: the zone
- 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
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:
| 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.
