Integración domótica GoodWe, gratuita y de código abierto
Inversores solares y baterías GoodWe: producción, red, casa y batería, en local o nube SEMS.
Publicado por gboulvin
- Dispositivos
- Versión 1.0.0
- Requiere Gladys >=5.1.0
- ★ 0
Siga su instalación solar GoodWe en Gladys: producción solar, consumo de la casa, importación/exportación de red y batería, en directo, con escenas y widgets del panel.
Inversores compatibles
| Familia | Modelos | Local (red) | Nube SEMS |
|---|---|---|---|
| ET (híbrido, batería) | ET, EH, BT, BH, ET Plus, EHA/ESA G20, GEH… | ✅ + ajustes | ✅ |
| ES (híbrido, batería) | ES, EM, BP, SBP | ✅ + ajustes | ✅ |
| DT (conexión a red) | DT, SDT, MT, MS, D-NS, XS, GEP… | ✅ | ✅ |
El inversor necesita su módulo WiFi o LAN GoodWe (Wi-Fi Kit, WiFi/LAN Kit, Ezlink…) conectado a su red doméstica.
Dos formas de llegar al inversor
Local (recomendada). Gladys habla directamente con el inversor en su red (puerto UDP 8899): valores cada minuto, energía del día, índices de los contadores, temperatura y ajustes disponibles en escenas. Sin cuenta, sin Internet.
Nube SEMS (opcional). La cuenta del portal SEMS / de la app SEMS+. Funciona cuando Gladys no está en la misma red que el inversor y sirve de respaldo cuando falla la conexión local. Solo lectura, actualizada cada 5 minutos (el portal limita las peticiones más frecuentes).
Con ambas, cada inversor es un solo dispositivo: leído en local, pasa a la nube si se pierde la conexión local (un punto naranja en la insignia «nube» lo indica) y vuelve. La opción estándar Preferir la conexión local elige el canal que se prueba primero.
Configuración
- Instale la integración desde Integraciones → GoodWe.
- Conexión local:
- deje activada Buscar inversores GoodWe en la red;
- si no se encuentra el inversor (otra subred, VLAN, router que bloquea la difusión), introduzca su dirección IP y fíjela en el router (reserva DHCP).
- Nube (opcional): correo electrónico y contraseña de su cuenta SEMS. Consejo: cree una cuenta de visitante dedicada en la app SEMS.
- Pulse Probar la conexión: cada inversor encontrado aparece con su modelo y número de serie.
- Abra la pestaña Descubrimiento y añada sus inversores.
Funciones del dispositivo
Producción solar (W), producción del día / total (kWh), potencia de red (W, importación > 0, exportación < 0, contador necesario), índices de importación / exportación (kWh), consumo de la casa (W), nivel de batería (%), potencia de carga / descarga (W), energía cargada / descargada (kWh), temperatura del inversor (°C), tensión de red (V), según el modelo y la conexión.
Escenas
Activadores: Producción solar iniciada / detenida, Excedente solar iniciado / terminado (potencia inyectada por encima del umbral de la configuración, 500 W por defecto), Avería del inversor, Inversor inaccesible / accesible de nuevo.
Acciones: Leer el inversor GoodWe (valores frescos para las acciones siguientes), Cambiar el modo de funcionamiento GoodWe (familia ET), Limitar la exportación GoodWe (W), Ajustar la profundidad de descarga GoodWe (%). Los ajustes requieren la conexión local; si el inversor no puede realizar una acción, devuelve Aplicado = no.
Widgets del panel
- Inversor GoodWe: mosaicos en directo solar, casa, red y batería, estado, conexión y botón Actualizar;
- Producción GoodWe: gráfico de producción y consumo (24 h a un mes) y balance energético del día.
Solución de problemas
- Ningún inversor encontrado: introduzca su dirección IP y permita el puerto UDP 8899 entre Gladys y el inversor. Algunos módulos recientes solo hablan con la nube: use entonces la cuenta SEMS.
- Nube: «inicio de sesión rechazado»: compruebe el correo y la contraseña en semsportal.com. Tras una limitación, la integración espera 5 minutos por sí misma.
GoodWe es una marca de GoodWe Technologies Co., Ltd. Esta integración comunitaria no está afiliada a GoodWe.
Parámetros de configuración
Estos son los parámetros que GoodWe te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Conexión local (recomendada) | section | No | El inversor se lee en su red (puerto UDP 8899 de su módulo WiFi/LAN): cada minuto, valores detallados, ajustes disponibles en escenas. Deje activa la búsqueda en red o introduzca su dirección IP (fíjela en su router). |
| Direcciones IP de los inversores | string | No | Opcional, separadas por comas. Necesario si la búsqueda en red no encuentra el inversor. |
| Buscar inversores GoodWe en la red | boolean | No | |
| Nube SEMS (opcional) | section | No | La cuenta del portal SEMS / de la app SEMS+. Se usa cuando el inversor no es accesible en la red, o como respaldo. Solo lectura, actualizada cada 5 minutos. Basta con una cuenta de visitante creada en la app SEMS. |
| Correo electrónico SEMS | string | No | |
| Contraseña SEMS | secret | No | |
| Intervalo de actualización (s) | number | No | Frecuencia de lectura de los inversores, en segundos (un minuto mínimo, 5 minutos para la nube). |
| Umbral de excedente (W) | number | No | Potencia inyectada a la red a partir de la cual se dispara el activador «Excedente solar». |
Cómo instalar GoodWe en Gladys
- En Gladys, abre Integraciones: GoodWe aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/gboulvin/gladys-goodwe-solar:1.0.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/gboulvin/Gladys-GoodWe-Solar.
GoodWe requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
GoodWe es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene gboulvin, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación