Koppeln

Meistens ist das ein Fingertipp: Öffne die PoolPilot App auf einem Smartphone im selben Netzwerk wie das Relay. Die App findet es automatisch und zeigt „Relay einrichten“ – folge einfach den Hinweisen.

Gekoppelt wird bewusst nur im Heimnetz: Wer ein Relay zu seinem Haushalt hinzufügen will, muss vor Ort sein.

Wenn die App das Relay nicht findet

Lass dir den Kopplungscode direkt auf dem Relay anzeigen:

sudo poolpilot-relay show-pairing

Das zeigt drei Dinge:

einen QR-Code – scann ihn mit der PoolPilot App oder einfach mit der Kamera deines Smartphones,
denselben Link als Text – öffne ihn auf dem Handy (antippen oder im Browser des Handys aufrufen), dann öffnet sich die PoolPilot App,
den Fingerabdruck des Relays – das ist es, was du in der App von Hand eingibst.

Der Befehl ändert nichts am Relay und lässt sich jederzeit gefahrlos wiederholen. sudo braucht er nur, weil er die privaten Dateien des Relays liest. Läuft dein Relay in Home Assistant, steht der passende Befehl auf der Home-Assistant-Seite.

Besitzer und Mitglieder

Jedes gekoppelte Handy hat im Haushalt eine Rolle, die beim Koppeln festgelegt wird:

Besitzer ist das Handy, das das Relay eingerichtet hat – und jedes Handy, das sich die Besitzer-Rolle mit einem Wiederherstellungscode zurückgeholt hat.
Mitglied ist ein Handy, das über eine Einladung des Besitzers dazugekommen ist.

Alle im Haushalt sehen den Pool, seine Messwerte und Warnungen, bedienen ihn und nutzen die Weboberfläche der Poolsteuerung samt der Einstellungen, die sie dort anbietet. Und jeder kann sich selbst wieder vom Relay entfernen.

Nur der Besitzer ändert das Relay selbst:

Poolsteuerungen hinzufügen, ändern oder entfernen und den Fernzugriffs-Link einer Steuerung erneuern,
Warnregeln ändern,
ein anderes Handy entfernen,
Updates installieren, automatische Updates ein- oder ausschalten und das Abfrage-Intervall einstellen (siehe Updates & Einstellungen),
Haushalt oder Relay zurücksetzen.

Fragt ein Mitglieds-Handy eine dieser Aktionen an, lehnt das Relay sie ab, und es ändert sich nichts.

Deinen Pool teilen

Über das Relay teilst du deinen Pool mit bis zu 10 Geräten – iPhone und Android gemischt, Pro-Funktionen inklusive. Das klappt mit jeder unterstützten Poolsteuerung, auch mit der VIOLET. Der Besitzer lädt die anderen aus der PoolPilot App ein; jedes eingeladene Handy kommt als Mitglied dazu.

Besitzer-Zugriff verloren

Kann kein Handy mehr als Besitzer auftreten – etwa weil das Besitzer-Handy weg ist –, erzeugst du auf dem Relay einen einmaligen Wiederherstellungscode und scannst ihn mit dem Handy, das Besitzer werden soll:

sudo poolpilot-relay show-recovery

Der Code gilt nur wenige Minuten und nur einmal.
Er funktioniert nur auf einem Relay, das schon einmal gekoppelt war. Ein brandneues Relay koppelst du ganz normal.
Wer den Befehl ausführen kann, hat ohnehin vollen Zugriff auf das Gerät – genau darauf beruht dieses Vertrauen.

Wenn Pro ausläuft

Ist das Pro-Abo deines Haushalts nicht mehr aktiv, parkt das Relay seinen Tunnel: Den Fernzugriff über das Relay pausiert es, alles andere bleibt erhalten – Kopplung, Einstellungen und die Zugangsdaten. Das Relay prüft regelmäßig nach, und sofort, wenn du zu Hause die App öffnest. Sobald Pro wieder aktiv ist, läuft es von selbst weiter – neu koppeln musst du nicht.

Für Technikinteressierte: wenn das Relay seinen Haushalt vergisst

Ins Log schreibt das Relay bei jeder Änderung eine Zeile mit relay lifecycle:. Diese Fälle gibt es:

state=suspended („parking the tunnel; credentials kept“): Das Abo ist nicht aktiv – siehe oben.
state=unknown: Die PoolPilot Cloud hat das Relay über einige Stunden mehrfach nicht erkannt. Das Relay pausiert den Fernzugriff genauso und prüft weiter. Löst sich das nicht, gibt es den Haushalt in der Cloud sehr wahrscheinlich nicht mehr. Neu koppeln klappt dann nicht, solange die alten Handys noch gekoppelt sind – mach einen Werksreset und richte das Relay neu ein.
„household deleted in the cloud“: Der Haushalt wurde gelöscht, zum Beispiel über „Alle meine Daten löschen“ in der App. Das Relay vergisst alles, was zum Haushalt gehörte (gekoppelte Handys, Poolsteuerungen, Cloud-Zugangsdaten), behält aber seine eigene Identität – QR-Code und Fingerabdruck bleiben gleich. Richte es einfach neu aus der App ein.
„household reset over the LAN API“: dasselbe, nur sofort. Löschst du deine Daten, während dein Handy im selben Netzwerk wie das Relay ist, bittet die App das Relay direkt darum. Klappt das gerade nicht, merkt das Relay es trotzdem selbst – mit eingerichteter Poolsteuerung nach wenigen Minuten, ohne nach etwa einem Tag.

Eine neue Identität – etwa bevor du das Gerät weitergibst – bekommt das Relay nur per Werksreset.