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

zappi, eddi, harvi y libbi de myenergi: carga, agua caliente, excedente solar y refuerzos.

• Publicado por guim31
• Dispositivos
• Versión 1.0.1
• Requiere Gladys >=5.2.0
• ★ 0

Ver en GitHubTodas las integraciones

Siga y controle sus aparatos myenergi desde Gladys: el cargador zappi, el desviador de agua caliente eddi, el sensor de pinzas inalámbrico harvi y la batería libbi. Gladys los lee a través de la nube de myenergi, el mismo servicio que la aplicación myenergi: potencia solar y de la red, estado y energía de la carga del coche, agua caliente calentada con el excedente solar, nivel de la batería. Cambia el modo de carga del zappi, inicia y detiene los refuerzos y lanza una escena cuando termina una carga.

Desarrollada sin el hardware: sus comentarios son bienvenidos. Esta integración se ha escrito y probado con las respuestas de la nube de myenergi publicadas por la biblioteca pymyenergi, no con aparatos reales. Si algo no funciona como se describe, dígalo en el foro de Gladys o en las issues.

Esta integración no está afiliada a myenergi Ltd.

Lo que necesita

• Gladys Assistant 5.2.0 o posterior.
• Un hub myenergi (o un zappi o un eddi que haga de hub), conectado a internet, con sus aparatos emparejados en la aplicación myenergi.
• El número de serie del hub y una clave de API. Inicie sesión en su cuenta myenergi y abra Productos: el número de serie aparece junto al hub, con un botón para generar una clave de API (artículo de myenergi: How do I get an API key?). La clave solo se muestra una vez: cópiela.

Configuración

1. Instale la integración desde el catálogo de Gladys.
2. En Configuración, introduzca el Número de serie del hub (solo cifras) y la Clave de API, y guarde.
3. Haga clic en Probar la conexión: el mensaje bajo el botón enumera los aparatos encontrados y el servidor myenergi de su cuenta.
4. Abra la pestaña Descubrimiento: un aparato para la instalación, más uno por cada zappi, eddi, harvi y libbi. Haga clic en Añadir, elija una habitación y guarde. Solo se siguen los aparatos añadidos.

Opciones:

• Intervalo de actualización: con qué frecuencia se lee la nube de myenergi, de 1 minuto (por defecto) a 10 minutos.
• Idioma de los textos: inglés, francés (por defecto), alemán o español. Sirve para los nombres de las funciones (dados al añadir un aparato), los textos de estado y los mensajes de las escenas.

Los aparatos

Instalación

El aparato que lleva el nombre de su sitio en la aplicación myenergi.

Función	Qué es
Potencia de la red	Potencia intercambiada con la red, en W: positiva al importar, negativa al exportar
Potencia solar	Potencia de sus paneles solares, en W
Tensión de la red	Tensión medida por un zappi, un eddi o una libbi, en V

Los valores de red y solares son los de las pinzas de tipo Grid y Generation en la aplicación myenergi, sumados en todos los aparatos, como los calcula la aplicación myenergi.

zappi

Función	Qué es
Conector	Disponible (sin coche), Ocupado (coche enchufado) o En avería
Carga	Cargando, Vehículo conectado, En pausa (vehículo), En pausa (cargador: esperando excedente, o modo Parada), Inactivo (carga terminada, o sin coche)
Coche enchufado	Sí / no: lo más sencillo para lanzar una escena al enchufar
Modo de carga	Orden: Rápido, Eco, Eco+ (solo excedente solar) o Parada
Potencia de carga	Potencia enviada al coche, en kW
Energía de la sesión	Energía añadida al coche desde que se enchufó, en kWh
Energía de hoy	Energía entregada hoy por el zappi (solar y red), en kWh
Energía total	Energía acumulada desde que se añadió el zappi, en kWh
Pinza n (…)	Potencia leída por cada pinza asignada en la aplicación myenergi, en W

La Energía total es un índice que Gladys usa para su seguimiento de la energía: calcula con él el consumo de cada media hora y su coste según su contrato de energía. La nube de myenergi no tiene contador de por vida: la integración suma el historial diario, día tras día, y guarda el resultado en /data.

eddi

Función	Qué es
Estado	Esperando excedente, Desviando, Refuerzo en curso, Temperatura máxima alcanzada o Detenido
Calentando	Sí mientras el eddi calienta el agua (excedente o refuerzo)
Potencia de calentamiento	Potencia enviada a la resistencia, en W
Desviado hoy	Excedente solar enviado al agua hoy, en kWh
Energía total	Energía acumulada del eddi (excedente y refuerzo), en kWh, como para el zappi
Desvío del excedente	Orden: activado (modo normal) o detenido
Refuerzo	Sí mientras hay un refuerzo en curso
Refuerzo restante	Minutos que quedan del refuerzo en curso
Temperatura sonda 1, Temperatura sonda 2	Las sondas de temperatura del depósito, cuando están conectadas
Pinza n (…)	Potencia leída por cada pinza asignada, en W

Los refuerzos se inician desde el widget o una escena, durante un tiempo dado: a propósito no hay interruptor de encendido/apagado del calentamiento (un refuerzo siempre termina por sí solo).

harvi

Una función de potencia por cada pinza asignada en la aplicación myenergi, en W. Un harvi sin pinza asignada no se publica.

libbi

Función	Qué es
Nivel de batería	Estado de carga, en %
Potencia de carga	Potencia que entra en la batería, en W
Potencia de descarga	Potencia que sale de la batería, en W
Estado	Cargando, Descargando, En espera, Batería llena, Detenida, Fallo…
Pinza n (…)	Potencia leída por cada pinza asignada, en W

La libbi es de solo lectura: sus modos y su objetivo de carga necesitan la cuenta de la aplicación myenergi (no la clave de API), que esta integración no usa.

Widget del panel

Añada el widget myenergi a un panel. Muestra cuatro mosaicos (solar, red, potencia del zappi, potencia del eddi), el estado del zappi y del eddi, la energía de la sesión y la energía desviada hoy. En sus ajustes, elija un zappi y un eddi si tiene varios.

Botones:

• Refuerzo coche: pide la energía a añadir, en kWh, y opcionalmente la hora a la que debe estar lista (smart boost). Solo se muestra en los modos Eco y Eco+: en modo Rápido el zappi ya carga a plena potencia.
• Refuerzo agua caliente: pide una duración (1 a 240 minutos) y la resistencia.
• Detener refuerzo: detiene todos los refuerzos en curso, tras una confirmación. Se muestra mientras hay un refuerzo en curso.

Los mosaicos siguen en directo los valores de los aparatos añadidos a Gladys. Cuando la nube de myenergi no responde, el widget muestra la última lectura y lo indica.

Escenas

Disparador

• Carga del zappi terminada: el zappi ha terminado de cargar el coche. Filtro opcional: el zappi. Variables: la energía de la sesión (kWh) y el nombre del zappi, para ponerlos en un mensaje.

Para los demás eventos (coche enchufado, potencia solar por encima de un umbral, nivel de batería…), use el disparador habitual Estado de un aparato sobre las funciones anteriores.

Acciones

• Cambiar el modo de carga del zappi: Rápido, Eco, Eco+ o Parada.
• Iniciar un refuerzo del zappi: añade esta energía (1 a 99 kWh) desde la red, ahora, o lista para una hora (07:30) con un smart boost. Solo modos Eco y Eco+.
• Detener el refuerzo del zappi.
• Iniciar un refuerzo del eddi: calienta el agua desde la red durante 1 a 240 minutos, con la resistencia 1 o 2.
• Detener el refuerzo del eddi: cancela el refuerzo de las dos resistencias.

Ideas de escenas

• Tarifa nocturna barata: a las 23:00, Cambiar el modo de carga del zappi a Rápido; a las 06:30, de vuelta a Eco+.
• Coche listo para un viaje: con un evento de calendario «viaje», Iniciar un refuerzo del zappi de 30 kWh listo a las 07:00.
• Carga terminada: con Carga del zappi terminada, envíe «El coche está cargado: {{triggerEvent.data.energy_kwh}} kWh añadidos» a su teléfono.
• Día nublado: a las 17:00, si Desviado hoy está por debajo de 2 kWh, Iniciar un refuerzo del eddi de 60 minutos.

Actualización y uso de la API

• Una solicitud a la nube de myenergi lee todos los aparatos, al intervalo de actualización (1 minuto por defecto, nunca más rápido). El historial horario (energía del día, energía total) se lee cada 10 minutos por cada zappi y eddi añadidos a Gladys, y una vez más justo después de medianoche para cerrar el día.
• No se lee nada mientras no se haya añadido ningún aparato, salvo cuando hace clic en Probar la conexión o busca en la pestaña Descubrimiento.
• Una orden (modo, refuerzo) es una solicitud, seguida de una lectura 5 segundos después para mostrar lo que ha aplicado el aparato.
• La API es la de la aplicación myenergi; myenergi no publica ninguna cuota para ella. Si responde «demasiadas solicitudes», aumente el intervalo.

Solución de problemas

• Número de serie o clave de API rechazados por myenergi: compruebe el número de serie (solo cifras, el del hub) y genere una nueva clave de API; un hub nuevo necesita una clave nueva.
• La nube de myenergi no responde: la integración lo vuelve a intentar en cada intervalo e indica cuándo responde de nuevo; mientras tanto, el widget muestra la última lectura. La aplicación myenergi pasa por la misma nube: compruébela.
• La energía total empieza baja: parte de la energía del día en que se añade el aparato. Gladys sigue los aumentos, no el valor inicial.
• Aparece o desaparece una pinza: las pinzas se publican tal como están asignadas en la aplicación myenergi; tras un cambio, la pestaña Descubrimiento propone actualizar el aparato.
• Más detalles: ponga la variable de entorno LOG_LEVEL=debug de la integración y lea sus registros. La clave de API nunca aparece en ellos.

Límites

• Desarrollada sin el hardware: los valores y las órdenes siguen las respuestas documentadas por pymyenergi; algunos campos (la potencia de carga del zappi, el signo de la potencia de la libbi) se interpretan, no se han comprobado en un aparato.
• Solo nube: sin control local, y nada funciona cuando la nube de myenergi o su conexión a internet están caídas.
• No compatible: el desbloqueo del zappi (omitido a propósito, por seguridad), las prioridades de los aparatos, el nivel mínimo de verde, los modos y el objetivo de carga de la libbi (necesitan la cuenta de la aplicación).
• Gladys valora la Energía total a la tarifa de su contrato, parte solar incluida: es lo que habría costado la energía tomada de la red.
• Los números de serie vienen de la nube; los nombres son los dados en la aplicación myenergi, releídos cada 6 horas.

Parámetros de configuración

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

Parámetro	Tipo	Obligatorio	Descripción
Cuenta myenergi	section	No	Gladys lee sus aparatos a través de la nube de myenergi, como la aplicación myenergi. Necesita el número de serie de su hub y una clave de API: inicie sesión en su cuenta myenergi, abra Productos y genere una clave de API junto al hub. Solo se muestra una vez.
Número de serie del hub	string	Sí	Solo cifras, como aparece en Productos de la cuenta myenergi.
Clave de API	secret	Sí	Generada en la aplicación myenergi. Guardada en Gladys, nunca escrita en los registros.
Intervalo de actualización	select	No	Con qué frecuencia se lee la nube de myenergi. Como mucho cada minuto, como la aplicación.
Idioma de los textos	select	No	Nombres de las funciones (dados al añadir un aparato), mensajes de escenas, textos de estado.

Cómo instalar myenergi en Gladys

1. En Gladys, abre Integraciones: myenergi 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-myenergi: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-myenergi.

myenergi requiere Gladys >=5.2.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

myenergi 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.

• 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

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 🙂