chomupashchuk / ariston-aqua-remotethermo-home-assistant

Aqua Ariston NET Remotethermo for Home Assistant
MIT License
71 stars 26 forks source link
aqua-ariston ariston ariston-aqua

DROPPING SUPPORT OF THIS INTEGRATION

This integration was created based on either temporary access to others boilers or providing me with required data. I do not have a boiler which supports this specific integration and it complicates troubleshooting and maintenance a lot (constantly asking to provide data and if it is not enough then ask again and again with descriptions of steps to be taken, and I cannot even test it myself and I must ask what to test and how). To me it feels like I have to constantly ask for help even thogh features and bug fixes are for someone else. It takes a lot of my time and I have no gain from it in any way (no competence build up, no profits, it is no longer interesting for me).

Aqua Ariston NET remotethermo integration

Thin integration is Aqua Ariston NET. You are free to modify and distribute it. It is distributed 'as is' with no liability for possible damage.

Donations

If you like this app, please consider donating some sum to your local charity organizations or global organization like Red Cross. I don't mind receiving donations myself (you may conact me for more details if you want to), but please consider charity at first.

Integration was tested and works with:

Installation

In /config folder create custom_components folder and copy folder aquaariston with its contents in it. In configuration.yaml include:

aquaariston:
  username: !secret ariston_username
  password: !secret ariston_password
  type: "lydos"

Where type is one of:

Configuration example with all optional parameters

aquaariston:
  username: !secret ariston_username
  password: !secret ariston_password
  type: "lydos"
  logging: "WARNING"                  # indicates logging level ("CRITICAL", "ERROR", "WARNING", "INFO", "DEBUG", "NOTSET"). Default is "DEBUG"
  #path: "/home/homeassistant/.homeassistant/aqua_http_data" # Forces new path for storing files. SET NEW VALUES IF "/config" IS NOT CORRECT
  polling: 1.2                        # indicates relative time for requests waiting. Increase in case of timeouts. Default is 1.0
  store_config_files: true            # indicates if to store API data in a folder
  switches:
    - eco                             # switches ECO mode
    - power                           # switches power
  binary_sensors:
    - antilegionella                  # indicates antilegionella status
    - changing_data                   # indicates ongoing configuration on server by the API
    - eco                             # indicates ECO mode status
    - heating                         # indicates ongoing heating
    - online                          # indicates API online status
    - power                           # indicates power status
    - update                          # indicates API update
  sensors:
    - antilegionella_set_temperature  # antilegionella temperature
    - current_temperature             # current temperature
    - energy_use_in_day               # energy use in last day
    - energy_use_in_month             # energy use in last week
    - energy_use_in_week              # energy use in last month
    - energy_use_in_year              # energy use in last year
    - errors                          # errors
    - mode                            # manual or time program mode
    - remaining_time                  # remaining time for heating
    - required_showers                # required amount of showers (might not work on all models)
    - required_temperature            # required temperature (simulated by API itself for some models)
    - showers                         # estimated amount of average showers
    - temperature_mode                # indicates if required temeparture is based on required temperature or required showers
    - time_program                    # time program schedule
  selector:
    - mode                            # boiler mode selector

Multiple boilers under one account setup

Refer to Multiple boilers under one account setup section on https://github.com/chomupashchuk/ariston-remotethermo-home-assistant-v2 .

Services

aquaariston.aqua_set_data - Sets the requested data.

Service attributes

Service use example

service: aquaariston.aqua_set_data
data:
    entity_id: 'water_heater.aqua_ariston'
    antilegionella_set_temperature: 75