Airzone Cloud

• Airzone Cloud
  • Presentation
    • Abstract
    • Module classes
  • Usage
    • Install
    • Start api
    • Get device status
    • Get system status
    • Get all zones status (on all devices / systems)
    • Control a specific zone
    • HVAC mode
      • Available modes
      • Set HVAC mode on a system (and its sub-zones)
  • API doc
    • Constructor

Presentation

Abstract

Allow to communicate easily with Airzone Cloud to retrieve information or to send commands (on/off, temperature, HVAC mode, ...)

Module classes

• AirzoneCloud : represent your AirzoneCloud account. Contains a list of your devices :
  • Device : represent one of your Airzone webserver registered. Contains a list of its systems :
    • System : represent your climate equipment (Mitsubishi, Daikin, ...). Contains a list of its zones :
      • Zone : represent a zone to control

Usage

Install

pip3 install AirzoneCloud

Start api

from AirzoneCloud import AirzoneCloud
api = AirzoneCloud("email@domain.com", "password")

Get device status

for device in api.devices:
    print(
        "Device name={}, status={}, id={}, mac={}, pin={}".format(
            device.name, device.status, device.id, device.mac, device.pin
        )
    )

Output :

Device name=Home, status=activated, id=5bc8ae0c4149526af90c0000, mac=AA:BB:CC:DD:EE:FF, pin=1234

Get system status

for system in api.device[0].systems:
    print(
        "System name={}, mode={}, eco={}, velocity={}, airflow={}".format(
            self.name,
            self.mode,
            self.eco,
            self.velocity,
            self.airflow,
        )
    )

Output :

System name=Home, mode=heat-both, eco=eco-a, velocity=None, airflow=None

Get all zones status (on all devices / systems)

for zone in api.all_zones:
    print(
        "Zone name={}, is_on={}, mode={}, current_temperature={}, target_temperature={}".format(
            zone.name,
            zone.is_on,
            zone.mode_name,
            zone.current_temperature,
            zone.target_temperature,
        )
    )

Output :

Zone name=Baby bedroom, is_on=False, mode=heat-both, current_temperature=20.4, target_temperature=19.5
Zone name=Parents bedroom, is_on=False, mode=heat-both, current_temperature=21.1, target_temperature=17.0
Zone name=Living room, is_on=True, mode=heat-both, current_temperature=21.4, target_temperature=21.5
Zone name=Kitchen, is_on=False, mode=heat-both, current_temperature=21.2, target_temperature=19.0

Control a specific zone

zone = api.all_zones[2]
print(zone)

# start zone
zone.turn_on()

# set temperature
zone.set_temperature(18.5)

print(zone)

Output :

Zone(name=Living room, is_on=False, mode=heat-both, current_temp=21.6, target_temp=21.0)
Zone(name=Living room, is_on=True, mode=heat-both, current_temp=21.6, target_temp=18.5)

HVAC mode

Available modes

• stop : Stop
• ventilate : Ventilate
• dehumidify : Dry
• heat-air : Air heating
• heat-radiant : Radiant heating
• heat-both : Combined heating
• cool-air : Air cooling
• cool-radiant : Radiant cooling
• cool-both : Combined cooling

Set HVAC mode on a system (and its sub-zones)

system = api.devices[0].systems[0]
print(system)

# set mode to heat-both
system.set_mode("heat-both")

print(system)

Output :

System(name=Home, mode=stop, eco=eco-a, velocity=None, airflow=None)
System(name=Home, mode=heat-both, eco=eco-a, velocity=None, airflow=None)

API doc

API full doc

Constructor

AirzoneCloud(username, password, user_agent=None, base_url=None)

• username : you're username used to connect on Airzone Cloud website or app
• password : you're password used to connect on Airzone Cloud website or app
• user_agent : allow to change default user agent if set
• base_url : allow to change base url of the Airzone Cloud API if set
  • default value : https://www.airzonecloud.com
  • dkn (Airzone Cloud rebranded for Daikin) : https://dkn.airzonecloud.com