Integración domótica WattWächter Plus, gratuita y de código abierto
Lee el WattWächter Plus y muestra potencia, consumo y vertido en Gladys Assistant.
Publicado por tomgermany
- Dispositivos
- Versión 1.3.7
- Requiere Gladys >=5.1.0
- ★ 0
Una integración para Gladys Assistant que lee el medidor de electricidad a través de un WattWächter Plus. Todo funciona en la red local, sin nube y sin necesidad de crear una cuenta.
Requisito previo: Habilitar Modbus
El servidor Modbus en el WattWächter viene desactivado por defecto y debe habilitarse primero. Si no se realiza este paso, el dispositivo no responderá en el puerto 502 y la integración no podrá realizar ninguna lectura.
En la interfaz web del WattWächter, abra el API-Explorer, seleccione el endpoint POST /api/v1/settings
y envíe el siguiente contenido:
{ "modbus": { "enable": true, "port": 502 } }
Cambie el puerto únicamente si este ya está ocupado. El puerto configurado deberá indicarse más adelante en la configuración de la integración.
Instalación
- En Gladys, acceda a Integraciones e instale WattWächter Plus.
- Abra la configuración.
- Introduzca la dirección del dispositivo: la dirección IP (por ejemplo,
192.168.0.6) o el nombre mDNSwattwaechter-xxxxxxxxxxxx.local. - Introduzca el puerto Modbus (por defecto, 502).
- Para obtener los valores por periodos de tiempo en el widget, introduzca el token de lectura de la API REST. Sin este token, todo funcionará correctamente, a excepción de los cuatro botones de selección de periodo.
- Pulse Probar conexión. La respuesta indicará el modelo, la versión del firmware, el número de valores medidos y la potencia actual.
- En la pestaña Descubrir, inicie un escaneo y añada el dispositivo detectado.
Datos proporcionados por el dispositivo
Todo es de solo lectura: un medidor realiza mediciones, pero no admite comandos.
| Función | Significado |
|---|---|
| Potencia | Consumo actual en vatios. Los valores positivos indican consumo de la red; los negativos, inyección a la red. |
| Lectura de consumo | La lectura acumulada del contador en kWh, para el seguimiento de la energía. |
| Lectura de inyección | La lectura acumulada de la energía inyectada a la red en kWh. |
| Potencia L1 a L3 | La potencia en cada fase. |
| Tensión L1 a L3 | La tensión en cada fase, en voltios. |
| Intensidad L1 a L3 | La intensidad de corriente en cada fase, en amperios. |
| Frecuencia | La frecuencia de la red, en hercios. |
Si el contador no proporciona un valor, la integración simplemente no crea el dato correspondiente. Por ejemplo, en un contador que solo registra dos fases, el dato L3 no aparecerá (en lugar de mostrar un cero).
El widget «Contador de electricidad»
- La potencia: se muestra en un recuadro grande, incluyendo el signo del contador. Si hay inyección a la red, el recuadro cambia a color verde.
- El número de serie del contador: para identificar claramente a qué dispositivo se refiere.
- Cuatro botones: «Hoy», «7 días», «30 días» y «365 días». Se pueden ocultar desde la configuración del widget. El periodo seleccionado aparece resaltado y, debajo, se muestra el consumo correspondiente a dicho periodo en kWh.
En la configuración del widget, también es posible seleccionar qué contador proporciona los datos y definir si los valores por periodo se muestran en kWh o en Wh.
Escenas
Disparador «La potencia supera un límite»: notifica cuando la potencia supera el límite superior o cae por debajo del límite inferior. Estos límites se definen en la configuración; establecer el valor en 0 desactiva el límite correspondiente. El límite inferior puede ser negativo, ya que la inyección a la red se considera una potencia negativa.
El disparador envía una notificación una sola vez por cada evento en el que se supere el límite, no en cada medición individual. Solo cuando la potencia se ha alejado nuevamente del límite, es posible activar el proceso de nuevo. Para una condición simple del tipo «potencia superior a X», basta con utilizar el disparador de Gladys «cambio de estado de un dispositivo» aplicado a la función de potencia.
Acción «Leer lecturas del contador»: lee el dispositivo y transmite los datos de potencia, consumo, inyección a la red y número de contador a los pasos siguientes.
Acción «Leer consumo en un periodo»: calcula la suma del consumo durante un periodo determinado y transmite el resultado. Requiere el token de lectura.
Cómo funciona
Dos vías para acceder al mismo dispositivo; ambas son necesarias:
-
Modbus TCP proporciona los valores de medición. Solo responde a los comandos de lectura
0x03y0x04, y únicamente tiene en cuenta el instante actual. El dispositivo admite un máximo de dos conexiones simultáneas. -
La API REST proporciona los datos relativos a periodos temporales, ya que es la única que conoce, por ejemplo, el consumo registrado el día anterior. Requiere el token de lectura y opera a través del puerto 80.
La integración lee los registros siguiendo el estándar SunSpec. A partir de la versión de firmware 1.2.1, los valores también están disponibles como números de coma flotante; en este caso, la integración utiliza esta opción. De lo contrario, realiza la conversión de los números enteros aplicando sus correspondientes factores de escala. El valor reservado por SunSpec para indicar que «el contador no proporciona este dato» se filtra y nunca se publica.
Aspectos legales
Se trata de un proyecto independiente y no oficial. No mantiene ninguna relación con SmartCircuits GmbH ni con WattWächter; tampoco cuenta con su autorización, respaldo o patrocinio. WattWächter es una marca comercial propiedad de su titular; aquí se utiliza únicamente para identificar el dispositivo con el que interactúa esta integración. Todas las demás marcas, nombres de productos y nombres de empresas pertenecen a sus respectivos propietarios.
Parámetros de configuración
Estos son los parámetros que WattWächter Plus te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Conectar el WattWächter Plus | section | No | El servidor Modbus TCP del aparato está desactivado de fábrica. Actívalo primero en la interfaz web del WattWächter en Ajustes → Modbus TCP, si no la integración no puede leer ningún valor. La dirección y el puerto también aparecen ahí. |
| Dirección del WattWächter | string | Sí | Dirección IP o nombre mDNS, por ejemplo wattwaechter-XXXXXXXXXXXX.local. Una IP fija mediante reserva DHCP en el router es más robusta que el nombre mDNS. |
| Puerto Modbus | number | No | Por defecto 502. Cámbialo solo si el puerto se cambió en el aparato. |
| Token de lectura de la API REST (opcional) | string | No | Solo hace falta para los totales de periodo (hoy, 7, 30, 365 días) y la acción de escena «leer el total de un periodo». Sin token, esos botones no aparecen. La autenticación de la API está desactivada de fábrica; si lo está, deja el campo vacío. |
| Intervalo de consulta en minutos | select | No | Frecuencia de lectura de los valores WattWächter. Elige 1, 5, 15, 30 o 60 minutos. Predeterminado: 1 minuto. |
| Límite superior del activador de escena en vatios | number | No | Si se supera esta potencia, la integración informa del evento «umbral de potencia superado». 0 desactiva el límite superior. |
| Límite inferior del activador de escena en vatios | number | No | Introduce un valor negativo para el vertido, por ejemplo -3000. 0 desactiva el límite inferior. |
Cómo instalar WattWächter Plus en Gladys
- En Gladys, abre Integraciones: WattWächter Plus 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/tomgermany/gladys-wattwaechter:1.3.7), 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/tomgermany/gladys-wattwaechter.
WattWächter Plus 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
WattWächter Plus 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 tomgermany, 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