Integración externa - Flipr (analizador de piscinas y Flipr Hub)

Desarrollo
1

Hola a todos,

Para los que tienen una piscina equipada con un Flipr, aquí hay una integración externa que trae sus mediciones y el Flipr Hub a Gladys.

Qué hace

El Flipr es un analizador flotante que envía sus mediciones a la nube Flipr aproximadamente una vez por hora. Sin API local, la integración lee esta nube (transporte cloud) con el correo electrónico y la contraseña de la aplicación Flipr, cada 15 minutos por defecto. Nada se envía a otro lugar. Gladys no tiene una integración nativa de Flipr.

Funcionalidades

  • Analizador: temperatura del agua, pH, cloro, redox, batería, y la evaluación del pH y del cloro dada por Flipr (demasiado bajo → demasiado alto).
  • Flipr Hub: filtrado encendido/apagado y modo (automático, manual, programación), controlables desde Gladys.
  • 4 disparadores de escena: nueva medición, evaluación del agua cambiada, ninguna medición en 24 horas, filtrado cambiado por el Hub.
  • 2 acciones de escena: leer la última medición, cambiar el modo de filtrado.
  • Un widget «Agua de la piscina».

Ejemplos de escenas:

  • cuando el pH o el cloro pasa a «Demasiado bajo» o «Demasiado alto» → enviarme un mensaje con el resumen;
  • cuando no hay mediciones en 24 horas → recordarme verificar la pila;
  • en horas valle → iniciar la filtración, luego volver a la programación.

Widget Agua de la piscina (ilustración generada, no una captura de pantalla)

Ilustración generada a partir del código del widget, con datos ficticios.

[Captura por venir: la pantalla Descubrimiento con el analizador y el Hub]

Instalación

  • Desde la tienda: buscar «Flipr». Disponible en el día, el tiempo de la indexación.
  • O desde la URL del repositorio: https://github.com/William-De71/gladys-flipr.

Versión mínima de Gladys: 5.1.0.

  1. Ingresar el correo electrónico y la contraseña de la aplicación Flipr, luego guardar.
  2. Dispositivos → Flipr → Descubrimiento: agregar el analizador y el Hub.
  3. Agregar el widget «Agua de la piscina» y crear tus escenas.

Límites conocidos

  • La API es la de la aplicación Flipr, no documentada: me apoyé en la biblioteca flipr-api que usa Home Assistant. Puede cambiar sin avisar.
  • La empresa detrás de Flipr fue liquidada en 2025; el servicio funciona de nuevo desde 2026.
  • No he podido probar con una cuenta Flipr real, solo contra las respuestas documentadas por flipr-api: sus comentarios son valiosos, especialmente para el Hub.
  • Gladys no tiene una categoría «cloro»: es un sensor decimal en ppm (= mg/L), mostrado con su nombre.
  • Los valores llegan con un poco de retraso (una medición por hora, una lectura cada 15 minutos).
Detalles técnicos
  • Un dispositivo por módulo, identificado por su número de serie.
  • Iniciar o detener la filtración pone el Hub en modo manual, como lo hace la aplicación Flipr.
  • El disparador «filtración cambiada» solo reacciona a los cambios hechos por el Hub mismo, nunca a las órdenes enviadas desde Gladys (sin bucle).
  • La primera lectura después de un inicio sirve de referencia: ningún evento antiguo se reproduce.

Sus comentarios

En respuesta a este hilo o en un issue de GitHub, con las versiones de Gladys y de la integración, su hardware Flipr y los registros (idealmente con DEBUG=gladys-integration-sdk; la contraseña nunca aparece allí).