ariston 0.11.3

Ariston module

python-ariston-api

A Python module for controlling Ariston devices with cloud polling. The following devices are currently supported:

• Ariston Alteas One 24
• Ariston Velis Evo
• Ariston Lydos Hybrid
• Ariston Genus One

Installation

Use pip3 to install the latest version of this module.

pip3 install ariston

Basic functions

First, open Python 3 and import Ariston class from this module.

python3

from ariston import Ariston

Create a new Ariston instance

ariston = Ariston()

Now let's try some functions

Connect

The cloud requests are asynchronous, so if you call them from a synchronous function or not even from function, you should use asyncio.

import asyncio

Sync

asyncio.run(ariston.async_connect("username", "password"))

Async

await ariston.async_connect("username", "password")

username: Your ariston cloud username

password: Your ariston cloud password

Discovery

Use this function to discover devices. You can skip this step if you already know the gateway id.

Sync

devices = asyncio.run(ariston.async_discover())

Async

devices = await ariston.async_discover()

Say hello

Use this function to create the device object.

Sync

devices = asyncio.run(ariston.async_hello("gateway", is_metric, "location"))

Async

devices = await ariston.async_hello("gateway", is_metric, "location")

gateway: You can find the value in the returned discover dictionary name 'gw'

is_metric: True or False. True means metric, False means imperial. Only works with Galevo (Alteas One, Genus One, etc) system. Default is True.

language_tag: Check https://en.wikipedia.org/wiki/IETF_language_tag Only works with Galevo (Alteas One, Genus One, etc) system. Default is "en-US".