Saltar al contenido principal

Integración domótica Growatt, gratuita y de código abierto

Integración Growatt para Gladys Assistant

Inversores solares y baterías Growatt: producción, batería, red y consumo.

Ver en GitHubTodas las integraciones

Siga sus inversores solares y baterías Growatt en Gladys: producción solar, energía del día e índice de producción, nivel y potencia de la batería, importación y exportación de la red, consumo de la vivienda, estado del inversor. Los datos vienen de la nube Growatt (ShineServer, la aplicación ShinePhone) y se leen cada 5 minutos: el ritmo al que suben los registradores Growatt. La integración solo lee: nunca cambia un ajuste del inversor.

Desarrollada sin el hardware: sus comentarios son bienvenidos. Esta integración no está afiliada a Growatt.

Requisitos​

  • Una instalación Growatt visible en la aplicación ShinePhone o en server.growatt.com, con su registrador (ShineWiFi, ShineLAN, ShineLink) en línea.
  • Uno de los dos accesos:
    • un token OpenAPI (recomendado). Algunas cuentas pueden crearlo en los ajustes de la cuenta en server.growatt.com; si no, solicítelo al soporte de Growatt o a su instalador;
    • el usuario y la contraseña de la aplicación ShinePhone.
  • Gladys 5.1 o posterior, con acceso a Internet.

Configuración​

Abra la pestaña Configuración de la integración.

Token OpenAPI (recomendado)​

Elija Token OpenAPI como modo de conexión y pegue el token. La OpenAPI es la interfaz que Growatt documenta para el software de terceros: sin inicio de sesión, nada guardado por la integración. Hay datos detallados para la familia MIN (MIN, TL-X, TL-XH, MOD, MIC) y los híbridos SPH; los demás dispositivos cuentan en los totales de la instalación.

Cuenta ShinePhone​

Elija Cuenta ShinePhone e introduzca el usuario y la contraseña de la aplicación. Este acceso puede ser bloqueado por Growatt: la interfaz no está documentada, su servidor solo acepta el User-Agent de la aplicación Growatt (la integración se presenta como la aplicación, como las bibliotecas de referencia), puede rechazar un acceso con HTTP 403 y bloquea una cuenta que se conecta con demasiada frecuencia (error 507, durante aproximadamente un día). Prefiera un token cuando sea posible. Por eso la integración se conecta una vez, guarda la sesión en su volumen /data (nunca la contraseña) y la reutiliza, incluso tras un reinicio; solo vuelve a conectarse cuando la sesión caduca, y nunca dos veces en 10 minutos. Hay datos detallados para los inversores de cadena, TL-X / MIN y SPH (MIX).

Otros ajustes​

  • Servidor Growatt: la región donde se creó la cuenta (Europa y otras regiones, América del Norte, Australia y Nueva Zelanda, China).
  • Instalaciones a seguir: vacío para todas las instalaciones de la cuenta, o los identificadores de instalación separados por comas.
  • Intervalo de actualización: 5 minutos por defecto, o 10, 15, 30. Growatt rechaza leer más rápido que cada 5 minutos.
  • Idioma de los nombres de funciones: los nombres dados a las funciones al añadir un dispositivo, y el idioma del estado del inversor (francés por defecto).

Guarde y pulse Probar la conexión: el mensaje enumera las instalaciones y los inversores encontrados. Los dispositivos aparecen en la pestaña Descubrir: añada los que desee.

Dispositivos​

Instalación​

Un dispositivo por instalación Growatt, con los totales que Growatt calcula para toda la instalación:

FunciónUnidadSignificado
Potencia de producciónWPotencia que produce la instalación ahora
Producción de hoykWhEnergía producida desde medianoche
Índice de producciónkWhEnergía producida desde la puesta en marcha

Inversor​

Un dispositivo por inversor que la API lee en detalle. Las funciones siguen lo que el inversor comunica: una batería solo aparece en una instalación que la tiene, las funciones de red y vivienda solo cuando hay un contador Growatt (o una pinza) conectado.

FunciónUnidadSignificado
Estado del inversortextoNormal, En espera, En fallo, Sin conexión
Potencia solarWPotencia de los paneles
Tensión FV1, Corriente FV1, FV2…V, ACada cadena de paneles
Potencia de salida del inversorWPotencia alterna que entrega el inversor
Producción de hoy, Índice de producciónkWhEnergía solar del día, desde la puesta en marcha
Nivel de batería%Estado de carga
Potencia de carga y de descarga de la bateríaWPotencia que entra en la batería y que sale de ella
Índice de carga y de descarga de la bateríakWhEnergía cargada y descargada desde el inicio
Potencia importada de la red, exportada a la redWPotencia tomada de la red y enviada a la red
Índice de importación y de exportación de la redkWhEnergía tomada de la red y enviada a la red
Consumo de la vivienda, Índice de consumo de la viviendaW, kWhConsumo de la vivienda medido por el contador
Temperatura del inversor°CTemperatura del inversor

Una función vista por primera vez (una batería que despierta por la mañana) se ofrece como Actualizar en la pestaña Descubrir. Una función nunca se retira: una batería leída vacía por la noche conserva sus funciones.

Seguimiento de energía​

Los índices (producción, batería, red, vivienda) son contadores en kWh que el seguimiento de energía de Gladys convierte en energía por media hora. La instalación y sus inversores cuentan la misma producción: para la producción, añada al seguimiento de energía la instalación o sus inversores, no ambos, o se contará dos veces. Los contadores Growatt a veces marcan 0 o retroceden un poco hacia medianoche: la integración filtra estas anomalías.

Widget del panel​

Resumen solar: elija una instalación o un inversor en sus ajustes. Muestra mosaicos en directo (producción, energía del día, batería, importación y exportación de la red, vivienda), la curva de producción del día y el estado del inversor con la hora de sus últimos datos.

Disparador de escena​

El estado del inversor ha cambiado: se activa cuando un inversor entra en fallo, deja de comunicar con la nube Growatt (sin conexión), queda en espera (por la noche) o vuelve a funcionar con normalidad. Filtros: el inversor, el nuevo estado. Variables para las acciones: el nuevo estado (código y texto), el estado anterior, el nombre del inversor. La primera lectura tras un arranque nunca lo activa.

Acción​

Probar la conexión (pestaña Configuración): lee la cuenta e indica las instalaciones e inversores encontrados, los dispositivos contados solo en los totales de la instalación, o el motivo de un fallo. Reutiliza los datos leídos hace menos de 5 minutos: pulsarla de nuevo no multiplica las solicitudes a Growatt.

Ejemplos de escenas​

  • Avisar de un fallo: disparador «El estado del inversor ha cambiado» con los estados En fallo y Sin conexión → enviar el mensaje «El inversor {{device_name}} está ahora {{status_label}}».
  • Aprovechar el excedente: cada 5 minutos, si la potencia exportada a la red supera 1500 W y el nivel de batería el 90 % → encender el enchufe del calentador de agua.
  • Balance de la noche: cada día a las 21:00 → enviar un mensaje con la producción del día de la instalación.

Solución de problemas​

  • «Growatt rechaza el token»: compruebe el token y la región del servidor. La integración deja de llamar a Growatt hasta que cambie la configuración.
  • «Growatt rechaza el usuario o la contraseña»: compruébelos en la aplicación ShinePhone, así como la región. Ningún nuevo intento hasta que cambie la configuración, para proteger la cuenta.
  • «El servidor Growatt rechaza el inicio de sesión ShinePhone (HTTP 403)»: el servidor rechaza la propia solicitud de acceso, sea cual sea la contraseña. La integración espera 6 horas antes de volver a intentarlo; use un token OpenAPI en su lugar.
  • «Growatt bloqueó la cuenta»: el servidor ShinePhone bloqueó la cuenta tras demasiadas conexiones (las demás aplicaciones conectadas con la misma cuenta también cuentan). La integración espera 6 horas antes de volver a intentarlo, reinicio incluido. Un token evita el problema.
  • «La nube Growatt no responde»: las lecturas se reanudarán solas.
  • Un inversor aparece Sin conexión: su registrador ya no sube datos (Wi-Fi, alimentación).
  • Para más detalle, ajuste la variable LOG_LEVEL=debug de la integración y consulte sus registros: nunca contienen el token ni la contraseña.

Límites​

  • Desarrollada sin el hardware ni una cuenta Growatt: los nombres de los campos vienen de la biblioteca growattServer y de la integración de Home Assistant. Sus comentarios son bienvenidos, sobre todo sobre los SPH (la unidad de sus potencias de red) y los estados de las familias menos comunes.
  • Solo lectura: no se puede cambiar ningún ajuste del inversor (carga, descarga, límite de inyección).
  • Los datos son los de la nube Growatt: como mucho de hace 5 minutos, y ausentes cuando la nube falla.
  • Datos detallados: MIN / TL-X / MOD / MIC y SPH con un token; inversores de cadena, TL-X y SPH con una cuenta. Las demás familias (MAX, SPA, almacenamiento, NOAH…) solo en los totales de la instalación.
  • Solicitudes por actualización: con un token, 2 por instalación, 1 por MIN, 2 por SPH y la lista de dispositivos una vez por hora; con una cuenta, 1 o 2 por instalación, 1 por inversor, 2 por SPH.

Parámetros de configuración​

Estos son los parámetros que Growatt te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
Conectar su cuenta GrowattsectionNoUn token OpenAPI (recomendado: solicítelo al soporte de Growatt o a su instalador). La cuenta de la aplicación ShinePhone puede ser bloqueada por Growatt: su servidor rechaza algunos accesos y bloquea las cuentas demasiado solicitadas.
Modo de conexiónselectSí
Token OpenAPIsecretNoSolo en modo token. Lo guarda Gladys, nunca se escribe en los registros.
Usuario de ShinePhonestringNoSolo en modo cuenta ShinePhone. Growatt puede bloquear este acceso: prefiera un token.
Contraseña de ShinePhonesecretNoSolo en modo cuenta ShinePhone. Lo guarda Gladys, nunca se escribe en los registros.
Servidor GrowattselectNoLa región donde se creó la cuenta.
Instalaciones a seguirstringNoVacío: todas las instalaciones de la cuenta. Si no, los identificadores, separados por comas.
Intervalo de actualizaciónselectNoGrowatt recibe datos nuevos cada 5 minutos: leer más rápido no aporta nada.
Idioma de los nombres de funcionesselectNoSe usa al añadir un dispositivo a Gladys y para el estado del inversor.

Cómo instalar Growatt en Gladys​

  1. En Gladys, abre Integraciones: Growatt aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/guim31/gladys-growatt:1.0.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-growatt.

Growatt 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​

Growatt 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 guim31, no el equipo principal de Gladys.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂
Última actualización en