Poolside Tech bietet eine eigene, offiziell unterstützte Integration für Attendant-Steuerungen in Home Assistant. Die Kommunikation erfolgt vollständig lokal und ohne zyklische Abfragen. Sie ist nicht von Cloud-Diensten abhängig und aktualisiert Home Assistant unabhängig von der Internetverbindung unmittelbar.
Unterstützte Funktionen
- Home Assistant bietet eine ähnliche Steuerung wie die mobile Poolside-App, etwa für Wasserspiele, Beleuchtung sowie Heiz- und Kühlgeräte und weitere Poolfunktionen.
- Sie können Gerätezustände überwachen und anhand von Sensordaten oder Betriebsparametern Meldungen und Home-Assistant-Automatisierungen auslösen.
Voraussetzungen
The Attendant oder The Attendant Mini muss Software Version 2.7.0 oder neuer verwenden.
Home Assistant Version 2026.2.0 oder neuer.
Für die automatische mDNS-Erkennung müssen Home Assistant und The Attendant in derselben Layer-2-Broadcast-Domäne (LAN/VLAN) liegen. Wird der Verkehr über Router oder Firewall geleitet, muss TCP-Port 8126 von Home Assistant zu The Attendant erreichbar sein.
Die automatische Erkennung setzt mDNS voraus. Blockiert Ihr WLAN Multicast-Verkehr, funktioniert mDNS und damit die automatische Erkennung nicht.
Integration über HACS installieren
Hinweis: Poolside Tech arbeitet an der Aufnahme in Home Assistant Core. Danach ist die Installation über HACS nicht mehr erforderlich. HACS soll weiterhin schnelle Aktualisierungen und neue Funktionen zum Testen bereitstellen.
Prüfen Sie diesen Artikel auf aktuelle Informationen zu den Installationsmöglichkeiten.
HACS und die Poolside-Integration hinzufügen
- Installieren Sie HACS gemäß Ihrer Home-Assistant-Installationsart (OS, Container oder Core).
https://hacs.xyz/docs/use/download/download/#troubleshooting - Starten Sie Home Assistant neu.
- Öffnen Sie in Home Assistant „Settings → Devices & Services“ (Einstellungen → Geräte und Dienste). Drücken Sie im Reiter Integrationen auf Add Integration (Integration hinzufügen).
- Suchen Sie nach HACS und installieren Sie die Integration.
- Öffnen Sie HACS in der linken Hauptnavigation.
- Öffnen Sie oben rechts das Dreipunkt-Menü von HACS und wählen Sie „Custom repositories“ (benutzerdefinierte Repositorys).
- Geben Sie als Repository PoolsideStan/poolside-official-integration und als Typ Integration an.
Drücken Sie Add (Hinzufügen). - Suchen Sie in HACS nach Poolside und öffnen Sie das Ergebnis.
- Laden und installieren Sie die Poolside-Integration mit Download (Herunterladen).
- Starten Sie Home Assistant neu, um die Integration zu aktivieren.
The Attendant mit Home Assistant koppeln
Nach der Installation von HACS, dem Hinzufügen des Poolside-Tech-Repositorys und der Installation der Integration können Sie die Kopplung starten.
Verbindung über automatische Erkennung (empfohlen)
Home Assistant erkennt The Attendant normalerweise automatisch und zeigt unter „Settings → Devices & Services“ eine Karte an. Drücken Sie darauf Configure (Konfigurieren), um die Kopplung zu starten.
Verbindung durch manuelle Konfiguration
- Öffnen Sie „Settings → Devices & Services“ und drücken Sie im Reiter Integrationen auf Add Integration (Integration hinzufügen).
- Suchen Sie nach Poolside und installieren Sie die Integration.
Hinweis: Poolside erscheint erst, nachdem HACS installiert und das benutzerdefinierte Repository hinzugefügt wurde. - Geben Sie die IP-Adresse von The Attendant ein und drücken Sie Submit (Absenden).
Kopplung in der mobilen App abschließen
Die einmalige Kopplung legt fest, ob The Attendant dieser Home-Assistant-Installation vertraut. Für die Genehmigung sind Administratorrechte erforderlich. Beim Start in Home Assistant öffnet The Attendant ein 5-minütiges Kopplungsfenster. In dieser Zeit:
Vergleichen Sie vor dem Genehmigen den Code in der Poolside-App mit dem Code in Home Assistant. Beide müssen übereinstimmen, damit Sie das richtige System und kein anderes Netzwerkgerät zulassen.
Home Assistant zeigt einen kurzen Prüfcode (Fingerabdruck) an und wartet.
Dieselbe Anfrage erscheint an der Poolside-Steuerung und in der App auf der Karte API-Kopplungsanfrage.
- Drücken Sie auf der Karte API-Kopplungsanfrage auf Überprüfung.
- Drücken Sie Genehmigen, um die Kopplung abzuschließen.
- Gekoppelte Home-Assistant-Installationen können Sie unter API-Verbindungen verwalten und widerrufen. Öffnen Sie das Dreistrich-Menü und wählen Sie Standorte → gewünschten Standort → API-Verbindungen.
Läuft die Anfrage ab, können Sie in Home Assistant eine neue starten.
Integration in Home Assistant konfigurieren
Sie können die Option Expose pool devices (Poolgeräte anzeigen) konfigurieren.
The Attendant unterscheidet zwischen Bedienelementen wie Wasserspiel oder Poolheizung und den physischen Geräten, die dafür eingesetzt werden: Pumpen, Heizungen, Stellantriebe, Beleuchtung und weitere Komponenten.
Zusätzlich zu den Bedienelementen kann die Integration diese Geräte in Home Assistant anzeigen. Jedes Gerät erhält einen eigenen Eintrag mit ausschließlich lesbaren Sensorentitäten, etwa für Pumpendrehzahl, Leistungsaufnahme, Heizungsstatus oder Ventilstellung. Diese eignen sich für Dashboards, Meldungen und Automatisierungen, zum Beispiel eine Warnung bei sinkender Leistungsaufnahme einer laufenden Filterpumpe. Sie können damit die Geräte nicht direkt steuern; die Steuerung erfolgt weiterhin über die normalen Bedienelemente wie in der Poolside-App.
Die Option ist standardmäßig aktiv. Für weniger Entitäten können Sie sie deaktivieren:
- Öffnen Sie Settings → Devices & Services → Poolside.
- Drücken Sie Configure.
- Ändern Sie Expose pool devices und drücken Sie Submit.
Die Integration wird danach automatisch neu geladen. Deaktivieren entfernt die Sensorentitäten der Geräte; erneutes Aktivieren stellt sie wieder her. Ihre normalen Bedienelemente für Leuchten, Wasserspiele, Heizung und weitere Funktionen bleiben verfügbar.