Saltar al contenido principal

Integración domótica Cumulus & Weather Display, gratuita y de código abierto

Integración Cumulus & Weather Display para Gladys Assistant

Su estación meteorológica en Gladys con Cumulus MX o Weather Display, sea cual sea su marca.

Lleva su estación meteorológica a Gladys a través de Cumulus MX (o Cumulus 1) o Weather Display, sea cual sea su marca (Davis, Ecowitt, Fine Offset, Oregon Scientific, La Crosse…): temperatura, humedad, presión y su tendencia, viento, lluvia, UV, radiación solar y más, tal como los mide el programa.

Desarrollada sin el hardware: sus comentarios son bienvenidos. La integración sigue el código fuente de Cumulus MX, la documentación de realtime.txt de la wiki de Cumulus y un clientraw.txt real de una estación Weather Display en línea, pero aún no se ha probado con un Cumulus MX real. Sus comentarios son bienvenidos en el repositorio de GitHub.

Esta integración no está afiliada ni a Cumulus (Sandaysoft) ni a Weather Display.

Presentación​

La integración lee una de tres fuentes, en su red local:

  • Cumulus MX (API): la interfaz de Cumulus MX, en el puerto 8998, en directo. Recomendado con Cumulus MX.
  • realtime.txt: el archivo de una línea que Cumulus 1 y Cumulus MX escriben en su intervalo de tiempo real, servido por un servidor web.
  • clientraw.txt: el archivo de una línea que escribe Weather Display, servido por un servidor web.

Obtiene un dispositivo de Gladys para la estación, cuatro disparadores de escena, una acción de escena y un widget de panel. Todo es de solo lectura y se queda en su red local: sin cuenta, sin nube.

Las unidades se leen en la fuente (°F, mph, nudos, inHg, pulgadas…): Gladys recibe °C, km/h, hPa y mm, y las convierte según sus preferencias cuando puede.

Requisitos​

  • Gladys 5.1 o posterior.
  • Cumulus MX, Cumulus 1 o Weather Display, accesible por la red desde Gladys.

Cumulus MX​

Nada que instalar: la interfaz de Cumulus MX (http://dirección:8998) ya responde. Su estación debe estar iniciada. Gladys ejecuta la integración en un contenedor: localhost es el propio contenedor, use la dirección del equipo donde se ejecuta Cumulus MX.

realtime.txt​

En Cumulus, active el archivo de tiempo real (Internet settings → Interval settings → Real time, luego el archivo realtime.txt en la lista de archivos de tiempo real) y haga que se copie en una carpeta servida por un servidor web. Abra primero su dirección en un navegador: debe ver una línea de números.

clientraw.txt​

En Weather Display, active la creación de clientraw.txt (archivos web personalizados) y haga que lo sirva un servidor web. Abra primero su dirección en un navegador: la línea empieza por 12345.

Configuración​

En Gladys, abra Integraciones → Cumulus & Weather Display → Configuración:

CampoQué introducir
FuenteCumulus MX (API), archivo realtime.txt (Cumulus) o archivo clientraw.txt (Weather Display).
DirecciónCumulus MX: http://dirección:8998. Un archivo: su dirección completa. Se acepta usuario:clave@.
Intervalo de lectura (s)30 por defecto, 10 como mínimo.
Idioma de los textosNombres de las funciones (fijados al añadir la estación), frase de escena y mensajes de acciones.

Guarde y pulse Comprobar la fuente: el botón indica si la fuente responde, qué programa y versión, y cuántos valores ha dado. Abra después la pestaña Descubrimiento y añada la estación.

El dispositivo estación​

La estación solo tiene las funciones que mide. Los dos archivos de texto escriben 0 para un sensor ausente: interior, UV y radiación solar solo aparecen tras un valor distinto de cero. Un sensor añadido más tarde aparece en la pestaña Descubrimiento, que propone entonces actualizar el dispositivo.

FunciónUnidadTag Cumulus MX / campo realtime.txt / campo clientraw.txt
Temperatura°Ctemp / 3 / 4
Sensación térmica°Cfeelslike / 59 / —
Punto de rocío°Cdew / 5 / 72
Humedad%hum / 4 / 5
Temperatura interior°Cintemp / 23 / 12
Humedad interior%inhum / 24 / 13
Presión (nivel del mar)hPapress / 11 / 6
Tendencia de presión (3 h)hPapresstrendval × 3 / 19 × 3 / —
Viento medio / Ráfagaskm/hwspeed, wgust / 6, 41 / 1, 2
Dirección del viento°avgbearing / 47 / 3
Intensidad de lluviamm/hrrate / 9 / 10 × 60
Lluvia de hoymmrfall / 10 / 7
Está lloviendosí/noIsRaining, o una intensidad de lluvia distinta de cero
Índice UVUV / 44 / 79
Radiación solar (W/m²)SolarRad / 46 / 127
Batería bajasí/noLowBatteryList no vacío (solo Cumulus MX)
Estación accesiblesí/nola fuente responde y hay una medición nueva en 15 minutos
Última mediciónminminutos desde la última medición nueva

La Lluvia de hoy es la del programa: desde su hora de cambio de día (medianoche o las 9 en Cumulus). Estación accesible pasa a no cuando la fuente no responde, cuando Cumulus MX indica que su estación ya no envía datos, cuando realtime.txt indica la pérdida de contacto con los sensores, o tras 15 minutos sin medición nueva. Última medición cuenta según el reloj de Gladys.

Widget​

Estación meteorológica muestra las condiciones actuales: mosaicos en directo (temperatura, humedad, viento, lluvia de hoy, presión, los que mide la estación), luego la sensación térmica, el viento con su dirección y ráfagas, la lluvia, el índice UV, la consola interior y una batería baja, y desde cuándo llegó la última medición. Los valores siguen su preferencia métrica o imperial. El ajuste Mostrar los detalles oculta la lista bajo los mosaicos.

Disparadores de escena​

  • Empieza a llover: la estación mide lluvia tras al menos 30 minutos sin ella. Una vez por episodio de lluvia, sean cuales sean los chubascos intermedios. Variable: nombre de la estación.
  • Deja de llover: sin lluvia durante el tiempo elegido (15, 30, 60 o 120 minutos), tras haber llovido. Una vez por periodo seco. Variables: lluvia de hoy (mm), nombre de la estación.
  • Ráfaga de viento fuerte: una ráfaga por encima de la velocidad elegida (30 a 120 km/h), la primera en 30 minutos. Variables: ráfaga (km/h), nombre de la estación.
  • Estación sin datos: ninguna medición nueva durante el tiempo elegido (5 a 120 minutos): el programa, la estación o la red están caídos. Una vez por silencio. Variables: minutos sin medición, nombre de la estación.

Tras un reinicio de la integración, la primera medición sirve de referencia: una lluvia ya en curso o un viento ya fuerte no dispara nada.

Acción de escena​

Condiciones actuales devuelve las últimas mediciones en una frase lista para un mensaje — por ejemplo 12,4 °C, sensación 10 °C, humedad 81 %, viento SO 15 km/h, ráfagas 32 km/h. — y en valores: temperatura, humedad, viento medio, ráfagas, lluvia de hoy, está lloviendo, minutos desde la medición. La frase sigue el idioma de la configuración.

Ejemplos de escenas​

  • Mensaje de la mañana: a las 7, Condiciones actuales, luego enviar un mensaje Tiempo en casa: {{summary}}.
  • Recoger el toldo: Ráfaga de viento fuerte por encima de 50 km/h → cerrar el toldo y enviar un mensaje con la ráfaga.
  • Ropa tendida: Empieza a llover → enviar un mensaje «recoja la ropa».
  • Riego: Deja de llover desde hace 120 minutos, con la condición «Lluvia de hoy inferior a 2 mm» → iniciar el riego.
  • Vigilancia de la estación: Estación sin datos desde hace 60 minutos → enviar un mensaje.

Actualización y uso de datos​

  • La propia integración lee la fuente en el intervalo elegido. Los estados van a Gladys como máximo cada 15 segundos, y solo los que cambiaron. Los disparadores ven cada medición nueva.
  • Cumulus MX responde en directo; los archivos solo cambian cuando el programa los reescribe (su intervalo de tiempo real): leerlos más a menudo no sirve de nada.
  • Un valor que no cambia se vuelve a enviar cada 6 horas, para que Gladys nunca lo muestre como caducado.
  • Nada sale de su red local.

Solución de problemas​

  • Ninguna estación en la pestaña Descubrimiento: todavía no se ha leído nada. Pulse Comprobar la fuente.
  • «Cumulus MX no responde»: dirección o puerto erróneos, Cumulus MX detenido, o su estación aún no iniciada (Cumulus MX responde entonces 503). No use localhost.
  • «Esta dirección no responde como Cumulus MX»: la dirección apunta a otro programa, o la fuente elegida no es la correcta.
  • «El archivo no es un realtime.txt de Cumulus» (o clientraw.txt): la dirección muestra una página web, una página de error u otro archivo. Ábrala en un navegador.
  • Estación accesible se queda en no con un archivo: el archivo ya no se reescribe (compruebe el envío en tiempo real del programa), o su fecha tiene más de 15 minutos.
  • Estación sin datos se dispara demasiado con un archivo: el archivo solo se reescribe en el intervalo de tiempo real del programa; elija un tiempo más largo.
  • Registros: ajuste LOG_LEVEL=debug en el contenedor para el detalle de cada ciclo.

Límites​

  • Una fuente, es decir una estación, por integración.
  • Los sensores adicionales (temperaturas adicionales, suelo, hoja, rayos, calidad del aire…) aún no se leen.
  • realtime.txt y clientraw.txt no llevan el estado de las baterías; clientraw.txt no tiene ni sensación térmica ni tendencia de presión.
  • Las fechas de los archivos se leen en la zona horaria de Gladys: el programa debe funcionar en la misma.
  • Desarrollada sin el hardware ni un Cumulus MX en funcionamiento.

Parámetros de configuración​

Estos son los parámetros que Cumulus & Weather Display te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
Conectar la estaciónsectionNoElija qué se lee. Cumulus MX: su interfaz en el puerto 8998, en directo. realtime.txt: el archivo que escribe Cumulus 1 o MX. clientraw.txt: el archivo de Weather Display. Un archivo se lee en la dirección del servidor web que lo sirve.
FuenteselectNo
DirecciónstringNoCumulus MX: la dirección de su interfaz. Un archivo: su dirección completa.
Intervalo de lectura (s)numberNoCumulus MX lee la estación cada pocos segundos; los archivos se reescriben en su intervalo de tiempo real.
Idioma de los textosselectNoNombres de las funciones de la estación al añadirla, frases de escenas y mensajes de las acciones.

Cómo instalar Cumulus & Weather Display en Gladys​

  1. En Gladys, abre Integraciones: Cumulus & Weather Display 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-cumulus: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).
  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-cumulus.

Cumulus & Weather Display 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​

Cumulus & Weather Display 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 🙂