Saltar al contenido principal

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

Integración HomeWizard Energy para Gladys Assistant

Medidor P1, enchufe, medidores kWh, contador de agua y batería HomeWizard, leídos en la red local.

Ver en GitHubTodas las integraciones externas

Lea sus dispositivos HomeWizard Energy en Gladys, a través de su red local: el medidor P1 conectado al puerto P1 de un contador eléctrico inteligente (DSMR, Países Bajos, Bélgica, Luxemburgo…), el enchufe Energy Socket, los medidores kWh (monofásicos y trifásicos, Eastron SDM230 y SDM630 incluidos), el contador de agua Watermeter y la batería Plug-In Battery. Potencias, índices, tensiones, gas y agua, listos para la pestaña de energía de Gladys, con un widget de panel, dos disparadores y tres acciones de escena. Sin cuenta ni nube: Gladys lee cada dispositivo directamente, mediante la API local oficial de HomeWizard.

Desarrollada sin el hardware: sus comentarios son bienvenidos. Esta integración se ha construido y probado con respuestas reales de dispositivos HomeWizard grabadas por los proyectos python-homewizard-energy y Home Assistant, y con dispositivos simulados (API v1 y v2), no con un medidor real. Si algo no funciona como se describe, indíquelo en el foro de Gladys o en las issues.

Lo que necesita​

  • Gladys Assistant 5.1.0 o posterior.
  • Dispositivos HomeWizard configurados en la aplicación HomeWizard Energy, en la misma red que Gladys.
  • Para cada dispositivo, la API local:
    • API v1 (todos los modelos salvo la Plug-In Battery): en la aplicación HomeWizard Energy, Ajustes → Medidores → su dispositivo → API local, activada.
    • API v2 (medidor P1, medidores kWh y Plug-In Battery con un firmware reciente): segura (HTTPS), nada que activar en la aplicación, pero cada dispositivo se vincula una vez pulsando su botón (ver más abajo). La Plug-In Battery solo tiene esta.
  • Nada más: ni cuenta HomeWizard, ni clave, ni acceso a internet.

Instalación​

  1. Instale la integración desde el catálogo de Gladys.
  2. Abra su Configuración. Nada es obligatorio; las opciones son:
    • Direcciones IP de los dispositivos HomeWizard: solo para los dispositivos que el descubrimiento automático no encuentra, separadas por comas (por ejemplo 192.168.1.40, 192.168.1.41). Su router muestra la dirección de cada dispositivo. Los nombres terminados en .local no funcionan aquí: use la dirección.
    • Intervalo de actualización: frecuencia de lectura de cada dispositivo, de 2 segundos a 1 minuto (10 segundos por defecto). Las potencias siguen este ritmo; índices, tensiones, corrientes, gas y agua se envían a Gladys como máximo una vez por minuto, lo que basta para la pestaña de energía y aligera Gladys.
    • Idioma de los nombres de las funciones: inglés, francés, alemán o español (francés por defecto). Los nombres de las funciones se asignan al añadir un dispositivo, y los mensajes de las acciones de escena siguen este idioma.
  3. Abra la pestaña Descubrir de la integración: allí aparecen los dispositivos encontrados. Añada los que desee.
  4. Para usar la API v2 (recomendada en los dispositivos que la ofrecen, y la única posible para la Plug-In Battery): haga clic en Vincular (API v2): pulse el botón y, en los 75 segundos siguientes, pulse el botón de cada dispositivo que quiera vincular (en un medidor kWh, el botón de emparejamiento Wi-Fi, de 1 a 3 segundos, no más). El mensaje bajo el botón enumera los dispositivos vinculados. Un medidor P1 con su API v1 activada se lee por la v1 hasta que se vincula.

La acción Buscar dispositivos HomeWizard inicia una nueva búsqueda y enumera lo encontrado, la API usada por cada dispositivo y lo que bloquea a los demás (API local desactivada, vinculación necesaria, dispositivo que no responde). La acción Hacer parpadear un dispositivo hace parpadear la luz de estado de un dispositivo unos segundos, para encontrarlo entre otros idénticos.

Los dispositivos en Gladys​

Un dispositivo Gladys por dispositivo HomeWizard, con el nombre de su modelo y el final de su número de serie (HomeWizard P1 Meter aabbcc). Solo se publica lo que el dispositivo indica: un medidor monofásico no tiene L2 ni L3, un medidor de una sola tarifa no tiene índices por tarifa, un medidor P1 sin contador de gas no tiene gas.

Medidor P1

  • Potencia importada y Potencia exportada (W): lo que la casa toma de la red y lo que le devuelve, nunca negativas.
  • Índice de importación (kWh): la energía importada total. Es el que la pestaña de energía de Gladys convierte en consumo y coste; la potencia importada se conserva para los picos de potencia con los que se facturan algunos contratos.
  • Índice de exportación (kWh): la energía total devuelta a la red.
  • Índice de importación T1… T4 e Índice de exportación T1… T4 (kWh): por tarifa (día/noche), cuando el contador tiene varias.
  • Tensión L1… L3 (V) y Corriente L1… L3 (A), por fase, cuando el contador las indica. La corriente se da sin signo: su intensidad.
  • Gas y Agua (m³): los contadores de gas y de agua conectados al contador inteligente, que los lee aproximadamente cada hora.
  • Señal Wi-Fi (%).

Energy Socket

  • Encendido/Apagado: el relé, controlable.
  • Potencia (W), Índice de energía (kWh: el consumo que usa la pestaña de energía) y, en los enchufes recientes, Tensión (V) y Corriente (A).
  • Bloqueo del botón: activo, ni el botón del enchufe ni Gladys pueden apagarlo (congelador, router). Controlable.
  • Brillo del LED (0 a 100 %): el anillo luminoso del enchufe.
  • Señal Wi-Fi (%).

Medidores kWh (HWE-KWH1, HWE-KWH3, SDM230, SDM630)

  • Potencia (W, negativa cuando el circuito devuelve energía, un inversor solar por ejemplo) y, en los trifásicos, Potencia L1… L3.
  • Índice de importación (kWh, consumo en la pestaña de energía) e Índice de exportación (kWh, contado como producción por Gladys: un medidor kWh en un inversor solar).
  • Tensión y Corriente, o Tensión L1… L3 y Corriente L1… L3 en los trifásicos. Señal Wi-Fi (%).

Watermeter

  • Caudal de agua (m³/h: 1 L/min son 0,06 m³/h) y Total de agua (m³).
  • Señal Wi-Fi (%). El Watermeter solo responde con alimentación USB: con pilas duerme y Gladys no puede leerlo.

Plug-In Battery (solo API v2)

  • Nivel de batería (%), Potencia de carga y Potencia de descarga (W), Energía cargada y Energía descargada (kWh), Ciclos, Señal Wi-Fi (%).

Un dispositivo que no responde a tres lecturas seguidas muestra la insignia «inaccesible» en Gladys; sus últimos valores se mantienen.

Widget del panel​

Energía en directo muestra el intercambio con la red de un medidor P1:

  • un indicador Red, con signo: hacia la derecha cuando la casa consume de la red, hacia la izquierda (en verde) cuando le devuelve energía;
  • mosaicos Importación y Exportación, en directo;
  • con un medidor kWh solar elegido en la configuración del widget: Solar (la producción medida por ese medidor) y Casa (lo que consume la casa: importación − exportación + producción);
  • la tarifa en curso, el índice de gas y si los medidores responden.

Configuración: el medidor P1 (vacío: el primero encontrado) y, de forma opcional, el medidor kWh (o el enchufe) que mide sus paneles solares.

Escenas​

Disparadores​

  • La casa exporta más de…: la potencia que un medidor P1 envía a la red supera un umbral, elegido entre 100 W y 8 kW. Uso típico: los paneles solares producen más de lo que consume la casa.
  • La casa consume más de…: la potencia que un medidor P1 toma de la red supera un umbral.

Cada disparador se activa una vez cuando la potencia supera el umbral, y de nuevo solo después de haber bajado un 10 % por debajo (50 W como mínimo): una potencia que oscila alrededor del umbral no lo repite. Nada se activa justo después del arranque de Gladys o de la integración. La escena puede leer la Potencia (W) y el umbral alcanzado. Para actuar cuando la potencia vuelve a bajar, use la función Potencia importada o Potencia exportada en un disparador «estado de un dispositivo».

Acciones​

  • Encender un enchufe HomeWizard y Apagar un enchufe HomeWizard: devuelven si el enchufe está encendido. Rechazadas, con un mensaje, mientras su bloqueo del botón esté activo.
  • Hacer parpadear un dispositivo HomeWizard: la luz de estado parpadea unos segundos (no en los medidores kWh leídos por la API v1).

Ideas de escenas​

  • Excedente solar: «La casa exporta más de… 1,5 kW» → encender el enchufe del termo eléctrico o del cargador del coche; «Potencia exportada» por debajo de 200 W durante 10 minutos → apagarlo.
  • Evitar un pico: «La casa consume más de… 5 kW» → apagar un enchufe no esencial y enviar un mensaje.
  • Encontrar un dispositivo: en una escena iniciada desde el panel, «Hacer parpadear un dispositivo HomeWizard».

Solución de problemas​

  • Falta un dispositivo en la pestaña Descubrir: inicie Buscar dispositivos HomeWizard y lea el mensaje. «API local desactivada en la aplicación»: actívela en la aplicación HomeWizard Energy. «Pulse su botón después de Vincular»: el dispositivo solo ofrece la API v2, vincúlelo. No encontrado en absoluto: los dispositivos se encuentran a través del núcleo de Gladys (mDNS), solo en la misma red; introduzca su dirección IP en la configuración.
  • «Token rechazado, vincúlelo de nuevo»: el token de la integración se ha eliminado (dispositivo restablecido, lista de usuarios vaciada en la aplicación). Vuelva a vincularlo.
  • «Certificado rechazado»: el dispositivo en esta dirección no demuestra ser el dispositivo HomeWizard esperado; Gladys no le envía nada. Compruebe la dirección (¿un cambio de DHCP?) e inicie una búsqueda.
  • El Watermeter no responde: debe alimentarse por USB.
  • Los valores parecen retrasados: índices, tensiones y gas se envían una vez por minuto; el propio contador de gas se actualiza aproximadamente cada hora.

Límites​

  • Solo lectura periódica (sin push): las potencias son tan recientes como el intervalo de actualización.
  • Los modos de la batería (cero, carga completa, espera) y los ajustes de nube de los dispositivos no se controlan; el Energy Display no es compatible.
  • El Energy Socket y el Watermeter se leen por la API v1 (su API v2 sigue en desarrollo en HomeWizard).
  • Contadores externos de un medidor P1: un contador de gas y uno de agua; los contadores de calor no se leen.
  • Desarrollada sin el hardware (ver más arriba).

HomeWizard es una marca de HomeWizard B.V. Esta integración no está afiliada a HomeWizard.

Parámetros de configuración​

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

ParámetroTipoObligatorioDescripción
Encontrar sus dispositivos HomeWizardsectionNoActive «API local» para cada dispositivo en la aplicación HomeWizard Energy y abra la pestaña Descubrir: los dispositivos de la red de Gladys se encuentran solos. Los recientes (P1, kWh, batería) ofrecen la API v2 segura: inicie Vincular y pulse su botón.
Direcciones IP de los dispositivos HomeWizardstringNoOpcional, separadas por comas. Solo para los dispositivos que el descubrimiento automático no encuentra.
Intervalo de actualizaciónselectNoFrecuencia de lectura de cada dispositivo. Las potencias siguen este ritmo; los índices, tensiones y corrientes se envían a Gladys como máximo una vez por minuto.
Idioma de los nombres de las funcionesselectNoSe usa para los nombres de las funciones de los nuevos dispositivos y para los mensajes de las acciones de escena.

Cómo instalar HomeWizard Energy en Gladys​

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

HomeWizard Energy 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​

HomeWizard Energy 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