Poolside Tech offre une intégration officielle de ses contrôleurs Attendant avec Home Assistant. La communication est entièrement locale, sans interrogation périodique. Elle ne dépend pas de l’infonuagique et met Home Assistant à jour immédiatement, quel que soit l’état de la connexion Internet.
Fonctions prises en charge
- Home Assistant offre une commande semblable à celle de l’application Poolside pour les jeux d’eau, lumières, équipements de chauffage et de refroidissement et autres fonctions de la piscine.
- Vous pouvez surveiller l’état des appareils et créer des alertes ou des automatisations selon les capteurs et les paramètres de fonctionnement.
Exigences
The Attendant ou The Attendant Mini doit utiliser le logiciel version 2.7.0 ou ultérieure.
Home Assistant version 2026.2.0 ou ultérieure.
Pour la découverte automatique mDNS, Home Assistant et The Attendant doivent partager le même domaine de diffusion de couche 2, soit LAN/VLAN. Si le trafic passe par un routeur ou pare-feu, autorisez TCP/8126 de Home Assistant vers The Attendant.
Le réseau doit prendre en charge mDNS. Si le Wi-Fi bloque la multidiffusion, mDNS et la découverte automatique ne fonctionneront pas.
Installer l’intégration avec HACS
Remarque : Poolside Tech travaille à l’inclusion de l’intégration dans Home Assistant Core. Une fois cette étape terminée, l’installation par HACS ne sera plus nécessaire. HACS continuera d’offrir des mises à jour rapides et des nouveautés à l’essai.
Consultez cet article pour les mises à jour sur les options d’installation.
Ajouter HACS et l’intégration Poolside
- Installez HACS selon votre type d’installation Home Assistant : OS, Container ou Core.
https://hacs.xyz/docs/use/download/download/#troubleshooting - Redémarrez Home Assistant.
- Ouvrez « Settings → Devices & Services » (Paramètres → Appareils et services). Dans Intégrations, appuyez sur Add Integration (Ajouter une intégration).
- Recherchez HACS et installez l’intégration.
- Ouvrez HACS dans la navigation principale à gauche.
- Ouvrez le menu à trois points de HACS en haut à droite, puis choisissez « Custom repositories » (dépôts personnalisés).
- Entrez PoolsideStan/poolside-official-integration comme dépôt et Integration comme type.
Appuyez sur Add (Ajouter). - Recherchez Poolside dans HACS et ouvrez le résultat.
- Téléchargez et installez l’intégration avec Download (Télécharger).
- Redémarrez Home Assistant pour activer l’intégration.
Jumeler The Attendant avec Home Assistant
Après avoir installé HACS, ajouté le dépôt Poolside Tech et installé l’intégration, vous pouvez commencer le jumelage.
Connexion par découverte automatique (recommandée)
Home Assistant détecte normalement The Attendant et affiche une carte sous « Settings → Devices & Services ». Appuyez sur Configure (Configurer) sur cette carte pour commencer.
Connexion par configuration manuelle
- Ouvrez « Settings → Devices & Services », puis appuyez sur Add Integration (Ajouter une intégration) dans Intégrations.
- Recherchez Poolside et installez l’intégration.
Remarque : Elle apparaît seulement après l’installation de HACS et l’ajout du dépôt personnalisé. - Entrez l’adresse IP de The Attendant et appuyez sur Submit (Envoyer).
Terminer le jumelage dans l’application mobile
Le jumelage établit une seule fois si The Attendant fait confiance à cette installation de Home Assistant. Un accès administrateur est requis pour l’approuver. Lorsque vous le démarrez dans Home Assistant, une fenêtre de jumelage de 5 minutes s’ouvre. Pendant ce délai :
Avant d’appuyer sur Approuver, vérifiez que le code dans l’application Poolside correspond à celui de Home Assistant. Vous confirmez ainsi le bon système, et non un autre appareil du réseau.
Home Assistant affiche un court code de vérification, ou empreinte, puis attend.
La même demande apparaît sur le contrôleur Poolside et dans la carte Demande de jumelage API de l’application.
- Appuyez sur Examiner dans Demande de jumelage API.
- Appuyez sur Approuver pour terminer le jumelage.
- Vous pouvez gérer et révoquer les installations jumelées dans Connexions API. Ouvrez le menu à trois lignes, puis Sites → site voulu → Connexions API.
Si la demande expire, vous pouvez en démarrer une autre dans Home Assistant.
Configurer l’intégration dans Home Assistant
Vous pouvez configurer l’option Expose pool devices (Afficher les équipements de piscine).
The Attendant distingue les commandes, comme les jeux d’eau ou le chauffage, des appareils physiques qu’il utilise pour les exécuter : pompes, chauffe-eau, actionneurs, éclairage et autres équipements.
En plus des commandes, l’intégration peut afficher ces équipements. Chacun apparaît comme un appareil distinct avec des entités de capteur en lecture seule : vitesse de pompe, puissance consommée, état du chauffe-eau ou position d’un actionneur, par exemple. Elles servent aux tableaux de bord, alertes et automatisations, comme une alerte si la consommation d’une pompe de filtration baisse alors qu’elle devrait fonctionner. Elles ne permettent pas de commander directement les équipements; toutes les actions passent par les commandes normales, comme dans l’application Poolside.
Cette option est activée par défaut. Désactivez-la si vous préférez moins d’entités :
- Ouvrez Settings → Devices & Services → Poolside.
- Appuyez sur Configure.
- Modifiez Expose pool devices et appuyez sur Submit.
L’intégration se recharge automatiquement. La désactivation retire les entités de télémétrie, et la réactivation les rétablit. Les commandes normales des lumières, jeux d’eau, chauffage et autres fonctions restent disponibles.