Intégration domotique PEGELONLINE, gratuite et open source

Hauteurs d'eau des voies navigables allemandes (Rhin, Elbe, Danube…), par PEGELONLINE.

• Publiée par guim31
• Appareils
• Version 1.0.0
• Nécessite Gladys >=5.1.0
• ★ 0

Voir sur GitHubToutes les intégrations

Apporte dans Gladys les hauteurs d'eau des voies navigables fédérales allemandes (Rhin, Elbe, Danube, Moselle, Main, Weser, Oder, les canaux et la côte : environ 800 stations), depuis PEGELONLINE, le service de données ouvertes de la Wasserstraßen- und Schifffahrtsverwaltung des Bundes (WSV). Sans compte, sans clé.

Des valeurs brutes, pas un service d'alerte crues. Les données peuvent être en retard, manquantes ou fausses, et l'intégration dépend de votre Gladys, de votre accès à Internet et d'un service public. En cas de crue, suivez les alertes officielles (service d'annonce des crues du Land, votre commune, 112). Cette intégration est non affiliée à la WSV.

Ce que vous obtenez

• Un appareil par station suivie : la hauteur d'eau (en cm, comme sur pegelonline.wsv.de), le débit en m³/s, les températures de l'eau et de l'air quand la station les mesure, l'état du niveau (faible, normal, élevé) et le niveau de navigation (sous ou au-dessus de la hauteur maximale de navigation, HSW) quand la station a ces références, et la date de la dernière mesure.
• Une station qui n'envoie plus rien est signalée (« Pas de nouvelle mesure depuis… ») : une ancienne valeur n'est jamais renvoyée comme si elle était fraîche.
• Quatre déclencheurs de scène : l'état change (faible, normal, élevé), un niveau de référence est franchi (niveau moyen, hautes eaux moyennes, cotes de crue I et II du Rhin…), la hauteur dépasse la hauteur maximale de navigation, puis repasse en dessous.
• Un widget de tableau de bord : vos stations, leur hauteur, sa tendance (monte, stable, baisse) et leur état.
• Un bouton « Chercher des stations » qui liste les stations autour de votre maison, par nom, par cours d'eau ou par numéro, avec leur hauteur actuelle.

Prérequis

• Gladys Assistant 5.1.0 ou plus récent.
• Un accès à Internet depuis Gladys : l'intégration lit www.pegelonline.wsv.de.
• Pour « Autour de ma maison » : la position de votre maison dans Gladys (Paramètres, Maisons). L'intégration la demande à l'installation (permission « localisation »). Elle ne sert que dans le conteneur, à trouver les stations les plus proches : jamais envoyée à PEGELONLINE (qui voit seulement quelles stations voisines sont demandées), jamais enregistrée ni écrite dans les logs.
• Allemagne seulement : PEGELONLINE couvre les voies navigables fédérales, pas les petits cours d'eau suivis par les Länder.

Configuration

Réglages

Réglage	Effet
Stations	Numéros ou noms de stations, séparés par des virgules : 2730010, Kaub, Passau Donau. L'adresse de la page d'une station marche aussi.
Autour de ma maison	Suit aussi les 3 stations les plus proches qui envoient des mesures, à 10, 20 ou 50 km de votre maison.
Fréquence de mise à jour	15, 20 ou 30 minutes. Une seule requête couvre toutes les stations.
Langue des noms de fonctionnalités	Noms des fonctionnalités des nouveaux appareils (Hauteur d'eau, Débit…), et langue du texte « Dernière mesure » et des variables de scène.

Enregistrez, puis ouvrez l'onglet Découverte de l'intégration et créez les appareils voulus. Une station suivie le reste tant que son appareil existe, même retirée de la configuration.

Trouver vos stations

Cliquez sur « Chercher des stations » dans la configuration. Laissez le champ vide pour lister les stations autour de votre maison (20 km, ou la distance choisie), ou tapez :

• un nom de station : Köln, Koeln ou KÖLN (casse, accents et trémas ignorés) ;
• un cours d'eau : Rhein, Mosel, Elbe (les 10 plus proches, ou les 10 premières dans l'ordre du cours d'eau) ;
• les deux : Rhein Bonn ;
• un numéro de station : 2730010.

Chaque ligne donne le numéro, le nom, le cours d'eau et son point kilométrique, la distance à votre maison et la hauteur actuelle, ou « pas de mesure récente ». Copiez les numéros dans « Stations », puis enregistrez.

Appareils

Fonctionnalité	Type dans Gladys	Valeur
Hauteur d'eau	Profondeur du liquide (cm)	Hauteur au-dessus du zéro de l'échelle, en cm ; en m pour les rares stations rapportées à une altitude.
Débit (m³/s)	Débit d'eau	En m³/s (Gladys n'a pas d'unité m³/s : le nom le dit).
Température de l'eau	Température (°C)	Quand la station la mesure.
Température de l'air	Température (°C)	Quand la station la mesure.
État du niveau d'eau (MNW/MHW)	État du niveau	Faible sous les basses eaux moyennes (MNW), Élevé au-dessus des hautes eaux moyennes (MHW), Normal entre les deux.
Niveau de navigation (HSW)	État du niveau	Élevé au-dessus de la hauteur maximale de navigation (HSW), Normal en dessous.
Dernière mesure	Texte	Date de la dernière mesure, ou « Pas de nouvelle mesure depuis… ».

Une fonctionnalité n'existe que si la station la fournit. La hauteur d'eau n'est pas une profondeur : c'est la lecture de l'échelle, au-dessus de son propre zéro. Comparez-la aux niveaux de référence de la même station (visibles sur sa page PEGELONLINE), pas à une autre station. Les paramètres de l'appareil contiennent l'uuid de la station, son numéro, son cours d'eau et son point kilométrique.

La hauteur, le débit et les températures sont des fonctionnalités numériques : les scènes de Gladys savent déjà les comparer à une valeur de votre choix (« Hauteur d'eau au-dessus de 650 cm »).

Widget de tableau de bord

Ajoutez le widget PEGELONLINE à un tableau de bord.

• Sans réglage : une ligne par station suivie (10 au plus) avec sa hauteur et sa tendance, colorée selon son état : bleu faible, vert normal, rouge élevé ou au-dessus du niveau de navigation, gris sans état ou sans mesure récente. Un titre nomme les stations en hautes eaux.
• Avec une station choisie : sa hauteur, son débit et la température de l'eau en direct, puis son état, son niveau de navigation, sa tendance et sa dernière mesure, et un lien vers sa page PEGELONLINE.

Déclencheurs de scène

Déclencheur	Filtres	Variables
L'état du niveau d'eau change	Station, nouvel état (faible, normal, élevé)	Nom de la station, cours d'eau, hauteur, unité, état, état précédent (code et en toutes lettres)
Niveau de référence franchi	Station, niveau, sens (passe au-dessus, repasse en dessous)	Nom de la station, cours d'eau, hauteur, unité, code et nom du niveau, sa valeur, sens
Au-dessus de la hauteur maximale de navigation	Station	Nom de la station, cours d'eau, hauteur, unité, HSW
Repasse sous la hauteur maximale de navigation	Station	Nom de la station, cours d'eau, hauteur, unité, HSW

Les niveaux proposés : NNW (plus basses eaux connues), MNW (basses eaux moyennes), MW (niveau moyen), MHW (hautes eaux moyennes), cotes de crue I et II (Rhin : navigation restreinte, puis arrêtée) et HHW (plus hautes eaux connues). Une station ne déclenche que les niveaux qu'elle a. La descente compte quand la hauteur est 2 cm sous le niveau, et seulement alors une nouvelle montée peut compter : une hauteur qui oscille autour d'un niveau ne déclenche qu'une fois. Les états viennent de PEGELONLINE lui-même.

Les déclencheurs ne partent que pour un appareil créé, sur une mesure fraîche, et pas après un redémarrage de plus d'un jour.

Exemples de scènes

• Crue du Rhin : « Niveau de référence franchi », station Köln, niveau « Cote de crue I », passe au-dessus → envoyer un message : « {{station_name}} : {{height}} {{unit}}, au-dessus de la {{mark_name}} ».
• Surveillance de la cave : « L'état du niveau d'eau change », votre station, nouvel état Élevé → allumer la prise de la pompe et prévenir la famille.
• Sortie en bateau : « Au-dessus de la hauteur maximale de navigation », station Kaub → message « Navigation arrêtée : {{river}} » ; « Repasse sous la hauteur maximale de navigation » → « Navigation rouverte ».
• Basses eaux : « L'état du niveau d'eau change », nouvel état Faible → un rappel pour vérifier les amarres.

Sources, licence et quotas

• Données : PEGELONLINE, Wasserstraßen- und Schifffahrtsverwaltung des Bundes (WSV), licence DL-DE->Zero-2.0 (usage libre, sans obligation de citer ; le widget cite quand même la source).
• Les valeurs sont des données brutes, publiées avant tout contrôle par la WSV : elles peuvent être corrigées ensuite.
• Sans compte, sans clé, sans quota documenté. L'intégration reste légère : une requête par mise à jour pour toutes les stations suivies (15 minutes par défaut, le pas de mesure), et la liste des stations (environ 300 ko) une fois par semaine, seulement si des noms, des numéros ou « Autour de ma maison » en ont besoin.

Dépannage

• « Station inconnue » : vérifiez l'orthographe ou utilisez « Chercher des stations », puis copiez le numéro.
• « PEGELONLINE ne répond pas » : le service ou votre accès à Internet est coupé ; les valeurs reviennent d'elles-mêmes.
• « Autour de ma maison » n'ajoute rien : donnez une position à votre maison (Paramètres, Maisons), ou choisissez une distance plus grande : les stations allemandes peuvent être éloignées.
• Pas d'état ni de niveau de navigation : la station n'a pas de référence MNW/MHW ou HSW (lacs, retenues, beaucoup de stations à marée).
• « Pas de nouvelle mesure depuis… » : la station envoie en retard ou plus du tout ; certaines envoient leurs valeurs par lots, avec quelques heures de retard.
• Logs : dans Gladys, les logs de l'intégration ; LOG_LEVEL=debug montre chaque cycle.

Limites

• Aucun matériel nécessaire ; testée sur le vrai service et sur des réponses enregistrées, mais pas encore dans une vraie installation Gladys : vos retours sont les bienvenus.
• Voies navigables fédérales seulement : aucune station des services des Länder (par exemple les centres de prévision des crues de Bavière ou du Bade-Wurtemberg).
• Pas de prévisions : PEGELONLINE ne publie que des mesures.
• 20 stations au plus depuis la configuration (plus celles dont vous avez créé l'appareil).
• Les noms des fonctionnalités sont figés à la création de l'appareil : changer la langue ensuite ne change que les textes envoyés après.

Paramètres de configuration

Voici les paramètres demandés par PEGELONLINE dans son écran de configuration dans Gladys.

Paramètre	Type	Obligatoire	Description
Vos stations	section	Non	Suivez les stations de mesure des voies navigables fédérales allemandes : par numéro ou par nom, ou les plus proches de votre maison. « Chercher des stations » ci-dessous les liste avec leur cours d'eau et leur niveau actuel. Enregistrez, puis créez les appareils dans l'onglet Découverte.
Sources et limites	section	Non	Données : PEGELONLINE, Wasserstraßen- und Schifffahrtsverwaltung des Bundes (WSV), licence DL-DE->Zero-2.0, lues sans compte. Des valeurs brutes, pas un service d'alerte crues : les alertes officielles priment. Non affiliée à la WSV.
Stations	string	Non	Numéros ou noms de stations, séparés par des virgules.
Autour de ma maison	select	Non	Suivre aussi les 3 stations les plus proches qui envoient des mesures, à cette distance au plus de la position de votre maison dans Gladys.
Fréquence de mise à jour	select	Non	Les stations envoient une mesure toutes les 15 minutes, certaines toutes les heures. Une seule requête couvre toutes les stations.
Langue des noms de fonctionnalités	select	Non	Noms donnés aux fonctionnalités des nouveaux appareils (Hauteur d'eau, Débit…), et langue de leurs textes et des variables de scène.

Comment installer PEGELONLINE dans Gladys

1. Dans Gladys, ouvrez Intégrations : PEGELONLINE apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/guim31/gladys-pegelonline: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).
3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-pegelonline.

PEGELONLINE 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

PEGELONLINE 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

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂