/ariston-aqua-remotethermo-home-assistant

Aqua Ariston NET Remotethermo for Home Assistant

Primary LanguagePythonMIT LicenseMIT

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:

  • Ariston Lydos Wifi
  • Ariston Velis Wifi
  • Ariston Lydos Hybrid

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:

  • lydos - use it for Lydos or Velis (temeprature based);
  • lydos_hybrid - use it for Lydos Hybrid;
  • velis - use it for Velis, which uses number of showers instead of temepartures;
    Order of Installation:
  • Copy data to custom_components;
  • Restart Home Assistant to find the component;
  • Include data in configuration.yaml;
  • Restart Home Asistant to see new services.

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

  • entity_id - mandatory entity of Ariston water heater. For the rest of attributes please see Developer Tools tab Services within Home Assistant and select aquaariston.aqua_set_data. You may also directly read services.yaml within the aquaariston folder. Note that changing required_showers changes temperature_mode to showers and changing required_temperature changes temperature_mode to temperature on models that use shower mode (temperature mode is being simulated for some models like Velis wifi).

Service use example

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