Skip to main content

py-agua-iot provides controlling heating devices connected via the IOT Agua platform of Micronova

Project description

py-agua-iot

py-agua-iot provides controlling heating devices connected via the IOT Agua platform of Micronova.

Warning: this module is not tested with multiple devices, there is no guarantee that it will work with your heating device.

Example usage

from py_agua_iot import agua_iot

# https://evastampaggi.agua-iot.com => Agua IOT API URL for Eva Calor
# 635987 => customer code of Eva Calor
# 1c3be3cd-360c-4c9f-af15-1f79e9ccbc2a => random UUID (you can generate one here: https://www.uuidgenerator.net/version4)
# brand_id="1" => optional brand id (should always be "1" but can be overridden just in case)
# login_api_url="" => optional separate login URL (used for Piazzetta for example)
connection = agua_iot("https://evastampaggi.agua-iot.com", "635987", "john.smith@gmail.com", "mysecretpassword", "1c3be3cd-360c-4c9f-af15-1f79e9ccbc2a", brand_id="1")

# Print the current air temperature for each device
for device in connection.devices:
  print(device.name + ": " + str(device.air_temperature))

API URL's / Customer codes

Below you can find a table with the app names of the different stove brands and their corresponding customer code and API URL.

App name or Brand Customer Code API URL Separate login URL (only needed if specified)
Alfaplam 862148 https://alfaplam.agua-iot.com
Boreal Home 173118 https://boreal.agua-iot.com
Bronpi Home 164873 https://bronpi.agua-iot.com
Darwin Evolution 475219 https://cola.agua-iot.com
Easy Connect 354924 https://remote.mcz.it
Easy Connect Plus 746318 https://remote.mcz.it
Easy Connect Poêle 354925 https://remote.mcz.it
Elfire Wifi 402762 https://elfire.agua-iot.com
EOSS WIFI 326495 https://solartecnik.agua-iot.com
EvaCalòr - PuntoFuoco 635987 https://evastampaggi.agua-iot.com
Fontana Forni 505912 https://fontanaforni.agua-iot.com
Fonte Flamme contrôle 1 848324 https://fonteflame.agua-iot.com
Globe-fire 634876 https://globefire.agua-iot.com
GO HEAT 859435 https://amg.agua-iot.com
Jolly Mec Wi Fi 732584 https://jollymec.agua-iot.com
Karmek Wifi 403873 https://karmekone.agua-iot.com
Klover Home 143789 https://klover.agua-iot.com
LAMINOXREM REMOTE CONTROL 2.0 352678 https://laminox.agua-iot.com
LMX Remote Control 352678 https://laminox.agua-iot.com
Lorflam Home 121567 https://lorflam.agua-iot.com
MCZ ?????? https://remote.mcz.it
Moretti design 624813 https://moretti.agua-iot.com
My Corisit 101427 https://mycorisit.agua-iot.com
MyPiazzetta (MySuperior?) 458632 https://piazzetta.agua-iot.com https://piazzetta-iot.app2cloud.it/api/bridge/endpoint/
Nina 999999 https://micronova.agua-iot.com
Nobis-Fi 700700 https://nobis.agua-iot.com
Nordic Fire 2.0 132678 https://nordicfire.agua-iot.com
Ravelli Wi-Fi 953712 https://aico.agua-iot.com
Stufe a pellet Italia 015142 https://stufepelletitalia.agua-iot.com
Thermoflux 391278 https://thermoflux.agua-iot.com
TS Smart 046629 https://timsistem.agua-iot.com
Wi-Phire 521228 https://lineavz.agua-iot.com

Version info and API documentation can be found at API swagger URL for each brand. Swager is accessible at /api-docs (example: https://nobis.agua-iot.com/api-docs). If you happen to know any extra or missing customer codes and API URL's, please feel free to open a pull request and add them to the table above.

Other examples

Home Assistant

Home Assistant plugin using this library: home_assistant_micronova_agua_iot

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

py-agua-iot-0.0.22.tar.gz (14.8 kB view details)

Uploaded Source

Built Distribution

py_agua_iot-0.0.22-py3-none-any.whl (13.5 kB view details)

Uploaded Python 3

File details

Details for the file py-agua-iot-0.0.22.tar.gz.

File metadata

  • Download URL: py-agua-iot-0.0.22.tar.gz
  • Upload date:
  • Size: 14.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.5

File hashes

Hashes for py-agua-iot-0.0.22.tar.gz
Algorithm Hash digest
SHA256 4b21ff504fa02684e34190af111f0385ae217a3217d645d05632930d7f76d802
MD5 e97aeea78bcd3376ddfaa66c5529c32d
BLAKE2b-256 1c1598f4c7a545d9f3bb45cdcd0ca242b182194a61265ceb376f6051b2cdd5e3

See more details on using hashes here.

File details

Details for the file py_agua_iot-0.0.22-py3-none-any.whl.

File metadata

  • Download URL: py_agua_iot-0.0.22-py3-none-any.whl
  • Upload date:
  • Size: 13.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.5

File hashes

Hashes for py_agua_iot-0.0.22-py3-none-any.whl
Algorithm Hash digest
SHA256 807e5e67ca543683c48d4aa889cead266e7e9f4ea9caab90caabca596588ab47
MD5 f472ab3b8b47564d01bd7a56e3f9241d
BLAKE2b-256 d81d7db3478153117b7196b7a98266c1773fe309197f2e9379c52e89f39a3598

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page