Intégration externe - Flipr (analyseur de piscine et Flipr Hub)

Développement
1

Bonjour à tous,

Pour ceux qui ont une piscine équipée d’un Flipr, voici une intégration externe qui amène ses mesures et le Flipr Hub dans Gladys.

Ce qu’elle fait

Le Flipr est un analyseur flottant qui envoie ses mesures au cloud Flipr environ une fois par heure. Sans API locale, l’intégration lit ce cloud (transport cloud) avec l’e-mail et le mot de passe de l’application Flipr, toutes les 15 minutes par défaut. Rien ne part ailleurs. Gladys n’a pas d’intégration Flipr native.

Fonctionnalités

  • Analyseur : température de l’eau, pH, chlore, redox, batterie, et l’évaluation du pH et du chlore donnée par Flipr (trop bas → trop haut).
  • Flipr Hub : filtration marche/arrêt et mode (automatique, manuel, programmation), pilotables depuis Gladys.
  • 4 déclencheurs de scène : nouvelle mesure, évaluation de l’eau changée, aucune mesure depuis 24 heures, filtration basculée par le Hub.
  • 2 actions de scène : lire la dernière mesure, changer le mode de filtration.
  • Un widget « Eau de la piscine ».

Exemples de scènes :

  • quand le pH ou le chlore passe à « Trop bas » ou « Trop haut » → m’envoyer un message avec le résumé ;
  • quand il n’y a plus de mesure depuis 24 heures → me rappeler de vérifier la pile ;
  • en heures creuses → démarrer la filtration, puis repasser en programmation.

Widget Eau de la piscine (illustration générée, pas une capture d'écran)

Illustration générée à partir du code du widget, sur des données fictives.

[Capture à venir : l’écran Découverte avec l’analyseur et le Hub]

Installation

  • Depuis le store : chercher « Flipr ». Disponible dans la journée, le temps de l’indexation.
  • Ou depuis l’URL du dépôt : https://github.com/William-De71/gladys-flipr.

Version minimale de Gladys : 5.1.0.

  1. Saisir l’e-mail et le mot de passe de l’application Flipr, puis enregistrer.
  2. Appareils → Flipr → Découverte : ajouter l’analyseur et le Hub.
  3. Ajouter le widget « Eau de la piscine » et créer vos scènes.

Limites connues

  • L’API est celle de l’application Flipr, non documentée : je me suis appuyé sur la bibliothèque flipr-api qu’utilise Home Assistant. Elle peut changer sans prévenir.
  • La société derrière Flipr a été liquidée en 2025 ; le service fonctionne de nouveau depuis 2026.
  • Je n’ai pas pu tester avec un vrai compte Flipr, seulement contre les réponses documentées par flipr-api : vos retours sont précieux, surtout pour le Hub.
  • Gladys n’a pas de catégorie « chlore » : c’est un capteur décimal en ppm (= mg/L), affiché avec son nom.
  • Les valeurs arrivent avec un peu de retard (une mesure par heure, une lecture toutes les 15 minutes).
Détails techniques
  • Un appareil par module, identifié par son numéro de série.
  • Démarrer ou arrêter la filtration met le Hub en mode manuel, comme le fait l’application Flipr.
  • Le déclencheur « filtration basculée » ne réagit qu’aux changements faits par le Hub lui-même, jamais aux commandes envoyées depuis Gladys (pas de boucle).
  • La première lecture après un démarrage sert de référence : aucun événement ancien n’est rejoué.

Vos retours

En réponse à ce fil ou dans une issue GitHub, avec les versions de Gladys et de l’intégration, votre matériel Flipr et les journaux (idéalement avec DEBUG=gladys-integration-sdk ; le mot de passe n’y apparaît jamais).