Como respuesta, la API devuelve un token de autenticación (JWT Token) que debe incluirse en los encabezados (Authorization: Bearer <TOKEN>).
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).
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.
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:
Ingresar el correo electrónico y la contraseña de Isypower Cloud, guardar.
En « Descubrimiento », crear la central y las baterías.
Añadir los widgets y crear las escenas.
Capturas
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.
¿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!!