Ondilo ICO Smart-Home-Integration, kostenlos und Open Source
Ondilo ICO pool and spa analysers: temperature, pH, redox, salt and recommendations.
Veröffentlicht von LM1LC3N7
- Geräte
- Version 0.1.2
- Erfordert Gladys >=5.1.0
- ★ 0
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
The Ondilo ICO floats in your pool or spa and measures the water every hour. This integration brings those measures into Gladys, with the recommendations of the Ondilo app, through the official Ondilo customer API. Unofficial, not affiliated with Ondilo.
Development version (0.1). Built from the Ondilo API documentation and tested against simulated answers, not yet with a real ICO. Your feedback is welcome on the GitHub repository.
What you get
One Gladys device per pool or spa of your Ondilo account (shared pools included), with:
| Ondilo measure | In Gladys |
|---|---|
| Water temperature | temperature sensor, °C |
| pH | pH sensor |
| Redox (ORP) | redox sensor, mV |
| Salt (salt pools) | sensor in ppm: Ondilo gives mg/L, the same value (4000 ppm = 4 g/L) |
| Dissolved solids, TDS (other pools) | sensor in ppm |
| Battery of the ICO | battery, % |
| Signal of the ICO | signal, % |
| Current recommendations | text: their titles, or "—" when there is none |
Each measure is recorded at the time the ICO took it, not when Gladys read it, so the charts show the real pace of the measures. Measures the ICO flags as invalid (out of the water…) are left out.
The badge of the device says cloud; an orange dot means no measure for more
than 3 hours (battery, ICO out of the water, wintering), and unreachable
means Ondilo cannot be reached or refused the authorization.
Installation
- Install the integration from the Gladys store.
- In the Configuration tab, click Connect next to "Ondilo account".
- Ondilo's page opens: sign in with the email and password of your Ondilo account (the ones of the ICO app), then click Authorize. Gladys never sees your password, and there is no application to create at Ondilo.
- Back in Gladys, the status shows "Connected to Ondilo: 1 pool or spa".
- Open the Discovery tab and add your pools and spas.
The last measures arrive as soon as a device is added.
How often Ondilo is read
The ICO measures once an hour, and Ondilo allows 30 requests per hour and per account. The integration:
- reads the measures of each pool 65 minutes after its last measure, so right after the next one (about one request per pool and hour);
- reads the recommendations with each new measure (at most hourly, at least every 6 hours), and the list of pools every 6 hours;
- never sends more than 20 requests per hour, leaving a third of the quota to the Ondilo app and your other tools;
- when the ICO stays silent (wintering, battery), tries again 20 minutes later, then hourly.
For one pool, that is about 2 requests per hour. The Refresh now button reads everything at once and shows a summary (at most every 5 minutes).
Scenes
- The measures work with the "Device state change" trigger, for example "pH above 7.6 → send me a message".
- The New Ondilo recommendation trigger starts a scene when Ondilo
publishes a recommendation (adjust the pH, clean the filter…), for one pool
or for all. Its details are available in the following actions:
{{triggerEvent.data.title}},message,deadline,pool_name. Each recommendation fires once; the ones already there when the account is linked are not announced.
Options
| Option | Default | Purpose |
|---|---|---|
| Language of the feature names | French | names of the features of the pools added from now on |
The recommendations keep the language of your Ondilo account.
Limitations
- Salt and TDS are shown in ppm (= mg/L) with a generic icon: Gladys has no category for these measures yet.
Troubleshooting
- "Ondilo refused the saved authorization": the password of the Ondilo account changed, or the access was revoked. Click Connect again.
- "Ondilo cannot be reached": Ondilo or your Internet access is down. The integration tries again after 5, 15, 30 then 60 minutes.
- "the request quota is reached": another tool reads the same Ondilo account a lot. The integration pauses for an hour.
- Ondilo shows an error about the redirect address when you click Connect: please open an issue on the GitHub repository with the message.
- The salt does not match the app: the Ondilo app may show g/L, Gladys shows ppm (mg/L): 4200 ppm = 4.2 g/L.
Privacy
You sign in on Ondilo's own page: your password never goes through Gladys.
Gladys keeps the access tokens Ondilo gives (never shown in the interface)
and the integration only talks to interop.ondilo.com. ICO and Ondilo are
trademarks of Ondilo; this integration is not affiliated with Ondilo.
Konfigurationseinstellungen
Diese Einstellungen fragt Ondilo ICO in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Your Ondilo ICO pools and spas | section | Nein | Brings the measures of your Ondilo ICO analysers into Gladys: water temperature, pH, redox (ORP), salt or dissolved solids (TDS), battery and signal of each pool or spa, plus the current recommendations of the Ondilo app. Click "Connect" below and sign in with the email and password of your Ondilo account (the one of the ICO app): no application to create, no key to copy. The ICO measures once an hour and Ondilo allows 30 requests an hour per account: the integration reads each pool about once an hour, right after its new measure, and leaves a third of the quota to the Ondilo app. Then add your pools and spas from the Discovery tab. Unofficial, not affiliated with Ondilo. |
| Ondilo account | oauth2 | Nein | |
| Language of the feature names | select | Nein | Used for the names of the features of the pools added from now on (water temperature, salt...). The recommendations keep the language of your Ondilo account. |
So installierst du Ondilo ICO in Gladys
- Öffne in Gladys Integrationen: Ondilo ICO erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/lm1lc3n7/gladys-ondilo:0.1.2) 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-ondilo.
Ondilo ICO 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
Ondilo ICO 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