Micronova Agua IOT Smart-Home-Integration, kostenlos und Open Source
Pellet stoves of the Agua IOT cloud: MyPiazzetta, Total Control 3.0, Jolly Mec, Ravelli…
Veröffentlicht von LM1LC3N7
- Geräte
- Version 0.1.1
- Erfordert Gladys >=5.1.0
- ★ 0
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
Many pellet stove and boiler makers fit a Micronova Wi-Fi module and let you control the stove with their own phone app, all of them built on the same Agua IOT cloud. This integration logs in to that cloud with the account of your app, like the app does, and brings your stoves into Gladys: turn them on and off, set the temperature and the power, follow the temperatures, the state and the alarms, and react to an alarm in a scene.
Unofficial: not affiliated with Micronova nor with the stove makers.
Development version (0.1). Ported from the Home Assistant integration used by many owners, and tested against recorded register maps of seven real stoves, not yet against every brand. Your feedback is welcome on the GitHub repository.
Compatible apps
Choose, in the configuration, the app you use on your phone:
Alfaplam · APP-O BIOEN (Unical) · Boreal Home · Bronpi Home · Darwin Evolution (Cola) · Easy Connect, Easy Connect Plus and Easy Connect Poêle (MCZ) · Elcofire Pellet Home · Elfire Wifi · EOSS Wifi (Solartecnik) · EvaCalòr – PuntoFuoco · Fontana Forni · Fonte Flamme contrôle 1 · Globe-fire · GO HEAT (AMG) · Jolly Mec Wi-Fi · Karmek Wifi · Klover Home · LAMINOX Remote Control 2.0 · Lorflam Home · Moretti design · My Corisit · MyPiazzetta · MySuperior · Nina (Micronova) · Nobis-Fi · Nordic Fire 2.0 · Ravelli Wi-Fi · Stufe a pellet Italia · Thermoflux · Total Control 3.0 (Extraflame) · TS Smart (Tim Sistem) · TurboFonte (MCZ) · Wi-Phire (Linea VZ).
Not compatible (another platform): Ravelli Smart Wi-Fi, Total Control 1.x and 2.0. Palazzetti stoves have their own Gladys integration.
What you get
One Gladys device per stove of the account, with the features the stove has:
| Feature | In Gladys |
|---|---|
| On/off | thermostat mode: off / on |
| Setpoint | thermostat setpoint (room air), with the bounds and the step of the stove |
| Water setpoint | thermostat setpoint of the water (hydro stoves, boilers) |
| Heating | operating state: the stove is producing heat (ignition, work, cleaning) or not |
| Room, water, smoke temperatures | temperature sensors (°C) |
| State | text: off, ignition, heating, cleaning, standby, shutting down, alarm… |
| Alarm | binary sensor: 1 while the stove is in alarm |
| Power level | a choice among the power levels of the stove (1 to 5 for most) |
The state reads like "Heating (WORK)": the phase first, the same for every stove, then the text of the stove itself in your language when it has one.
Installation
- Check that your stove works in the vendor app on your phone.
- In the configuration of the integration, choose your stove app, then type the e-mail and the password of its account.
- Click Test the connection: the stoves of the account are listed.
- Open the Discovery tab and add your stoves.
Options
| Option | Default | Purpose |
|---|---|---|
| Language of the stove texts | French | names of the features, state and alarm texts |
| Refresh interval | 60 s | how often each stove is read (60 to 3600 s): every reading wakes it via the cloud |
Scenes
The Stove alarm trigger fires when a stove goes into alarm (failed ignition, no more pellets, smoke too hot…), once per alarm. Leave the stove empty to watch them all. The scene gets the name of the stove, the alarm code and text, the state, and a ready-to-send sentence, for example "Living room stove: stove alarm (E4)" to send as a notification.
The features work in scenes like any device: turn the stove on at 6:30, set the setpoint when you leave, check the room temperature in a condition…
How it works
- Gladys talks to the cloud of your app over the Internet, never to the stove directly: the stove must be online in the app.
- The e-mail and the password stay in the Gladys configuration (the password is a secret field) and are only sent to the cloud of the app you chose.
- A command (on/off, setpoint, power) is a job the cloud passes to the stove: Gladys shows the new value at once, and reads the stove again a few seconds later to confirm it.
- A refused login is retried after 15 minutes, or as soon as you save the configuration.
Troubleshooting
- "refused the e-mail or the password": check them in the app, and that you chose the app you actually use (each app has its own cloud and accounts).
- No stove: the account has no stove, or the stove was added with another account. Log in to the app with the same e-mail.
- A stove shown as unreachable: the cloud could not read it (stove off the mains, Wi-Fi module offline): check it in the app.
- No room temperature: some stoves have their thermostat contact on the room probe, or an external thermostat: the value is then not a temperature and is left out.
Credits
Ported from the Home Assistant integration home_assistant_micronova_agua_iot by Vincent Wolsink and contributors, based on py-agua-iot by Frederic Van Linthoudt (Apache License 2.0).
Konfigurationseinstellungen
Diese Einstellungen fragt Micronova Agua IOT in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Your pellet stove, from its vendor app | section | Nein | Many pellet stove brands (Piazzetta, Extraflame, Jolly Mec, Ravelli, MCZ Easy Connect, Laminox, Nordic Fire, Thermoflux…) use the Micronova Agua IOT cloud behind their Wi-Fi app. Choose that app, then type the e-mail and the password of its account: Gladys logs in like the app, offers each stove in the Discovery tab, and reads it at the chosen interval (one minute at most). On/off, room and water setpoints, power level, temperatures, state and alarms, with a "Stove alarm" scene trigger. Unofficial, not affiliated with Micronova or the stove makers. |
| Your stove app | select | Ja | The app you control the stove with on your phone: each one has its own cloud. |
| E-mail of the app account | string | Ja | |
| Password of the app account | secret | Ja | |
| Language of the stove texts | select | Nein | Names of the features, state and alarm texts. |
| Refresh interval (s) | number | Nein | How often each stove is read, between 60 and 3600 seconds. Every reading wakes the stove through the cloud: keep it reasonable. |
So installierst du Micronova Agua IOT in Gladys
- Öffne in Gladys Integrationen: Micronova Agua IOT erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/lm1lc3n7/gladys-agua-iot:0.1.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/LM1LC3N7/gladys-agua-iot.
Micronova Agua IOT benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Micronova Agua IOT ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von LM1LC3N7 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation