Solicitud de integración externa para Seguimiento de Energía ISYPOWER

Mis paneles solares y mi batería están controlados por la aplicación ISYPOWER Cloud, me gustaría poder integrarlos en mi Gladys Assistant

En HA encontré esto:

y la siguiente información:

  1. Autenticación :
    • Llamada POST al punto de conexión de inicio de sesión (ej. /api/login en los servidores Isypower Cloud).
    • Carga útil: { "username": "tu_correo_electrónico", "password": "tu_contraseña" }.
    • Como respuesta, la API devuelve un token de autenticación (JWT Token) que debe incluirse en los encabezados (Authorization: Bearer <TOKEN>).
  2. Recuperación de datos :
    • Descubrimiento de las centrales/sistemas asociados a la cuenta.
    • Recuperación de las métricas de telemétrica de tu instalación (instantáneas e índices).
  3. Frecuencia de actualización :
    • No es necesario consultar la API cada segundo: el dispositivo ISYPOWER envía sus datos a la nube cada 3 minutos. Se recomienda un polling cada 2 a 3 minutos para evitar el bloqueo de la cuenta / rate-limiting.

Puedo encargarme de eso

Aquí tienes la integración externa para seguir una instalación solar Isypower (Materfrance, anteriormente Izypower) en Gladys.

Qué hace

Se conecta a Isypower Cloud con el correo electrónico y la contraseña de la aplicación, y lee sus centrales, microinversores y baterías cada 3 minutos (el ritmo al que los dispositivos envían sus datos). Es una integración cloud: los datos pasan por la nube de Materfrance, como en la aplicación. No existe una integración nativa de Isypower en Gladys.

Funcionalidades

  • Un dispositivo por central: producción solar, consumo de la casa, intercambio con la red (positivo en compra, negativo en venta), nivel y potencias de las baterías, y índices acumulados: producción, energía comprada a la red (que alimenta el consumo y el costo en Gladys), energía vendida, energía almacenada y restituida.
  • Un dispositivo por batería: nivel, energía almacenada, potencias, temperatura, toma de emergencia, y el modo de control (inteligente, manual, calendario) y el modo manual (standby, carga, descarga) en listas desplegables.
  • 3 widgets: « Instalación solar » (potencias + curvas de las últimas 24 horas), « Balance energético » (día, mes, año, desde la instalación), « Batería doméstica » (con botones para cambiar de modo y ajustar la carga mínima).
  • 4 disparadores: la batería se carga / se descarga / se detiene, un equipo se desconecta o vuelve, actualización de firmware disponible, central silenciosa durante 20 minutos.
  • 3 acciones de escena: cambiar el modo de una batería (con la potencia en manual), ajustar su carga mínima, leer el balance energético de un período.

Ejemplos de escenas:

  • Cada noche a las 21 h → leer el balance del día → enviar el resumen en Telegram (« Casa, hoy: 9,8 kWh producidos, 6,1 kWh consumidos… »).
  • Inicio de las horas punta → batería en descarga manual a 800 W; fin de las horas punta → volver al calendario.
  • Un microinversor desconectado o la central silenciosa → notificación.

Instalación

  • Desde la tienda de Gladys: disponible en el día, el tiempo de la indexación.
  • O desde la URL del repositorio: https://github.com/William-De71/gladys-isypower.
  • Gladys 5.2.0 mínimo.

Configuración:

  1. Ingresar el correo electrónico y la contraseña de Isypower Cloud, guardar.
  2. En « Descubrimiento », crear la central y las baterías.
  3. Añadir los widgets y crear las escenas.

Capturas

Los tres widgets (ilustración generada, no una captura de pantalla)

Ilustración generada a partir del código de la integración, no una captura de pantalla.

Capturas reales por venir

No tengo una cuenta Isypower: las verdaderas capturas (configuración, descubrimiento, dispositivos) se añadirán tan pronto como un usuario las haya probado.

Límites conocidos

  • Nunca probada en una cuenta real: no tengo una instalación Isypower. La API no está documentada; se utiliza como lo hace la integración Home Assistant izypower_cloud. Solo las respuestas de error de la conexión han sido verificadas en el servidor real.
  • El sentido de la potencia de la batería de la central (positivo en carga) se deduce de la integración Home Assistant: por confirmar.
  • No gestionados aún: los módulos de batería individuales, la limitación de inyección del contador inteligente, los puntos de carga (EVSE), la toma de emergencia y la calibración en escritura, el modo « en vivo » rápido de la aplicación.
  • Una batería esclava sigue a su maestra: solo los modos de la maestra (o de una batería autónoma) son modificables.

Comentarios
Gracias de antemano por tus comentarios y no dudes en decirme si falta algo.

Gracias, lo instalo mañana por la mañana y te doy un feedback durante el día cuando tenga algunas estadísticas.

¿Quién habría pensado hace solo 6 meses que una solicitud de atención completa sería posible 1 hora después de la solicitud!!.. Esta época es loca… ¡completamente loca!! :sweat_smile: