search

laetificat / haanna

Plugwise Anna API to use in conjunction with Home Assistant.
MIT License
5 stars 5 forks source link

readme

This repository is no longer used - @bouwew and @compatech now maintain Plugwise-Smile

Sometime (soon)[https://github.com/home-assistant/core/pull/33691] after HA-core 0.109 this module will not be used by HA-core's plugwise component!

Haanna (HA Anna)

A Python API made for use in conjunction with the Home Assistant Anna component, but this API can also be used in other projects.

Installation """""""""""" .. code-block:: bash

pip install haanna

..

Usage """""

.. code-block:: python3

from haanna import haanna

Create the API

api = haanna.Haanna('smile', 'short_id', '192.168.1.60', 80, False)

'False' must be changed to 'True' for a legacy Anna

Fetch the direct objects

direct_objects = api.get_direct_objects()

Fetch the domain objects

domain_objects = api.get_domain_objects()

Set the temperature

temperature = api.set_temperature(domain_objects, 22.50) print(temperature)

Get the current room temperature

temperature = api.get_current_temperature(domain_objects) print(temperature)

Get the temperature setting of the selected schema

temperature = api.get_schedule_temperature print(temperature)

Get the outdoor temperature

temperature = api.get_outdoor_temperature(domain_objects) print(temperature)

Get the target temperature

temperature = api.get_target_temperature(domain_objects) print(temperature)

Get the thermostat temperature

temperature = api.get_thermostat_temperature(domain_objects) print(temperature)

Get the available presets

presets = api.get_presets(domain_objects) print(presets)

Get the current active preset, can also be 'none'

current_preset = api.get_current_preset(domain_objects) print(current_preset)

Set a preset, e.g. 'away'

preset = api.set_preset(domain_objects, 'away') print(preset)

Get operation mode (true = active schedule, false = no active schedules)

it 'walks' all schedules and sends true if one is active

mode = api.get_mode(domain_objects) print(mode)

Get boiler status (true = boiler is on, flame-icon on Anna display), when available

boiler = api.get_boiler_status(direct_objects) print(boiler)

Get heating status (true = heating is on, flame-icon on Anna display), when available

heating = api.get_heating_status(direct_objects) print(heating)

Get cooling status (true = cooling is on, fan-icon on Anna display), when available

cooling = api.get_cooling_status(direct_objects) print(cooling)

Get domestic hot water status (true = water is being heated, tap-icon on Anna display), when available

hot_water = api.get_domestic_hot_water_status(direct_objects) print(hot_water)

Get the illuminance value

illuminance = api.get_illuminance(domain_objects) print(illuminance)

Get the current boiler temperature

boiler_temp = api.get_boiler_temperature(domain_objects) print(boiler_temp)

Get the current boiler pressure

pressure = api.get_water_pressure(domain_objects) print(pressure)

Get schemas or schedules available on the device.

schemas = get_schema_names(domain_objects) print(schemas)

Sends a set request to the schema with the given name

set_schema_state(domain_objects, schema=None, state)

Get active schema or determine last modified.

schema = get_active_schema_name(domain_objects) print(schemas)

Gets the mode the thermostat is in (active schedule true or false)

state = get_schema_state(domain_objects) print(state)

""""

Please note: when the requested info/data is not available on your Anna, the function will return None. When you encouter an error, please report this via an Issue on this github or on the Home Assistant github.

To do: """"""