Intégration domotique Cumulus & Weather Display, gratuite et open source

Votre station météo dans Gladys via Cumulus MX ou Weather Display, quelle que soit sa marque.
Amène votre station météo dans Gladys via Cumulus MX (ou Cumulus 1) ou Weather Display, quelle que soit sa marque (Davis, Ecowitt, Fine Offset, Oregon Scientific, La Crosse…) : température, humidité, pression et sa tendance, vent, pluie, UV, rayonnement solaire et plus, tels que le logiciel les mesure.
Développée sans le matériel : vos retours sont les bienvenus. L'intégration suit le code source de Cumulus MX, la documentation de realtime.txt du wiki Cumulus et un vrai clientraw.txt d'une station Weather Display en ligne, mais elle n'a pas encore été essayée avec un vrai Cumulus MX. Vos retours sont les bienvenus sur le dépôt GitHub.
Cette intégration n'est affiliée ni à Cumulus (Sandaysoft) ni à Weather Display.
Présentation
L'intégration lit l'une de trois sources, sur votre réseau local :
- Cumulus MX (API) : l'interface de Cumulus MX, sur le port 8998, en direct. Recommandé avec Cumulus MX.
- realtime.txt : le fichier d'une ligne que Cumulus 1 et Cumulus MX écrivent à leur intervalle temps réel, servi par un serveur web.
- clientraw.txt : le fichier d'une ligne qu'écrit Weather Display, servi par un serveur web.
Vous obtenez un appareil Gladys pour la station, quatre déclencheurs de scène, une action de scène et un widget de tableau de bord. Tout est en lecture seule et reste sur votre réseau local : ni compte, ni cloud.
Les unités sont lues dans la source (°F, mph, nœuds, inHg, pouces…) : Gladys reçoit des °C, km/h, hPa et mm, et les convertit selon vos préférences quand il le peut.
Prérequis
- Gladys 5.1 ou plus récent.
- Cumulus MX, Cumulus 1 ou Weather Display, joignable par le réseau depuis Gladys.
Cumulus MX
Rien à installer : l'interface de Cumulus MX (http://adresse:8998) répond déjà. Sa station doit
être démarrée. Gladys fait tourner l'intégration dans un conteneur : localhost désigne le
conteneur lui-même, utilisez l'adresse de la machine où tourne Cumulus MX.
realtime.txt
Dans Cumulus, activez le fichier temps réel (Internet settings → Interval settings → Real time, puis le fichier realtime.txt dans la liste des fichiers temps réel) et faites-le copier dans un dossier servi par un serveur web. Ouvrez d'abord son adresse dans un navigateur : vous devez voir une ligne de nombres.
clientraw.txt
Dans Weather Display, activez la création de clientraw.txt (fichiers web personnalisés) et
faites-le servir par un serveur web. Ouvrez d'abord son adresse dans un navigateur : la ligne
commence par 12345.
Configuration
Dans Gladys, ouvrez Intégrations → Cumulus & Weather Display → Configuration :
| Champ | Ce qu'il faut saisir |
|---|---|
| Source | Cumulus MX (API), fichier realtime.txt (Cumulus) ou fichier clientraw.txt (Weather Display). |
| Adresse | Cumulus MX : http://adresse:8998. Un fichier : son adresse complète. utilisateur:mdp@ accepté. |
| Intervalle de lecture (s) | 30 par défaut, 10 au minimum. |
| Langue des textes | Noms des fonctionnalités (fixés à l'ajout de la station), phrase de scène et messages des actions. |
Enregistrez, puis cliquez sur Vérifier la source : le bouton indique si la source répond, quel logiciel et quelle version, et combien de valeurs elle a données. Ouvrez ensuite l'onglet Découverte et ajoutez la station.
L'appareil station
La station n'a que les fonctionnalités qu'elle mesure. Les deux fichiers texte écrivent 0 pour un capteur absent : intérieur, UV et rayonnement solaire n'apparaissent qu'après une valeur non nulle. Un capteur ajouté plus tard apparaît dans l'onglet Découverte, qui propose alors de mettre à jour l'appareil.
| Fonctionnalité | Unité | Tag Cumulus MX / champ realtime.txt / champ clientraw.txt |
|---|---|---|
| Température | °C | temp / 3 / 4 |
| Ressenti | °C | feelslike / 59 / — |
| Point de rosée | °C | dew / 5 / 72 |
| Humidité | % | hum / 4 / 5 |
| Température intérieure | °C | intemp / 23 / 12 |
| Humidité intérieure | % | inhum / 24 / 13 |
| Pression (niveau de la mer) | hPa | press / 11 / 6 |
| Tendance de pression (3 h) | hPa | presstrendval × 3 / 19 × 3 / — |
| Vent moyen / Rafales | km/h | wspeed, wgust / 6, 41 / 1, 2 |
| Direction du vent | ° | avgbearing / 47 / 3 |
| Intensité de pluie | mm/h | rrate / 9 / 10 × 60 |
| Pluie du jour | mm | rfall / 10 / 7 |
| Il pleut | oui/non | IsRaining, ou une intensité de pluie non nulle |
| Indice UV | UV / 44 / 79 | |
| Rayonnement solaire (W/m²) | SolarRad / 46 / 127 | |
| Batterie faible | oui/non | LowBatteryList non vide (Cumulus MX seulement) |
| Station joignable | oui/non | la source répond et une nouvelle mesure depuis 15 minutes |
| Dernière mesure | min | minutes depuis la dernière nouvelle mesure |
La Pluie du jour est celle du logiciel : depuis son heure de bascule (minuit ou 9 h dans Cumulus). Station joignable passe à non quand la source ne répond pas, quand Cumulus MX indique que sa station n'envoie plus de données, quand realtime.txt signale la perte de contact avec les capteurs, ou après 15 minutes sans nouvelle mesure. Dernière mesure compte selon l'horloge de Gladys.
Widget
Station météo affiche les conditions actuelles : des tuiles en direct (température, humidité, vent, pluie du jour, pression, celles que la station mesure), puis le ressenti, le vent avec sa direction et ses rafales, la pluie, l'indice UV, la console intérieure et une batterie faible, et depuis quand la dernière mesure est arrivée. Les valeurs suivent votre préférence métrique ou impériale. Le réglage Afficher le détail masque la liste sous les tuiles.
Déclencheurs de scène
- Il commence à pleuvoir : la station mesure de la pluie après au moins 30 minutes sans. Une fois par épisode de pluie, quelles que soient les averses entre-temps. Variable : nom de la station.
- La pluie s'arrête : plus de pluie depuis la durée choisie (15, 30, 60 ou 120 minutes), après de la pluie. Une fois par accalmie. Variables : pluie du jour (mm), nom de la station.
- Rafale de vent forte : une rafale au-delà de la vitesse choisie (30 à 120 km/h), la première depuis 30 minutes. Variables : rafale (km/h), nom de la station.
- Station muette : aucune nouvelle mesure depuis la durée choisie (5 à 120 minutes) : le logiciel, la station ou le réseau est en panne. Une fois par silence. Variables : minutes sans mesure, nom de la station.
Après un redémarrage de l'intégration, la première mesure sert de référence : une pluie déjà en cours ou un vent déjà fort ne déclenche rien.
Action de scène
Conditions actuelles renvoie les dernières mesures en une phrase prête pour un message — par
exemple 12,4 °C, ressenti 10 °C, humidité 81 %, vent SO 15 km/h, rafales 32 km/h. — et en
valeurs : température, humidité, vent moyen, rafales, pluie du jour, il pleut, minutes depuis la
mesure. La phrase suit la langue de la configuration.
Exemples de scènes
- Message du matin : à 7 h, Conditions actuelles, puis envoyer un message
Météo à la maison : {{summary}}. - Rentrer le store : Rafale de vent forte au-delà de 50 km/h → fermer le store et envoyer un message avec la rafale.
- Linge dehors : Il commence à pleuvoir → envoyer un message « rentre le linge ».
- Arrosage : La pluie s'arrête depuis 120 minutes, avec la condition « Pluie du jour inférieure à 2 mm » → lancer l'arrosage.
- Surveillance de la station : Station muette depuis 60 minutes → envoyer un message.
Rafraîchissement et données
- La source est lue à l'intervalle choisi par l'intégration elle-même. Les états partent vers Gladys au plus toutes les 15 secondes, et seulement ceux qui ont changé. Les déclencheurs voient chaque nouvelle mesure.
- Cumulus MX répond en direct ; les fichiers ne changent que lorsque le logiciel les réécrit (son intervalle temps réel) : les lire plus souvent ne sert à rien.
- Une valeur qui ne change pas est renvoyée toutes les 6 heures, pour que Gladys ne l'affiche jamais comme périmée.
- Rien ne sort de votre réseau local.
Dépannage
- Pas de station dans l'onglet Découverte : rien n'a encore été lu. Cliquez sur Vérifier la source.
- « Cumulus MX ne répond pas » : adresse ou port erronés, Cumulus MX arrêté, ou sa station pas
encore démarrée (Cumulus MX répond alors 503). N'utilisez pas
localhost. - « Cette adresse ne répond pas comme Cumulus MX » : l'adresse désigne un autre logiciel, ou la source choisie n'est pas la bonne.
- « Le fichier n'est pas un realtime.txt de Cumulus » (ou clientraw.txt) : l'adresse affiche une page web, une page d'erreur ou un autre fichier. Ouvrez-la dans un navigateur.
- Station joignable reste à non avec un fichier : le fichier n'est plus réécrit (vérifiez l'envoi temps réel du logiciel), ou sa date a plus de 15 minutes.
- Station muette se déclenche trop souvent avec un fichier : le fichier n'est réécrit qu'à l'intervalle temps réel du logiciel ; choisissez une durée plus longue.
- Journaux : réglez
LOG_LEVEL=debugsur le conteneur pour le détail de chaque cycle.
Limites
- Une source, donc une station, par intégration.
- Les capteurs supplémentaires (températures supplémentaires, sol, feuille, foudre, qualité de l'air…) ne sont pas encore lus.
- realtime.txt et clientraw.txt ne portent pas l'état des batteries ; clientraw.txt n'a ni ressenti ni tendance de pression.
- Les dates des fichiers sont lues dans le fuseau horaire de Gladys : le logiciel doit tourner dans le même.
- Développée sans le matériel ni un Cumulus MX en fonctionnement.
Paramètres de configuration
Voici les paramètres demandés par Cumulus & Weather Display dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Connecter la station | section | Non | Choisissez ce qui est lu. Cumulus MX : son interface sur le port 8998, en direct. realtime.txt : le fichier écrit par Cumulus 1 ou MX. clientraw.txt : le fichier de Weather Display. Un fichier se lit à l'adresse du serveur web qui le sert. |
| Source | select | Non | |
| Adresse | string | Non | Cumulus MX : l'adresse de son interface. Un fichier : son adresse complète. |
| Intervalle de lecture (s) | number | Non | Cumulus MX lit la station toutes les quelques secondes ; les fichiers sont réécrits à leur intervalle temps réel. |
| Langue des textes | select | Non | Noms des fonctionnalités de la station à son ajout, phrases des scènes et messages des actions. |
Comment installer Cumulus & Weather Display dans Gladys
- Dans Gladys, ouvrez Intégrations : Cumulus & Weather Display apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/guim31/gladys-cumulus:1.0.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-cumulus.
Cumulus & Weather Display nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
Cumulus & Weather Display est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation