Zum Hauptinhalt springen

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

Pool Lab-Integration fĂŒr Gladys Assistant

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​

FeldBedeutung
LabCom-API-TokenDas auf labcom.cloud erstellte Token (geheim: nie wieder angezeigt, nie in die Logs geschrieben; nur ein Fingerabdruck in /data)
Abfrage von LabComAlle 5, 10, 15 (Standard), 30 oder 60 Minuten: wie lange es nach einer Synchronisierung dauert, bis Gladys einen neuen Test sieht
Test-Erinnerung nach3, 7 (Standard), 14 oder 30 Tage ohne neue Messung bis zum Auslöser „Wassertest ĂŒberfĂ€llig“; oder nie
Sprache der TexteNamen 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.

ParameterKategorie / TypEinheit
pH-Wertph-sensor / decimalpH
Freies, Gesamt- und gebundenes Chlor, Brom, Aktivsauerstoff, Wasserstoffperoxid, Chlordioxid, Ozon, PHMB, CyanursÀure, AlkalitÀt, HÀrte, Salz
level-sensor / decimalppm (mg/l) oder keine
Wassertemperaturtemperature-sensor / decimal°C (°F, wenn LabCom es angibt)
Redox (ORP)orp-sensor / decimalmV
Wasserbalancetext / 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​

Die zwei Widgets: der letzte Test eines Pools (pH-Wert und freies Chlor außerhalb, die anderen im Bereich) und der 90-Tage-Verlauf seines freien Chlors mit dem Idealbereich, dann der letzte Test eines Spas (generierte Illustration, kein Screenshot)

  • 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.

EinstellungTypPflichtfeldBeschreibung
LabCom-KontosectionNeinDein 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-TokensecretJa
Abfragen und AuslösersectionNeinDie 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 LabComselectNeinWie oft die Integration LabCom liest (eine Anfrage).
Test-Erinnerung nachselectNeinTage ohne neue Messung, bevor der Auslöser „Wassertest ĂŒberfĂ€llig“ auslöst (tagsĂŒber, zwischen 9 und 21 Uhr).
Sprache der TexteselectNeinNamen der Funktionen, Wasserbalance, Szenentexte und Fehler. Automatisch: die Sprache des zuletzt angezeigten Widgets.

So installierst du Pool Lab in Gladys​

  1. Öffne in Gladys Integrationen: Pool Lab erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. 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).
  3. Öffne den Bildschirm Konfiguration der Integration, fĂŒlle die Einstellungen aus und speichere.
  4. 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.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem GrĂŒnder des Projekts. Jederzeit abbestellbar 🙂