ariston-aqua-remotethermo-home-assistant

KO | EN

gitlite — search

#python #react #javascript #nodejs #typescript #hacktoberfest #swift #cpp #java #api #discord #ios

ariston-aqua-remotethermo-home-assistant

★ 74 Open GitHub ↗

Aqua Ariston NET Remotethermo for Home Assistant

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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; <br/>
**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
```

ariston-aqua-remotethermo-home-assistant

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README