Intégration domotique BfS ODL, gratuite et open source

Le débit de dose gamma ambiant des 1 700 sondes ODL du BfS allemand, chaque heure.
Ce que fait l’intégration
Amène dans Gladys le débit de dose gamma ambiant mesuré par les sondes du réseau ODL de l’Office fédéral allemand de radioprotection (Bundesamt für Strahlenschutz, BfS) : environ 1 700 sondes dans toute l’Allemagne, une valeur par heure. L’intégration lit le service de données ouvertes du BfS, les mêmes données que la carte ODL-Info, sans compte ni clé.
Pour chaque sonde suivie : le débit de dose, ses parts cosmique et terrestre, l’heure et l’état de la mesure, un widget de tableau de bord avec la courbe sur 24 heures, et des déclencheurs de scène quand le débit franchit un seuil d’alerte.
Cette intégration n’est pas un dispositif d’alerte officiel : en cas d’urgence, suivez les consignes des autorités. Les niveaux naturels varient : la pluie rabat au sol les descendants du radon et peut ajouter jusqu’à 0,1 µSv/h pendant quelques heures. L’intégration n’est pas affiliée au BfS. Données : Bundesamt für Strahlenschutz (BfS), gratuites, source citée.
La même intégration pour la France : Téléray (réseau de l’ASNR).
Prérequis
- Gladys 5.3.0 ou plus récent.
- Un accès à Internet depuis Gladys.
- La position de votre maison (Paramètres → Maisons), pour suivre automatiquement la sonde la plus proche.
Configuration
- Installez l’intégration : Intégrations → Installer depuis GitHub, adresse
https://github.com/guim31/gladys-odl. - Sondes : laissez vide pour suivre la sonde la plus proche de votre maison, ou saisissez jusqu’à 5
identifiants de sonde (9 chiffres), noms ou codes postaux séparés par des virgules (ex.
091620001, 80637, Feldberg). Un code postal donne sa sonde en service la plus basse. Deux boutons aident : Trouver les sondes autour d’une maison liste les plus proches avec leur identifiant et leur distance, Chercher des sondes liste celles d’un code postal (ou de ses premiers chiffres) ou dont le nom contient un texte. - Seuil d’alerte : le débit qui déclenche « Débit de dose au-dessus du seuil », 0,3 µSv/h par défaut (voir Scènes).
- Langue : langue des noms de fonctionnalités (fixés à l’ajout d’un appareil) et des textes.
- Ouvrez l’onglet Découverte et ajoutez la sonde.
Appareils
Un appareil par sonde, à son nom (ex. München-Neuhausen (ODL)) :
| Fonctionnalité | Ce que c’est |
|---|---|
| Débit de dose (µSv/h) | débit de dose gamma ambiant de la dernière heure, en microsieverts par heure |
| Part cosmique (µSv/h) | la part du rayonnement cosmique, estimée par le BfS (elle croît avec l’altitude) |
| Part terrestre (µSv/h) | le reste : rayonnement du sol et de l’air (radon), la part qui varie |
| Heure de la mesure | fin de l’heure de mesure (le BfS la publie 60 à 90 minutes plus tard) |
| État de la sonde | Mesure contrôlée, Pas encore contrôlée, Sonde en test, Sonde hors service, Pas de mesure récente |
Gladys n’a pas d’unité de rayonnement : l’unité est dans le nom des fonctionnalités. Une mesure de plus de 4 heures n’est pas publiée comme actuelle (l’état indique alors « Pas de mesure récente »). Une sonde hors service ne publie aucune valeur.
Widget
Débit de dose ODL : le débit et ses parts cosmique et terrestre en tuiles (le débit passe au rouge au seuil d’alerte), la courbe des 24 dernières heures, puis l’heure, l’état, le seuil et la source. Réglages : la sonde (vide : la première ajoutée), et deux interrupteurs pour masquer la courbe ou les lignes en dessous.
Scènes
- Déclencheur Débit de dose au-dessus du seuil : le débit horaire d’une sonde en service atteint le seuil d’alerte de la configuration, contrôlé ou pas encore (mieux vaut une alerte rapide qu’une alerte tardive). Déclenché une fois, au franchissement ; le seuil reste franchi tant que le débit ne repasse pas 0,02 µSv/h en dessous. Jamais au premier regard sur une sonde, ni pour une sonde en test. Variables : nom de la sonde, débit, seuil, fin de l’heure de mesure.
- Déclencheur Débit de dose revenu à la normale : après un dépassement, le débit est de nouveau à au moins 0,02 µSv/h sous le seuil.
- Action Obtenir le débit de dose d’une sonde : les dernières valeurs et une phrase toute faite (
summary) pour une notification ;statusvautchecked,not_checked,test_operation,defectiveouno_recent.
Le seuil par défaut, 0,3 µSv/h, est prudent : en Allemagne, les niveaux naturels se situent entre 0,05 et 0,18 µSv/h (médiane d’environ 0,11), jusqu’à 0,25 µSv/h environ en haut d’une montagne, et une forte pluie peut ajouter jusqu’à 0,1 µSv/h pendant quelques heures. 0,3 µSv/h n’est donc que rarement atteint sans cause réelle ; 0,2 µSv/h se déclenchera sous la pluie sur certaines sondes. Les appareils donnent aussi leurs valeurs aux conditions de scène habituelles, pour un seuil à vous.
Exemples de scènes
- Me prévenir quand le débit est élevé : déclencheur « Débit de dose au-dessus du seuil », puis « Obtenir le débit de dose d’une sonde » et une notification avec son résumé.
- Un relevé hebdomadaire : une scène planifiée, « Obtenir le débit de dose d’une sonde », puis un message avec le résumé.
Dépannage
- « Aucune sonde » : renseignez la position d’une maison (Paramètres → Maisons) ou saisissez une sonde dans la configuration.
- « Sondes inconnues » : l’identifiant, le nom ou le code postal est introuvable ; utilisez les boutons de recherche et copiez l’identifiant.
- « Le BfS ne répond pas » : les mesures sont relues toutes les 20 minutes.
- « Pas de mesure récente » : la sonde n’a rien publié depuis 4 heures (maintenance, transmission). Les valeurs reviennent avec sa mesure suivante.
- « Sonde hors service » : le BfS signale la sonde défectueuse ; choisissez une voisine en attendant sa réparation.
Limites
- Une valeur par heure, publiée 60 à 90 minutes après son heure : l’intégration lit toutes les 20 minutes (une requête pour toutes les sondes suivies), et la liste des sondes une fois par jour.
- 5 sondes au plus.
- Les parts cosmique et terrestre sont des estimations du BfS ; certaines sondes ne les fournissent pas.
- Les mesures Safecast ne sont pas incluses (suite possible).
- Les noms des fonctionnalités sont fixés à l’ajout de l’appareil ; changer la langue ensuite ne les renomme pas.
Paramètres de configuration
Voici les paramètres demandés par BfS ODL dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Sondes ODL | section | Non | Lit le service de données ouvertes de l’Office fédéral allemand de radioprotection (sans compte). Données © BfS. Ce n’est pas un dispositif d’alerte officiel, ni une intégration du BfS. |
| Sondes | string | Non | Identifiants, noms ou codes postaux des sondes à suivre, séparés par des virgules, 5 au plus. Vide : la sonde la plus proche de votre maison. Les boutons ci-dessous les listent. |
| Seuil d’alerte | select | Non | Débit de dose qui déclenche « Débit de dose au-dessus du seuil ». Niveaux naturels : 0,05 à 0,18 µSv/h, jusqu’à 0,25 en montagne ; la pluie peut ajouter 0,1 pendant quelques heures. |
| Langue | select | Non | Langue des noms de fonctionnalités (fixés à l’ajout d’un appareil), des textes d’état et des textes de scène. |
Comment installer BfS ODL dans Gladys
- Dans Gladys, ouvrez Intégrations : BfS ODL 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-odl: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-odl.
BfS ODL nécessite Gladys >=5.3.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
BfS ODL 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