Intégration domotique openSenseMap, gratuite et open source
Les mesures des boîtes de capteurs citoyens openSenseMap (senseBox), la vôtre ou voisines.
Publiée par guim31
- Appareils
- Version 1.0.0
- Nécessite Gladys >=5.2.0
- ★ 0
Les mesures des boîtes de capteurs citoyens d'openSenseMap (senseBox, airRohr et boîtes personnalisées) : votre propre boîte, ou les boîtes publiques autour de chez vous.
Cette intégration n'est pas affiliée à openSenseMap, ni à openSenseLab, ni à senseBox.
Ce que fait l'intégration
- Lit les boîtes publiques d'openSenseMap par leur identifiant, sans compte ni clé.
- Crée un appareil par boîte, avec une fonctionnalité par capteur qu'elle connaît : température, humidité, pression, PM2.5, PM10, PM1, CO2, COV, bruit, luminosité, indice UV, vitesse du vent, intensité de pluie, humidité et température du sol.
- Indique l'âge de la dernière mesure de chaque boîte : une boîte muette est signalée, ses anciennes valeurs ne sont pas renvoyées.
- Ajoute un widget Mesures d'une boîte, deux déclencheurs de scène Boîte hors ligne et Boîte de retour en ligne, et une action de scène Obtenir les mesures d'une boîte.
Lecture seule : l'intégration ne modifie jamais rien sur une boîte.
Prérequis
- Gladys Assistant 5.2.0 ou plus récent.
- Un accès à Internet (l'API publique d'openSenseMap).
- Pour la recherche autour de la maison : la position de votre maison, dans Paramètres → Maisons. L'intégration demande l'accès aux coordonnées de la maison à l'installation ; elle ne s'en sert que pour cette recherche.
Configuration
Choisir les boîtes
Chaque boîte a un identifiant de 24 caractères, visible dans son adresse sur la
carte : https://opensensemap.org/explore/5cd81adfff898b001ae7c4c6. Deux
façons de le trouver :
- Cliquez sur Trouver les boîtes autour d'une maison, choisissez la maison et un rayon : le résultat liste les boîtes qui ont mesuré ces dernières 24 heures, de la plus proche à la plus loin, avec leur distance et leurs mesures. Copiez les identifiants voulus.
- Ou ouvrez la carte, cliquez sur une boîte et copiez la fin de l'adresse (le lien entier est accepté aussi).
Collez les identifiants dans Identifiants des boîtes, séparés par des virgules (20 boîtes au plus), et enregistrez. Les boîtes apparaissent alors dans l'onglet Découverte de l'intégration : ajoutez à Gladys celles que vous voulez.
Autres réglages
- Relevé : toutes les 5 minutes par défaut (10, 15 ou 30 minutes au choix). openSenseMap est un service gratuit tenu par une association : 5 minutes au plus vite.
- Langue : la langue des noms de fonctionnalités (fixés à l'ajout d'un appareil) et des textes de scène. Français par défaut.
Vérifier les boîtes lit toutes les boîtes tout de suite et indique, pour chacune, l'âge de sa dernière mesure, les mesures publiées et les capteurs laissés de côté.
Appareils
Un appareil par boîte, au nom de la boîte (Saint-Simon Station (openSenseMap)).
Ses fonctionnalités sont les capteurs de la boîte que l'intégration connaît :
| Mesure | Unité dans Gladys | Remarques |
|---|---|---|
| Température | °C | |
| Humidité | % | |
| Pression | hPa | convertie depuis les Pa si besoin |
| PM2.5, PM10, PM1 | µg/m³ | PM1 est une fonctionnalité PM2.5 nommée « PM1 » |
| CO2 | ppm | |
| COV | ppb | seulement si la boîte envoie des ppb |
| Bruit | dB | |
| Luminosité | lx | |
| Indice UV | indice UV | seulement un vrai indice UV, pas des µW/cm² |
| Vitesse du vent | km/h | convertie depuis les m/s si besoin ; rafales aussi |
| Intensité de pluie | mm/h | |
| Humidité du sol | % | |
| Température du sol | °C | |
| Âge de la mesure | minutes | depuis la dernière mesure de la boîte |
Les propriétaires nomment leurs capteurs librement (« Temperatur », « Temp ~ Air », « CO₂ »…) : l'intégration reconnaît une mesure à son unité et à son titre. Quand une boîte mesure deux fois la même chose, la seconde fonctionnalité porte le titre du propriétaire, par exemple « Température (Lufttemperatur) ».
Une valeur est publiée tant qu'elle a moins d'une heure. Au-delà, la boîte est affichée hors ligne et seul l'Âge de la mesure continue d'avancer.
Widget
Mesures d'une boîte : avec une boîte choisie dans ses réglages, jusqu'à six tuiles en direct (une par mesure) et l'heure de la dernière mesure, en rouge quand la boîte est hors ligne. Sans boîte : une ligne par boîte, avec l'ancienneté de sa dernière mesure.
Scènes
Déclencheur : Boîte hors ligne
Se déclenche une fois quand une boîte n'a rien envoyé depuis la durée choisie : 1, 3, 6, 12, 24 ou 48 heures. Laissez Boîte vide pour surveiller toutes les boîtes. Variables : le nom de la boîte, les minutes sans mesure, l'heure de la dernière mesure (UTC).
L'intégration ne déclare une boîte hors ligne qu'après une réponse réussie d'openSenseMap : une panne du service n'est pas une boîte hors ligne. Une boîte déjà muette quand vous l'ajoutez ne déclenche rien.
Déclencheur : Boîte de retour en ligne
Se déclenche quand une boîte signalée hors ligne mesure de nouveau. Variables : le nom de la boîte et le nombre de minutes de silence.
Action : Obtenir les mesures d'une boîte
Donne les dernières valeurs d'une boîte aux actions suivantes : un résumé prêt à l'emploi (« Saint-Simon Station (openSenseMap): Température 17,8 °C · Humidité 99,9 % · il y a 3 min »), l'âge de la mesure en minutes, et la température, l'humidité, la pression, les PM2.5 et PM10 quand la boîte les mesure et qu'ils sont récents.
Exemples de scènes
- Me prévenir quand ma boîte s'arrête : déclencheur Boîte hors ligne, boîte « Ma senseBox », 6 heures → envoyer le message « Ma senseBox n'a rien envoyé depuis 6 heures : vérifiez son alimentation et son Wi-Fi. »
- Bulletin du matin : tous les jours à 7 h → Obtenir les mesures d'une
boîte → envoyer le message
{{summary}}. - Aérer la pièce : quand la fonctionnalité CO2 d'une boîte intérieure dépasse 1 200 ppm → envoyer la notification « Aérez la salle de classe ».
Dépannage
- Aucun appareil dans l'onglet Découverte : vérifiez les identifiants avec Vérifier les boîtes. « Boîte inconnue d'openSenseMap » signale un identifiant erroné.
- Une boîte n'affiche aucune valeur : elle n'a pas mesuré depuis plus d'une heure (voir l'Âge de la mesure), ou ses capteurs sont d'un type laissé de côté (listés par Vérifier les boîtes).
- « L'API d'openSenseMap ne répond pas » : le service est en panne ou injoignable depuis Gladys ; les relevés reprennent d'eux-mêmes.
- Un nom de fonctionnalité est dans la mauvaise langue : les noms sont fixés à l'ajout de l'appareil. Changez la Langue, supprimez l'appareil et ajoutez-le de nouveau depuis l'onglet Découverte (son historique est perdu).
Limites
- Des capteurs citoyens, pas des stations de référence : les capteurs de particules bon marché surestiment par air humide, un capteur au soleil lit trop chaud. Les valeurs sont indicatives.
- Laissés de côté : les UV en µW/cm² (pas d'unité Gladys, pas de conversion fiable), les PM4, les COV en kOhm, la direction du vent et les cumuls de pluie. Vérifier les boîtes les liste pour chaque boîte. La recherche autour de la maison ignore les boîtes mobiles (vélos).
- Une fonctionnalité n'est jamais retirée : un capteur ôté d'une boîte garde sa fonctionnalité, sans nouvelle valeur.
- 20 boîtes au plus, chacune lue toutes les 5 minutes au plus.
Paramètres de configuration
Voici les paramètres demandés par openSenseMap dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Boîtes openSenseMap | section | Non | Lisez des boîtes publiques openSenseMap (sans compte) par leur identifiant, visible dans l'adresse de la boîte sur la carte. Non affilié à openSenseMap ni à senseBox. |
| Identifiants des boîtes | string | Non | Les identifiants des boîtes à lire (24 caractères, ou le lien de la boîte), séparés par des virgules, 20 au plus. Le bouton « Trouver les boîtes autour d'une maison » ci-dessous liste celles qui vous entourent. |
| Relevé | select | Non | La fréquence de lecture de chaque boîte. openSenseMap est un service gratuit : 5 minutes au plus vite. |
| Langue | select | Non | Langue des noms de fonctionnalités (fixés à l'ajout d'un appareil) et des textes de scène. |
Comment installer openSenseMap dans Gladys
- Dans Gladys, ouvrez Intégrations : openSenseMap 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-opensensemap: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-opensensemap.
openSenseMap nécessite Gladys >=5.2.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
openSenseMap 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