Aller au contenu principal

Intégration domotique Raspberry Shake, gratuite et open source

Intégration Raspberry Shake pour Gladys Assistant

Votre sismographe Raspberry Shake : niveau de vibration, détection de secousses, état de la station.

Votre sismographe personnel Raspberry Shake dans Gladys : le niveau de vibration du sol chez vous, minute par minute, la détection des secousses avec leur crête et leur durée, et l'état en ligne de la station. Fonctionne avec tous les modèles de Shake (1D, 3D, 4D, RS&BOOM).

Deux sources, utilisées ensemble :

  • la sortie UDP du Shake (Datacast), envoyée directement à Gladys sur votre réseau local : les échantillons en direct, à partir desquels Gladys calcule le niveau de vibration (RSAM), la crête et un déclencheur STA/LTA ;
  • les données publiques du réseau Raspberry Shake (AM), si votre Shake partage ses données : la station envoie-t-elle encore, même sans la sortie UDP.

Ce n'est pas un système d'alerte précoce : un sismographe domestique sent aussi les pas, les portes, la machine à laver et les camions, et la détection dit que le sol a bougé, pas qu'un séisme a eu lieu. Pour les séismes signalés par les sismologues près de chez vous, voir l'intégration EMSC Earthquakes.

Développée sans le matériel : vos retours sont les bienvenus. L'analyse a été testée sur un vrai enregistrement d'une station publique (le séisme de magnitude 3,7 des Pyrénées du 3 août 2026, à 5 km de la station AM.R6881), rejoué au format UDP du Shake ; aucun Shake physique n'a été branché. Non affiliée à Raspberry Shake, S.A.

Ce que vous obtenez​

  • Un appareil Raspberry Shake par station : état en ligne et dernière donnée reçue ; avec la sortie UDP, niveau de vibration (RSAM, en counts), amplitude crête (en counts) et secousse détectée, avec leur historique.
  • Un widget de tableau de bord : état de la station, niveau de vibration et crête en direct, et courbe du niveau de vibration sur la dernière journée.
  • Trois déclencheurs de scène : secousse détectée, retour au calme (avec la crête et la durée), station hors ligne.
  • Une action Vérifier la station maintenant dans l'écran de configuration.

Prérequis​

  • Gladys Assistant 5.2 ou plus récent (l'intégration publie un port UDP via un sous-conteneur).
  • Un Raspberry Shake sur le même réseau que Gladys, pour la sortie UDP.
  • Un accès Internet depuis la machine Gladys pour l'état en ligne (data.raspberryshake.org, HTTPS).

Configuration​

Station et sortie UDP​

  1. Trouvez le code de votre station : sur la page web de votre Shake (http://rs.local, ou son adresse), ou sur la carte des stations. Il ressemble à R1A2B (réseau AM).
  2. Dans Gladys, Intégrations → Raspberry Shake → Configuration, saisissez le code et enregistrez.
  3. Le haut de l'écran de configuration affiche l'adresse et le port UDP choisis par Gladys pour l'intégration (par exemple 192.168.1.20, port 40123). Sur la page web du Shake, ouvrez Settings → Datacast, ajoutez cette adresse comme hôte cible et ce port comme port cible, puis enregistrez et redémarrez le producteur de données comme le Shake le demande.
  4. Créez l'appareil dans l'onglet Découverte.

Le Shake envoie ses échantillons environ quatre fois par seconde et par canal : quelques kilo-octets par seconde sur votre réseau local. Le port est choisi par Gladys et conservé : le Shake ne se règle qu'une fois. Si votre Shake reçoit son adresse de votre box, une adresse fixe (réservation DHCP) permet de remplir Adresse du Shake : les paquets de tout autre appareil sont alors ignorés.

Réglages​

RéglageDéfautSignification
Code de la stationvideR1A2B ou AM.R1A2B, majuscules ou minuscules.
Utiliser la sortie UDPactivéDésactivé : état en ligne et dernière donnée seulement, par les données publiques.
Adresse du ShakevideAdresse IPv4 facultative : les paquets UDP d'une autre adresse sont ignorés.
Détection des secoussesNormaleRapport STA/LTA qui déclenche une détection : faible 6, normale 4, élevée 3.
Hors ligne après1 heureDurée sans donnée avant que la station soit hors ligne (1, 2 ou 6 heures).
Langue des textesFrançaisNoms des fonctionnalités (à leur création) et dates.

Appareil​

FonctionnalitéTypeSignification
Station en lignebinaireDonnées reçues à temps : UDP dans les 2 dernières minutes, ou données publiques récentes.
Dernière donnéetexteDate et heure de la dernière donnée reçue (mise à jour toutes les 10 minutes).
Niveau de vibration (RSAM)nombre, countsAmplitude absolue moyenne sur chaque minute, décalage retiré.
Amplitude crêtenombre, countsPlus grande amplitude absolue de chaque minute.
Secousse détectéecapteur de vibration1 du déclenchement jusqu'à 10 secondes de calme.

Les trois dernières demandent la sortie UDP. Les valeurs sont en counts, l'unité brute du Shake : comparez-les au niveau habituel de votre station (la station de l'enregistrement lisait environ 900 counts avant le séisme de magnitude 3,7, à 5 km, qui a culminé à 1,16 million). Le géophone vertical (EHZ) est utilisé, sinon le premier canal sismique reçu ; le canal infrason d'un Boom est ignoré.

La détection compare l'amplitude moyenne sur 1 seconde à la moyenne sur 30 secondes (STA/LTA), le déclencheur classique de la sismologie : elle démarre au rapport choisi et se termine après 10 secondes sous 1,5 (2 en sensibilité faible). La moyenne longue demande 30 secondes de données après un démarrage ou une coupure.

Widget de tableau de bord​

Ajoutez le widget Raspberry Shake à un tableau de bord : nom de la station, niveau de vibration et crête en direct, courbe du niveau de vibration sur 24 heures (masquable dans les réglages du widget), et un bloc d'état (en ligne, dernière donnée, sol calme ou secousse, paquets UDP de la dernière minute). Sans la sortie UDP, seul le bloc d'état est affiché.

Déclencheurs de scène​

  • Secousse détectée : le déclencheur s'est activé. Variables : le code de la station et le rapport STA/LTA.
  • Retour au calme : la secousse est terminée. Variables : la station, l'amplitude crête (counts) et la durée (secondes). La crête permet de distinguer un pas d'un séisme dans une condition de scène.
  • Station hors ligne : la station était en ligne et aucune donnée n'est arrivée dans le délai configuré. Variables : la station et la date de la dernière donnée.

La fonctionnalité Secousse détectée de l'appareil peut aussi servir de déclencheur d'appareil classique.

Exemples de scènes​

  • Quand Retour au calme se déclenche, si la crête dépasse largement votre niveau habituel, envoyez-vous un message avec la crête et la durée.
  • Quand Station hors ligne se déclenche, envoyez un message : le Shake a peut-être perdu son alimentation ou son réseau.
  • Chaque soir, lisez le niveau de vibration de la journée sur la courbe pour voir la circulation, le vent et l'activité de la maison.

Sources des données, conditions et quotas​

  • Sortie UDP : les échantillons ne quittent jamais votre réseau local ; rien n'est stocké, l'analyse se fait en mémoire.
  • Données publiques : les services web FDSN de Raspberry Shake (https://data.raspberryshake.org/fdsnws/), gratuits et sans compte, pour les stations qui partagent leurs données. L'intégration ne lit que les en-têtes de quelques kilo-octets de données toutes les 10 minutes (une fenêtre courte, puis des sondages étroits plus anciens quand la station se tait). L'archive a environ 30 minutes de retard sur le temps réel, d'où le minimum d'une heure avant « hors ligne ». Citation du réseau : Raspberry Shake, S.A. (2016), Raspberry Shake [Data set], International Federation of Digital Seismograph Networks, https://doi.org/10.7914/SN/AM.

Dépannage​

  • « Aucune donnée UDP du Shake » : vérifiez la cible Datacast (l'adresse et le port affichés dans l'écran de configuration, pas le port 8888), que le producteur de données a bien redémarré, et qu'aucun pare-feu de la machine Gladys ne bloque l'UDP entrant. Si une adresse du Shake est indiquée, vérifiez-la : les logs disent une fois quelle adresse a été ignorée.
  • « La station n'est pas sur le réseau Raspberry Shake » : le code est faux, ou le Shake ne partage pas ses données. La sortie UDP fonctionne quand même.
  • Beaucoup de détections : les pas et les portes près du Shake déclenchent en sensibilité élevée : choisissez normale ou faible, ou posez le Shake au sol d'une pièce calme.
  • L'écran de configuration affiche {{port:shake_udp}} : le récepteur n'a pas encore démarré ; rechargez la page après quelques secondes.
  • Logs : Intégrations → Raspberry Shake → Supervision ; LOG_LEVEL=debug affiche chaque minute et chaque détection.

Limites​

  • Une station par Gladys. Les counts ne sont pas convertis en vitesse du sol, et aucune magnitude n'est calculée : un sismographe domestique seul ne peut pas localiser un séisme.
  • La détection est un simple déclencheur STA/LTA sur un canal, sans filtre : elle dit que le sol a tremblé près du Shake, quelle qu'en soit la cause.
  • L'état en ligne sans UDP demande une station qui partage ses données sur le réseau, et arrive avec 30 minutes de retard environ.

Paramètres de configuration​

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

ParamètreTypeObligatoireDescription
Connectez votre Raspberry ShakesectionNonSaisissez ci-dessous le code de votre station. Pour les données en direct, ouvrez la page web de votre Shake (rs.local), Settings, Datacast, et ajoutez l'hôte {{gladys_host}}, port {{port:shake_udp}} (choisi par Gladys). Sans cela, seul l'état en ligne est suivi, par les données publiques du réseau.
Code de la stationstringOuiAffiché sur la page web de votre Shake et sur la carte des stations, ex. R1A2B.
Utiliser la sortie UDPbooleanNonNiveau de vibration, crête et détection de secousses, calculés dans Gladys à partir des échantillons en direct.
Adresse du Shake (facultatif)stringNonSi elle est indiquée, les paquets UDP venant d'une autre adresse sont ignorés.
Détection des secoussesselectNonSeuil du déclencheur STA/LTA : élevée attrape aussi les pas et les portes près du Shake.
Hors ligne aprèsselectNonSans UDP, les données publiques du réseau arrivent avec 30 minutes de retard environ.
Langue des noms et des textesselectNonNoms des fonctionnalités (fixés à l'ajout de l'appareil) et dates.

Comment installer Raspberry Shake dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Raspberry Shake 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-raspberry-shake: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-raspberry-shake.

Raspberry Shake 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​

Raspberry Shake 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.

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 🙂