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

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:
| Campo | Qué introducir |
|---|---|
| Fuente | Cumulus MX (API), archivo realtime.txt (Cumulus) o archivo clientraw.txt (Weather Display). |
| Dirección | Cumulus 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 textos | Nombres 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ón | Unidad | Tag Cumulus MX / campo realtime.txt / campo clientraw.txt |
|---|---|---|
| Temperatura | °C | temp / 3 / 4 |
| Sensación térmica | °C | feelslike / 59 / — |
| Punto de rocío | °C | dew / 5 / 72 |
| Humedad | % | hum / 4 / 5 |
| Temperatura interior | °C | intemp / 23 / 12 |
| Humedad interior | % | inhum / 24 / 13 |
| Presión (nivel del mar) | hPa | press / 11 / 6 |
| Tendencia de presión (3 h) | hPa | presstrendval × 3 / 19 × 3 / — |
| Viento medio / Ráfagas | km/h | wspeed, wgust / 6, 41 / 1, 2 |
| Dirección del viento | ° | avgbearing / 47 / 3 |
| Intensidad de lluvia | mm/h | rrate / 9 / 10 × 60 |
| Lluvia de hoy | mm | rfall / 10 / 7 |
| Está lloviendo | sí/no | IsRaining, o una intensidad de lluvia distinta de cero |
| Índice UV | UV / 44 / 79 | |
| Radiación solar (W/m²) | SolarRad / 46 / 127 | |
| Batería baja | sí/no | LowBatteryList no vacío (solo Cumulus MX) |
| Estación accesible | sí/no | la fuente responde y hay una medición nueva en 15 minutos |
| Última medición | min | minutos 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=debugen 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ámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Conectar la estación | section | No | Elija 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. |
| Fuente | select | No | |
| Dirección | string | No | Cumulus MX: la dirección de su interfaz. Un archivo: su dirección completa. |
| Intervalo de lectura (s) | number | No | Cumulus MX lee la estación cada pocos segundos; los archivos se reescriben en su intervalo de tiempo real. |
| Idioma de los textos | select | No | Nombres 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
- En Gladys, abre Integraciones: Cumulus & Weather Display 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/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). - 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/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.
- 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