Pool Lab Smart-Home-Integration, kostenlos und Open Source

PoolLab- und PrimeLab-Wassertests aus LabCom: pH, Chlor, Idealbereiche, Alarme.
Ăberblickâ
Diese Integration bringt die Wassertests deines Photometers Water-i.d. PoolLab 1.0 / 2.0 oder PrimeLab in Gladys: pH-Wert, Chlor, CyanursĂ€ure, AlkalitĂ€t, HĂ€rte und die anderen Parameter, die du misst, mit dem Idealbereich, den du in LabCom fĂŒr jeden festgelegt hast. Sie liest die LabCom-Cloud ĂŒber deren offizielle GraphQL-API mit einem persönlichen API-Token. Sie liest nur und ist nicht mit Water-i.d. verbunden.
- Ein GerĂ€t pro LabCom-âMessstelleâ (ein Pool, ein Spa): eine Funktion pro gemessenem Parameter mit dem Wert seines letzten Tests, und die Wasserbalance (was auĂerhalb seines Idealbereichs liegt).
- Zwei Dashboard-Widgets: der letzte Test eines Beckens, nach Idealbereich gefÀrbt; der Verlauf eines Parameters mit seinem Idealbereich.
- Szenen-Auslöser: neue Messung, Parameter auĂerhalb seines Idealbereichs, wieder im Bereich, Wassertest ĂŒberfĂ€llig, Token abgelehnt.
- Szenen-Aktionen: jetzt aktualisieren, letzter Wert eines Parameters.
Die Messungen bleiben manuell: Du testest das Wasser mit dem Photometer, die PoolLab-App synchronisiert das Ergebnis mit LabCom, und Gladys liest es dort. Gladys misst nie selbst.
Transport: Cloud. Das API-Token geht an LabCom (backend.labcom.cloud); die Messungen kommen aus der LabCom-Cloud.
Voraussetzungenâ
- Gladys Assistant 5.3.0 oder neuer.
- Ein PoolLab 1.0, PoolLab 2.0 oder PrimeLab und ein LabCom-Konto, mit dem die App ihre Messungen synchronisiert (prĂŒfe sie auf labcom.cloud).
- Ein persönliches API-Token: Melde dich bei labcom.cloud an, öffne die Einstellungen (labcom.cloud/pages/user-setting), erstelle ein API-Token und kopiere es. Halte es geheim: Wer es besitzt, kann deine Messungen lesen.
- Optional, aber nĂŒtzlich: der Idealbereich jedes Parameters in LabCom (unterer und oberer Wert). Ohne ihn wird ein Parameter âohne Idealbereichâ angezeigt und löst nie die Bereichs-Auslöser aus.
Konfigurationâ
| Feld | Bedeutung |
|---|---|
| LabCom-API-Token | Das auf labcom.cloud erstellte Token (geheim: nie wieder angezeigt, nie in die Logs geschrieben; nur ein Fingerabdruck in /data) |
| Abfrage von LabCom | Alle 5, 10, 15 (Standard), 30 oder 60 Minuten: wie lange es nach einer Synchronisierung dauert, bis Gladys einen neuen Test sieht |
| Test-Erinnerung nach | 3, 7 (Standard), 14 oder 30 Tage ohne neue Messung bis zum Auslöser âWassertest ĂŒberfĂ€lligâ; oder nie |
| Sprache der Texte | Namen der Funktionen, Wasserbalance, Szenentexte und Fehler; automatisch folgt dem letzten Widget |
SchaltflÀchen:
- Verbindung testen liest LabCom mit dem Token und listet die Becken auf (und wie viele Messungen haben).
- Diagnose schreibt den Zustand der Integration in ihre Logs, ohne das Token.
Die erste Abfrage holt alle Messungen des Kontos; danach fragt jede Abfrage nur die Messungen der letzten Woche ab, und die letzten 400 Tage werden alle 6 Stunden neu gelesen (eine in LabCom geĂ€nderte oder gelöschte Messung wird ĂŒbernommen). Die Integration behĂ€lt bis zu 300 Messungen aus 400 Tagen pro Parameter in /data.
Verwendungâ
GerĂ€teâ
Ăffne nach der Konfiguration Entdecken: Jeder Pool oder Spa mit mindestens einer Messung wird als GerĂ€t angeboten, benannt nach seiner Bezeichnung in LabCom. FĂŒge die gewĂŒnschten hinzu. Ein spĂ€ter gemessener Parameter fĂŒgt eine Funktion hinzu: Entdecken bietet dann an, das GerĂ€t zu aktualisieren.
| Parameter | Kategorie / Typ | Einheit |
|---|---|---|
| pH-Wert | ph-sensor / decimal | pH |
| Freies, Gesamt- und gebundenes Chlor, Brom, Aktivsauerstoff, Wasserstoffperoxid, Chlordioxid, Ozon, PHMB, CyanursÀure, AlkalitÀt, HÀrte, Salz⊠| level-sensor / decimal | ppm (mg/l) oder keine |
| Wassertemperatur | temperature-sensor / decimal | °C (°F, wenn LabCom es angibt) |
| Redox (ORP) | orp-sensor / decimal | mV |
| Wasserbalance | text / text | â |
Gladys hat keine Kategorie fĂŒr Chlor oder AlkalitĂ€t: Sie verwenden den einfachen Zahlensensor level-sensor / decimal (wie die Flipr-Integration). Ein Wert auĂerhalb des Messbereichs des Photometers (OVERRANGE, UNDERRANGE) hat keine Zahl: Die Funktion behĂ€lt ihren letzten Wert, Wasserbalance und Widgets zeigen es an.
Dashboard-Widgetsâ

- Wassertest: ein Becken (in den Einstellungen des Widgets wĂ€hlen; standardmĂ€Ăig das erste): die ersten fĂŒnf Parameter als Kacheln, grĂŒn im Bereich, orange auĂerhalb, rot auĂerhalb des Messbereichs, grau ohne Bereich; wann der letzte Test gemacht wurde, die Wasserbalance und die anderen Parameter. Die SchaltflĂ€che Aktualisieren liest LabCom sofort (höchstens einmal pro Minute).
- Parameterverlauf: ein Parameter eines Beckens ĂŒber 30, 90 oder 365 Tage, zum tatsĂ€chlichen Zeitpunkt jedes Tests (nicht dem Empfang durch Gladys), mit dem unteren und oberen Idealwert als zwei Linien, der Anzahl der Tests und dem Anteil im Bereich.
Szenenâ
Auslöser (einmal pro Ănderung, nie bei der ersten Abfrage, nie wegen einer Szenen-Aktion), filterbar nach Becken und Parameter:
- Neue Messung: Ein Parameter hat einen neueren Test in LabCom (ein Ereignis pro getestetem Parameter).
- Parameter auĂerhalb: Ein Parameter wird zu niedrig oder zu hoch fĂŒr seinen Idealbereich (Filter: Richtung).
- Wieder im Bereich: Ein Parameter, der auĂerhalb lag, ist wieder im Bereich.
- Wassertest ĂŒberfĂ€llig: keine Messung an einem Becken seit der eingestellten Frist, einmal, zwischen 9 und 21 Uhr.
- Token abgelehnt: LabCom lehnt das API-Token ab.
Aktionen:
- Jetzt aktualisieren: liest LabCom (höchstens einmal pro Minute); gibt die Anzahl der Becken, der Parameter auĂerhalb des Bereichs und den Zeitpunkt des letzten Tests zurĂŒck.
- Letzter Wert eines Parameters: Wert, Einheit, Status, Idealbereich, Datum und ein Satz, aus der letzten Abfrage.
Beispiele:
- Wenn Pool Lab: Parameter auĂerhalb (freies Chlor, zu niedrig) â âFreies Chlor {{triggerEvent.data.value_text}} mg/l, ideal ab {{triggerEvent.data.ideal_low}}: Chlor nachdosierenâ senden.
- Wenn Pool Lab: Wassertest ĂŒberfĂ€llig â âSeit {{triggerEvent.data.days_since}} Tagen kein Pooltestâ senden.
- Jeden Samstag um 10 Uhr â Pool Lab: letzter Wert eines Parameters (pH-Wert) â die Zusammenfassung senden.
Fehlerbehebungâ
- âLabCom lehnt das API-Token abâ: Das Token wurde gelöscht oder falsch kopiert; erstelle auf labcom.cloud (Einstellungen) ein neues und fĂŒge es in der Konfiguration ein.
- Kein GerĂ€t angeboten: Nur Becken mit mindestens einer Messung werden angeboten; drĂŒcke Verbindung testen und prĂŒfe auf labcom.cloud, ob die App synchronisiert hat.
- Ein Test erscheint nicht: Die App muss ihn zuerst mit LabCom synchronisieren; danach erscheint er bei der nĂ€chsten Abfrage (standardmĂ€Ăig 15 Minuten) oder mit Aktualisieren.
- âKein Idealbereichâ: Lege den unteren und oberen Idealwert des Parameters in LabCom fest.
- FĂŒr ein Issue: Versionen von Gladys und der Integration, die Meldung von Verbindung testen und die Zeilen âPool Lab diagnosticâ, die Diagnose in die Logs der Integration schreibt. FĂŒge nie dein Token ein.
Bekannte EinschrĂ€nkungenâ
- Nie mit einem echten LabCom-Konto getestet: Die Integration folgt dem veröffentlichten GraphQL-Schema und den zwei Open-Source-Clients (Home Assistant, ioBroker). Die genaue Schreibweise des Idealbereich-Status ist unbekannt: Er wird in jeder Form gelesen und aus dem Idealbereich berechnet, wenn er fehlt.
- Geteilte Messstellen (von einem anderen LabCom-Benutzer) und Wasserpflegeprodukte werden nicht gelesen.
- Die Art eines Parameters (pH-Wert, freies ChlorâŠ) ergibt sich aus seiner LabCom-ID oder seinem Namen: Ein unbekannter Parameter behĂ€lt seinen LabCom-Namen und die einfache Zahlenkategorie.
Konfigurationseinstellungenâ
Diese Einstellungen fragt Pool Lab in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| LabCom-Konto | section | Nein | Dein PoolLab oder PrimeLab sendet seine Messungen an die LabCom-Cloud, wenn die App synchronisiert. Erstelle auf labcom.cloud (Einstellungen, API-Token) ein persönliches API-Token und fĂŒge es unten ein: Die Integration liest deine Messungen nur (ein GerĂ€t pro Pool oder Spa) ĂŒber die offizielle LabCom-API. Gladys misst nie selbst. Nicht mit Water-i.d. verbunden. |
| LabCom-API-Token | secret | Ja | |
| Abfragen und Auslöser | section | Nein | Die Messungen erreichen LabCom erst, wenn die PoolLab-App synchronisiert: HĂ€ufiger abzufragen verkĂŒrzt nur die Wartezeit nach einer Synchronisierung. Jede Abfrage holt die Messungen der letzten Woche; die letzten 400 Tage werden alle 6 Stunden neu gelesen. |
| Abfrage von LabCom | select | Nein | Wie oft die Integration LabCom liest (eine Anfrage). |
| Test-Erinnerung nach | select | Nein | Tage ohne neue Messung, bevor der Auslöser âWassertest ĂŒberfĂ€lligâ auslöst (tagsĂŒber, zwischen 9 und 21 Uhr). |
| Sprache der Texte | select | Nein | Namen der Funktionen, Wasserbalance, Szenentexte und Fehler. Automatisch: die Sprache des zuletzt angezeigten Widgets. |
So installierst du Pool Lab in Gladysâ
- Ăffne in Gladys Integrationen: Pool Lab erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lÀdt das Docker-Image (
ghcr.io/william-de71/gladys-pool-lab:0.1.0) 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/William-De71/gladys-pool-lab.
Pool Lab benötigt Gladys >=5.3.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â
Pool Lab 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 William-De71 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