Fork. Fork maintenu indépendamment de
Adrien40/ha-flipr-local, dont le développement public s'est arrêté à la version 1.1.0. Tout le mérite de l'intégration d'origine revient à l'auteur amont ; ce fork en poursuit le développement. Principaux apports depuis la 1.1.0 (détail complet dans le CHANGELOG) :
- Recyclage de la passerelle WiFi Flipr en proxy Bluetooth ESPHome (
docs/esphome-proxy.md), avec correctif de coexistence WiFi/BLE de l'ESP32-C6 (scan continu qui figeait la pile BLE enout_of_range) et automation « watchdog » de redémarrage.- Jauge de batterie fidèle : courbe de décharge Li-SOCl2 (Saft LS26500) au lieu du pourcentage linéaire, qui ne donnait quasiment aucune alerte de fin de vie.
- Fiabilité BLE : changement de mode de synchronisation non perdu pendant une interrogation, nouvel intervalle de scan appliqué immédiatement, capteur RSSI maintenu pendant les mesures en pause, gestion propre des timers de retry.
- Robustesse configuration/options : calibration conservée en saisie MAC manuelle,
unique_idempêchant de configurer deux fois le même appareil, clés d'erreur et libellés de traduction manquants corrigés (NL, PT-BR, CS, PL, RU, DA, ZH).- Qualité du code : suite de tests (unitaires et d'intégration mockés) avec intégration continue portant la couverture à environ 80 %, et refactorisations sans changement de comportement (
_async_update_datapassé d'une complexité de 47 à 11).
- Fonctionnement 100 % local via Bluetooth (BLE)
- Compatible Home Assistant (sans cloud)
- Mesures : pH, Redox, Chlore Actif, Température
- Optimisé pour préserver la batterie
- Installation via HACS en 2 minutes
Vue d’ensemble des données de la piscine dans Home Assistant
Entités exposées par l’intégration & Options de Configuration avancées
Une intégration 100% locale pour Home Assistant qui lit votre analyseur Flipr directement en Bluetooth Low Energy (BLE) et l'expose comme capteurs Home Assistant, afin de piloter et surveiller votre piscine sans aucune dépendance au Cloud.
Avertissement : Cette intégration interroge le Flipr directement en Bluetooth. Si vous utilisez la passerelle Wi-Fi officielle en parallèle, une gestion rigoureuse des modes de synchronisation est intégrée pour préserver la batterie.
Le fabricant historique CTAC Tech (Flipr) a été placé en liquidation judiciaire ; la marque a depuis été reprise par une nouvelle société, Yotilus (bascule commerciale au 1ᵉʳ juin 2026, société en cours de création). Dans ce contexte de reprise, la pérennité et les conditions d'accès aux serveurs cloud restent incertaines. Flipr Local est le fruit d'un travail de Reverse Engineering approfondi pour transformer votre analyseur en un véritable capteur industriel local, capable de communiquer directement avec votre instance Home Assistant. Flipr Local permet de remplacer le cloud par une solution de local control, tout en offrant un système fiable de pool monitoring basé sur un BLE sensor.
- Modèles supportés : Flipr AnalysR toutes générations, y compris les anciennes « ère Sigfox » (elles communiquent aussi en Bluetooth), avec ou sans abonnement.
- Usage flexible : Compatible avec ou sans la passerelle Wi-Fi Flipr Connect.
- Testé sur : Validé sur Flipr AnalysR 3 et Flipr Start Max.
- Matériel requis : Bluetooth interne, clé USB Bluetooth ou Bluetooth Proxy ESPHome (fortement recommandé). Voir la config de référence dédiée au Flipr, ou le proxy ESPHome standard.
- Qualité du signal : Un signal RSSI stable (idéalement supérieur à -75 dBm) est indispensable pour garantir la connexion au Flipr. Les tests montrent qu'un signal inférieur à -80 dBm peut entraîner des échecs fréquents.
- Temps réel : Une entité
sensor.*_signal_bluetooth, utilisant l'écoute passive de Home Assistant, vous permet de surveiller la force du signal en temps réel sans vider la batterie de la sonde !
Anciennes générations (ère Sigfox) : supportées. Ces sondes communiquent aussi en Bluetooth (c'est la voie utilisée par l'application), donc l'intégration les lit tel quel. Il suffit d'abandonner la passerelle Sigfox, de toute façon devenue inutile (réseau en fin de vie), et de lire la sonde via un proxy Bluetooth. Seuls les coefficients de conversion pH et température diffèrent, corrigés par la calibration 2 points (voir docs/calibration.md). Seule vraie contrainte : le Bluetooth de ces sondes est faible, placez le proxy au plus près du bassin (voir docs/esphome-proxy-esp32.md).
- 100% Local (BLE) : Aucune dépendance au Cloud, pas d'abonnement, pas de latence.
- Remontée des capteurs bruts : Température, pH, ORP (Redox), Batterie (%).
- Analyse en temps réel : Lancez une mesure manuelle quand vous le souhaitez.
- Précision Scientifique : Calcul du pH par l'équation de Nernst avec compensation de température.
- Sans Passerelle : La passerelle n'est pas nécessaire, mais elle permet de conserver le Cloud sur l'application mobile officielle !
- Intelligence Chimique Avancée :
- Calcul de l'Indice de Langelier (ISL) pour déterminer si l'eau est équilibrée, entartrante ou corrosive.
- Chlore Libre Estimé (FC) calculé via le modèle de Nernst (ORP + pH).
- Chlore Actif (HOCl) calculé via le modèle thermodynamique (O'Brien / USEPA) prenant en compte la température et le stabilisant (CYA).
- Support Multi-Traitements : Prise en charge du Brome (désactive intelligemment les capteurs spécifiques au chlore) et des piscines sans stabilisant (CYA = 0).
- Configuration 100% UI : Découverte automatique Bluetooth, calibrage des sondes et réglage des seuils d'alerte directement depuis l'interface Home Assistant (aucun YAML requis).
- Modes de Synchronisation : Contrôle du mode de synchronisation (Sommeil, Éco, Normal, Boost) pour les utilisateurs possédant la passerelle Wi-Fi, afin d'éviter de vider la batterie.
- Multi-langue : Développé en Français et disponible en EN, ES, DE, IT, NL, PL, PT, PT-BR, SV, RU, ZH-HANS, ZH-HANT, CS, HU, EL, HR, DA, NB (Traduction via IA).
- Expose votre Flipr comme capteurs Home Assistant, lus en direct en Bluetooth (BLE)
Ce dépôt n'étant pas (encore) dans la liste officielle par défaut, vous devez l'ajouter en tant que dépôt personnalisé.
- Ouvrez HACS dans votre Home Assistant.
- Cliquez sur les 3 petits points en haut à droite et sélectionnez Dépôts personnalisés.
- Dans Dépôt, collez l'URL :
https://github.com/cgrard/ha-flipr-local - Dans Type, choisissez Intégration puis cliquez sur Ajouter.
- Une fois ajouté, une fenêtre apparaît : cliquez sur Télécharger (sélectionnez la dernière version).
- Redémarrez complètement Home Assistant.
- Allez dans Paramètres > Appareils et Services > Ajouter une intégration et cherchez "Flipr Local".
Copiez le dossier custom_components/flipr_local dans le dossier custom_components de votre configuration Home Assistant, puis redémarrez.
L'intégration cohabite parfaitement avec votre installation officielle :
- SANS Passerelle : Home Assistant réveille le Flipr selon l'intervalle que vous avez choisi (par défaut : toutes les 60 min).
- AVEC Passerelle : Configurez le Flipr en Mode Éco (2 mesures/jour) ou Sommeil (0 mesure/jour) via les options. La passerelle officielle assure le cloud, tandis que Home Assistant lit les données localement sans épuiser la batterie.
| Entité | Unité / Type | Description |
|---|---|---|
| pH | pH | pH calculé (Nernst + Compensation thermique). |
| Redox / ORP | mV | Potentiel d'oxydoréduction. |
| Température | °C | Température précise de l'eau. |
| Chlore Libre Estimé | ppm | Estimation du taux de Chlore Libre (FC). |
| Chlore Actif | mg/L | Estimation de la puissance réelle de désinfection (HOCl). |
| Indice de Langelier | ISL | Indicateur d'équilibre de l'eau (Corrosive, Équilibrée ou Entartrante). |
| pH d'Équilibre | pH | Cible du pH idéal calculé selon la Balance de Taylor. |
| Batterie | % et mV | Niveau de charge (%) et tension brute de la pile. |
| Signal RSSI | dBm | Force du signal Bluetooth reçu en temps réel. |
| État Bluetooth | Statut | État détaillé de la connexion (Connecté, En veille, Erreur...). |
| Mode Sync | Diagnostic | Mode actuel de la sonde lu dans la trame Bluetooth (Éco, Boost...). |
| Prochaine Analyse | Horodatage | Heure estimée de la prochaine relève de données. |
| Nouvelle Analyse | Bouton | Lancer une analyse instantanée (~60s). |
| Analyses Auto. | Interrupteur | Activer/Désactiver la relève automatique (Mode Pause). |
Diagnostic : L'intégration expose également des capteurs avancés (pH brut en mV, pH formule usine d'origine, trame hexadécimale brute complète, et statuts d'alertes binaires).
Pas besoin de comprendre ces calculs : tout est automatisé dans Home Assistant.
Voir les détails scientifiques
La sonde Redox (ORP) ne mesure pas la quantité de chlore (mg/L), mais la force de désinfection de l'eau. Cette puissance s'effondre quand le pH augmente. Flipr Local croise votre Redox et votre pH en temps réel pour vous donner une estimation du taux de Chlore Actif, le seul vrai indicateur pour savoir si votre eau est désinfectante.
L'Indice de Saturation de Langelier (ISL) est le complément indispensable de la Balance de Taylor. Il permet de vérifier si votre eau est :
- Corrosive (ISL < -0.3) : L'eau attaque vos joints, liner et métaux.
- Équilibrée (ISL entre -0.3 et +0.3) : L'eau parfaite.
- Entartrante (ISL > +0.3) : Risque de dépôts calcaires.
Renseignez votre TAC, TH et TDS dans les options, et Home Assistant calculera votre équilibre en direct selon la température lue par le Flipr !
Diagnostic : L'intégration expose également le pH brut (mV), le pH calculé par la formule d'usine, la trame hexadécimale complète et l'horodatage de la dernière mesure.
Les valeurs affichées dans Home Assistant peuvent différer légèrement de celles de l'application officielle Flipr.
Flipr Local permet une calibration "haute précision". Contrairement à l'application mobile qui utilise des valeurs fixes, notre intégration vous permet de saisir la valeur exacte de votre solution tampon (pH 7.02, 4.01, etc.) ajustée à la température lors de votre calibration. C'est cette rigueur scientifique qui peut créer un léger décalage, signe d'une mesure plus proche de la réalité de votre bassin.
- Allez dans Paramètres > Appareils et services.
- L'intégration devrait détecter automatiquement votre Flipr si votre clé/antenne Bluetooth est à portée.
- Cliquez sur Ajouter une intégration et recherchez Flipr Local.
- Suivez les instructions à l'écran pour définir le type de traitement (Chlore, Brome) et le calibrage/décalage de vos sondes.
Une fois l'appareil ajouté, vous pouvez cliquer sur Configurer pour :
- Ajuster les valeurs de vos solutions de calibration (pH 4, pH 7, Redox).
- Modifier les paramètres de votre eau (TAC, TH, TDS, Stabilisant) via le tableau de bord.
- Définir vos seuils d'alerte personnalisés (pH Min/Max, ORP Min/Max, etc.) pour piloter vos propres automatisations.
Pour un pas-à-pas de la calibration des sondes et des seuils d'alerte, voir le Guide de Calibration.
Voir les problèmes fréquents
- Erreurs Bluetooth fréquentes : L'intégration gère automatiquement les tentatives de connexion. Si le capteur indique
Signal Perdu, le Flipr est hors de portée. Rapprochez votre antenne ou installez un Proxy Bluetooth ESPHome au plus près du bassin (nécessite juste un ESP32 (~10€) et un chargeur USB). - Chlore Libre et Actif en "Inconnu" : Si vous avez sélectionné "Brome" dans les options, c'est le comportement normal. Le brome ne se calcule pas comme le chlore. Fiez-vous à la valeur de la sonde Redox (ORP).
- Je n'ai pas de stabilisant : Réglez simplement l'entité
CyA (Stabilisant)sur0. Le calcul chimique s'adaptera automatiquement.
Voir la procédure complète
Si les sondes de votre Flipr sont HS, vous pouvez les remplacer vous-même !
Matériel requis :
- Des sondes de remplacement (pH et ORP) avec connecteur BNC (Dimensions recommandées : 12 mm de diamètre, 15-16 cm de long).
- Deux câbles adaptateurs (Pigtails) :
MMCX Mâle coudé (90°) vers BNC Femelle. Le connecteur coudé est indispensable pour pouvoir refermer le capot du Flipr.
Procédure rapide :
Retirez les anciennes sondes, nettoyez la base blanche. Branchez les adaptateurs MmCX sur la carte mère (Ports PH et ORP). Passez les nouvelles sondes dans les trous d'origine (12 mm), connectez-les aux câbles BNC. Calibrez via Home Assistant, et c'est reparti !
Recyclez la passerelle WiFi : plutôt que d'acheter un ESP32 dédié, vous pouvez reflasher la passerelle WiFi Flipr devenue inutile en proxy Bluetooth ESPHome. Voir le guide complet de reverse engineering : Recycler la passerelle WiFi Flipr en proxy Bluetooth ESPHome.
Vous partez d'un ESP32 neuf (par exemple pour remplacer une ancienne passerelle Sigfox) ? Voir la config de référence pour proxy Bluetooth dédié sur ESP32.
Si vous possédez une version plus ancienne du Flipr (1 ou 2) et que l'intégration fonctionne chez vous, n'hésitez pas à l'indiquer ! Pour tout bug ou demande d'amélioration, merci d'ouvrir une Issue sur ce dépôt.
Cette intégration est un projet indépendant. Elle n'a aucun lien, de près ou de loin, avec les sociétés CTAC Tech, Yotilus ni avec la marque Flipr. L'utilisation de ce logiciel se fait sous votre propre responsabilité.
Projet sous licence GPLv3. Indépendant de la société Flipr. Utilisation sous votre entière responsabilité.
Développé par @Adrien40