Intégration domotique Balboa Spa, gratuite et open source
Spas Balboa avec module Wi-Fi BWA, en local : température, consigne, pompes, éclairage.
Publiée par LM1LC3N7
- Appareils
- Version 0.1.1
- Nécessite Gladys >=5.1.0
- ★ 0
Affiche votre spa Balboa dans Gladys par votre réseau local, grâce au module Wi-Fi BWA (celui de l'appli Balboa Worldwide App), sans cloud : température de l'eau, consigne, mode de chauffe, pompes, souffleurs, éclairage, cycles de filtration et pompe de circulation.
Jamais testé avec un vrai spa. Le protocole local n'est pas documenté par Balboa : cette intégration suit ce que fait pybalboa (la bibliothèque de l'intégration Balboa de Home Assistant). Sans lien avec Balboa Water Group.
Avant de commencer
- Un régulateur Balboa (séries BP, GS, EL…) avec un module Wi-Fi BWA (BWG), connecté à votre Wi-Fi.
- L'adresse IP du module : cherchez-la dans votre box (souvent nommée
BWGSpa) et donnez-lui une adresse fixe (réservation DHCP). - Le module parle sur le port TCP 4257, sans mot de passe : gardez-le sur un réseau de confiance (pas de redirection de port depuis internet).
- Le module accepte peu de connexions à la fois : si Gladys ne se connecte pas, fermez l'appli Balboa en local, et n'utilisez pas en même temps l'intégration Balboa de Home Assistant sur le même spa.
Installation
- Installez l'intégration depuis le store.
- Dans sa configuration, saisissez l'adresse IP du module Wi-Fi (par
exemple
192.168.1.80; un autre port s'ajoute ainsi :192.168.1.80:4257), puis enregistrez. - « Tester la connexion » affiche l'état : « Connecté : Balboa BP501G1. »
- Dans l'onglet Découverte, ajoutez le spa.
Ce que vous obtenez
| Fonctionnalité | Type | Remarques |
|---|---|---|
| Température de l'eau | température (°C) | Envoyée au plus toutes les 10 à 15 s |
| Consigne | thermostat (°C) | Commande, voir « Chauffage » |
| Chauffe | lecture seule, 0/1 | 1 quand le réchauffeur tourne |
| Mode de chauffe | liste : Prêt / Repos | Commande, voir « Chauffage » |
| État du spa | texte | État, mode de chauffe, chauffe, remarques Wi-Fi |
| Plage de température | texte | Basse / Haute (lecture seule) |
| Cycles de filtration 1 et 2 | lecture seule, 0/1 | 1 pendant le cycle |
| Pompe de circulation | lecture seule, 0/1 | Si le spa en a une |
| Pompes 1 à 8 | liste : Arrêt / Lent / Rapide (ou Arrêt / Marche) | Pompes 1–6 commandables, 7–8 en lecture seule |
| Souffleurs | liste | Commandables |
| Éclairages | lumière allumée/éteinte | Commandables |
| Auxiliaires, brumisateurs | lecture seule, 0/1 | Si le spa en a |
Un spa réglé en °F est affiché en °C. Les fonctionnalités suivent la configuration que le spa annonce ; une fonctionnalité ne disparaît jamais d'un appareil déjà créé.
Chauffage
Désactivé par défaut : activez « Autoriser les commandes de chauffage » pour que Gladys puisse changer la consigne et mettre le mode de chauffe sur « Prêt ».
- Plafond de la consigne : Gladys ne règle jamais le spa au-dessus. 38 °C par défaut, réglable de 30 à 40 °C, jamais plus de 40 °C (la limite des normes des spas), quoi qu'on saisisse. Par pas de 0,5 °C ; le spa doit accepter la valeur dans sa plage actuelle (plage basse : 10 à 37 °C, plage haute : 26,5 à 40 °C par défaut).
- « Repos » (chauffe pendant la filtration seulement) n'est jamais refusé par une option : il réduit la chauffe.
- « Prêt » garde la consigne réglée sur le spa : il est refusé quand cette consigne (peut-être réglée au panneau) dépasse le plafond.
- La plage de température (basse/haute) est en lecture seule.
Pompes et souffleurs
Désactivés par défaut : activez « Autoriser les pompes » pour démarrer les jets. « Arrêt » n'est jamais refusé par une option, et annule une commande encore en cours qui n'est pas un arrêt. Il peut quand même être refusé si l'état du spa est inconnu, si un appui précédent ne s'est pas encore affiché, ou s'il ne reste plus le temps de l'envoyer. Ce sont des listes, jamais des interrupteurs : un « éteins tout » d'un assistant vocal ou d'une scène ne peut pas les atteindre. Plusieurs arrêts à la fois (une scène qui éteint tout) s'exécutent côte à côte.
Le spa ne connaît que des appuis « vitesse suivante » : Gladys envoie un appui à la fois et attend que le spa l'affiche avant le suivant (Lent → Rapide → Arrêt pour une pompe à deux vitesses).
Quand le spa a à la fois une pompe de circulation et un souffleur 1, l'état du souffleur 1 est inconnu (le protocole, tel qu'on le connaît, les lit sur le même bit) : il n'est ni affiché ni commandé tant qu'un vrai spa n'a pas confirmé comment le lire.
Éclairage
Allumage et extinction permis par défaut. Désactivez « Autoriser l'allumage de l'éclairage » pour que Gladys puisse seulement l'éteindre.
Comment se passent les commandes
- Chaque commande attend un état que le spa envoie après votre clic (le spa en envoie un environ chaque seconde) : rien n'est décidé sur un état ancien, et une trame ne part pas si un état plus récent est arrivé depuis la décision.
- Les options et le plafond sont revérifiés juste avant l'envoi de chaque trame.
- Une trame part dans les 3,5 s qui suivent le clic, ou pas du tout. Si le spa n'affiche pas le changement (dans un état envoyé après la trame) à 4,3 s, la réponse est « Commande envoyée, sans confirmation » : vérifiez le spa quelques secondes plus tard. Gladys n'envoie jamais d'autre appui sur un résultat inconnu (pendant 20 s, jusqu'à ce que le spa l'affiche) : une nouvelle commande est refusée entre-temps, un arrêt l'attend.
- Une commande à la fois, arrêts à part.
Dépannage
- « Pas de connexion au spa » : vérifiez l'adresse IP, que le module est sur votre réseau, et qu'aucune autre application ne l'occupe. Gladys réessaie après 10 s, 30 s, 1, 2, puis toutes les 5 minutes.
- « Connecté au module Wi-Fi, en attente du spa… » : le module répond mais le spa n'envoie encore rien (spa en démarrage, ou module qui a perdu le spa).
- L'état indique « le spa ne répond pas au module » : le module signale qu'il ne parle plus au régulateur du spa.
Vie privée
Tout reste sur votre réseau local. Pas de compte, pas de cloud, pas de mot de passe. L'adresse MAC du module sert d'identifiant à l'appareil dans Gladys ; elle n'est jamais écrite dans les journaux.
Paramètres de configuration
Voici les paramètres demandés par Balboa Spa dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Votre spa | section | Non | Affiche votre spa Balboa (régulateurs BP, GS, EL avec module Wi-Fi BWA, celui de l'appli Balboa Worldwide App) dans Gladys par votre réseau local, sans cloud : température de l'eau, consigne, mode de chauffe, pompes, souffleurs, éclairage et cycles de filtration. Saisissez l'adresse IP du module Wi-Fi (donnez-lui une adresse fixe dans votre routeur), enregistrez, puis ajoutez le spa depuis l'onglet Découverte. Le module accepte peu de connexions à la fois : fermez l'appli Balboa en local si Gladys ne se connecte pas. Le protocole local n'est pas documenté par Balboa et n'a pas de mot de passe : gardez le module sur un réseau de confiance. Jamais testé avec un vrai spa. Sans lien avec Balboa Water Group. |
| Adresse IP du module Wi-Fi | string | Oui | Une adresse IPv4 ou un nom d'hôte (port 4257 sauf si vous en ajoutez un, par exemple 192.168.1.80:4257). |
| Autoriser les commandes de chauffage | boolean | Non | Désactivé par défaut. Activé : Gladys peut changer la consigne (jusqu'au plafond ci-dessous) et mettre le mode de chauffe sur « Prêt ». Désactivé : ces commandes sont refusées. « Repos » (chauffe pendant la filtration seulement) reste toujours permis. |
| Plafond de la consigne (°C) | number | Non | Gladys ne règle jamais le spa au-dessus de cette température. 38 °C par défaut, de 30 à 40 °C (jamais plus de 40 °C, la limite des normes des spas, quoi qu'on saisisse). |
| Autoriser les pompes | boolean | Non | Désactivé par défaut. Activé : Gladys peut démarrer les pompes et souffleurs (jets). Désactivé : seul « Arrêt » est accepté. |
| Autoriser l'allumage de l'éclairage | boolean | Non | Activé par défaut. Désactivé : Gladys peut seulement éteindre l'éclairage du spa. |
| Langue des noms des fonctionnalités | select | Non | Sert aux noms de l'appareil et des fonctionnalités ajoutés désormais, aux textes d'état et aux erreurs des commandes. |
Comment installer Balboa Spa dans Gladys
- Dans Gladys, ouvrez Intégrations : Balboa Spa apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/lm1lc3n7/gladys-balboa:0.1.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/LM1LC3N7/gladys-balboa.
Balboa Spa nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
Balboa Spa est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par LM1LC3N7, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation