Zum Hauptinhalt springen

Raspberry Shake Smart-Home-Integration, kostenlos und Open Source

Raspberry Shake-Integration für Gladys Assistant

Dein Raspberry-Shake-Seismograf: Vibrationspegel, Erkennung von Erschütterungen, Stationsstatus.

Dein persönlicher Raspberry Shake Seismograf in Gladys: der Vibrationspegel des Bodens bei dir zu Hause, Minute für Minute, die Erkennung von Erschütterungen mit ihrer Spitze und Dauer, und der Online-Status der Station. Funktioniert mit allen Shake-Modellen (1D, 3D, 4D, RS&BOOM).

Zwei Quellen, gemeinsam genutzt:

  • die UDP-Ausgabe des Shake (Datacast), direkt im lokalen Netz an Gladys gesendet: die Live-Werte, aus denen Gladys den Vibrationspegel (RSAM), die Spitze und einen STA/LTA-Auslöser berechnet;
  • die öffentlichen Daten des Raspberry-Shake-Netzes (AM), wenn dein Shake seine Daten teilt: Sendet die Station noch, auch ohne UDP-Ausgabe?

Es ist kein Frühwarnsystem: Ein Seismograf zu Hause spürt auch Schritte, Türen, Waschmaschinen und Lastwagen, und die Erkennung sagt, dass sich der Boden bewegt hat, nicht dass ein Erdbeben stattfand. Für die von Seismologen gemeldeten Erdbeben in deiner Nähe gibt es die Integration EMSC Earthquakes.

Ohne die Hardware entwickelt: Rückmeldungen willkommen. Die Analyse wurde mit einer echten Aufzeichnung einer öffentlichen Station getestet (das Erdbeben der Magnitude 3,7 in den Pyrenäen am 3. August 2026, 5 km von der Station AM.R6881), im UDP-Format des Shake abgespielt; es war kein echter Shake angeschlossen. Nicht mit Raspberry Shake verbunden (Raspberry Shake, S.A.).

Was du bekommst​

  • Ein Gerät Raspberry Shake pro Station: Online-Status und letzte empfangene Daten; mit der UDP-Ausgabe Vibrationspegel (RSAM, Counts), Spitzenamplitude (Counts) und erkannte Erschütterung, mit Verlauf.
  • Ein Dashboard-Widget: Stationsstatus, Vibrationspegel und Spitze live, und der Vibrationspegel des letzten Tages als Kurve.
  • Drei Szenen-Auslöser: Erschütterung erkannt, wieder ruhig (mit Spitze und Dauer), Station offline.
  • Eine Aktion Station jetzt prüfen im Konfigurationsbildschirm.

Voraussetzungen​

  • Gladys Assistant 5.2 oder neuer (die Integration veröffentlicht einen UDP-Port über einen Unter-Container).
  • Ein Raspberry Shake im selben Netz wie Gladys, für die UDP-Ausgabe.
  • Internetzugang vom Gladys-Rechner für den Online-Status (data.raspberryshake.org, HTTPS).

Konfiguration​

Station und UDP-Ausgabe​

  1. Finde den Code deiner Station: auf der Webseite deines Shake (http://rs.local oder seine Adresse) oder auf der Stationskarte. Er sieht aus wie R1A2B (Netz AM).
  2. In Gladys, Integrationen → Raspberry Shake → Konfiguration, den Code eingeben und speichern.
  3. Oben im Konfigurationsbildschirm stehen die Adresse und der UDP-Port, die Gladys für die Integration gewählt hat (zum Beispiel 192.168.1.20, Port 40123). Öffne auf der Webseite des Shake Settings → Datacast, füge diese Adresse als Ziel-Host und diesen Port als Ziel-Port hinzu, speichere und starte den Datenproduzenten neu, wie der Shake es verlangt.
  4. Lege das Gerät im Reiter Entdecken an.

Der Shake sendet seine Werte etwa viermal pro Sekunde und Kanal: einige Kilobyte pro Sekunde im lokalen Netz. Der Port wird von Gladys gewählt und beibehalten: Der Shake wird nur einmal eingerichtet. Bekommt dein Shake seine Adresse vom Router, erlaubt eine feste Adresse (DHCP-Reservierung), Adresse des Shake auszufüllen: Pakete anderer Geräte werden dann ignoriert.

Einstellungen​

EinstellungStandardBedeutung
StationscodeleerR1A2B oder AM.R1A2B, Groß- oder Kleinschreibung.
UDP-Ausgabe nutzenanAus: nur Online-Status und letzte Daten, über die öffentlichen Daten des Netzes.
Adresse des ShakeleerOptionale IPv4-Adresse: UDP-Pakete anderer Adressen werden ignoriert.
Erkennung von ErschütterungenNormalSTA/LTA-Verhältnis, das eine Erkennung startet: niedrig 6, normal 4, hoch 3.
Offline nach1 StundeZeit ohne Daten, bis die Station offline ist (1, 2 oder 6 Stunden).
Sprache der TexteFranzösischNamen der Funktionen (bei ihrer Erstellung) und Datumsangaben.

Gerät​

FunktionTypBedeutung
Station onlinebinärDaten rechtzeitig empfangen: UDP in den letzten 2 Minuten oder aktuelle öffentliche Daten.
Letzte DatenTextDatum und Uhrzeit der letzten empfangenen Daten (alle 10 Minuten aktualisiert).
Vibrationspegel (RSAM)Zahl, CountsMittlere absolute Amplitude jeder Minute, ohne Offset.
SpitzenamplitudeZahl, CountsGrößte absolute Amplitude jeder Minute.
Erschütterung erkanntVibrationssensor1 vom Auslösen bis zu 10 Sekunden Ruhe.

Die letzten drei brauchen die UDP-Ausgabe. Die Werte sind in Counts, der Rohdateneinheit des Shake: Vergleiche sie mit dem üblichen Pegel deiner Station (die Station der Aufzeichnung lag bei etwa 900 Counts vor dem Erdbeben der Magnitude 3,7 in 5 km Entfernung, das 1,16 Millionen erreichte). Genutzt wird das vertikale Geofon (EHZ), sonst der erste empfangene seismische Kanal; der Infraschallkanal eines Boom wird ignoriert.

Die Erkennung vergleicht die mittlere Amplitude über 1 Sekunde mit dem Mittel über 30 Sekunden (STA/LTA), der klassische Auslöser der Seismologie: Die Erkennung beginnt beim gewählten Verhältnis und endet nach 10 Sekunden unter 1,5 (2 bei niedriger Empfindlichkeit). Das Langzeitmittel braucht 30 Sekunden Daten nach einem Start oder einer Unterbrechung.

Dashboard-Widget​

Füge das Widget Raspberry Shake zu einem Dashboard hinzu: Name der Station, Vibrationspegel und Spitze live, eine 24-Stunden-Kurve des Vibrationspegels (in den Widget-Einstellungen ausblendbar) und ein Statusblock (online, letzte Daten, Boden ruhig oder Erschütterung, UDP-Pakete der letzten Minute). Ohne UDP-Ausgabe wird nur der Statusblock gezeigt.

Szenen-Auslöser​

  • Erschütterung erkannt: Der Auslöser hat angesprochen. Variablen: der Stationscode und das STA/LTA-Verhältnis.
  • Wieder ruhig: Die Erschütterung ist vorbei. Variablen: die Station, die Spitzenamplitude (Counts) und die Dauer (Sekunden). Mit der Spitze unterscheidest du in einer Szenenbedingung einen Schritt von einem Erdbeben.
  • Station offline: Die Station war online und in der eingestellten Zeit kamen keine Daten. Variablen: die Station und das Datum der letzten Daten.

Die Gerätefunktion Erschütterung erkannt taugt auch als normaler Geräte-Auslöser.

Szenenbeispiele​

  • Wenn Wieder ruhig auslöst und die Spitze deinen üblichen Pegel deutlich übersteigt, schick dir eine Nachricht mit Spitze und Dauer.
  • Wenn Station offline auslöst, schick eine Nachricht: Der Shake hat vielleicht Strom oder Netz verloren.
  • Lies jeden Abend den Vibrationspegel des Tages auf der Kurve ab, um Verkehr, Wind und die Aktivität im Haus zu sehen.

Datenquellen, Bedingungen und Kontingente​

  • UDP-Ausgabe: Die Werte verlassen nie dein lokales Netz; nichts wird gespeichert, die Analyse läuft im Speicher.
  • Öffentliche Daten: die FDSN-Webdienste von Raspberry Shake (https://data.raspberryshake.org/fdsnws/), kostenlos und ohne Konto, für Stationen, die ihre Daten teilen. Die Integration liest nur die Header einiger Kilobyte Daten alle 10 Minuten (ein kurzes Fenster, dann schmale Proben weiter zurück, wenn die Station schweigt). Das Archiv hängt etwa 30 Minuten hinter der Echtzeit, daher das Minimum von einer Stunde bis offline. Zitat des Netzes: Raspberry Shake, S.A. (2016), Raspberry Shake [Data set], International Federation of Digital Seismograph Networks, https://doi.org/10.7914/SN/AM.

Fehlerbehebung​

  • „Keine UDP-Daten vom Shake“: Prüfe das Datacast-Ziel (Adresse und Port aus dem Konfigurationsbildschirm, nicht Port 8888), dass der Datenproduzent neu gestartet wurde und dass keine Firewall auf dem Gladys-Rechner eingehendes UDP blockiert. Ist eine Adresse des Shake gesetzt, prüfe sie: Die Protokolle nennen einmal die ignorierte Adresse.
  • „Station ist nicht im Raspberry-Shake-Netz“: Der Code ist falsch oder der Shake teilt seine Daten nicht. Die UDP-Ausgabe funktioniert trotzdem.
  • Viele Erkennungen: Schritte und Türen nahe am Shake lösen bei hoher Empfindlichkeit aus: Wähle normal oder niedrig, oder stell den Shake auf den Boden eines ruhigen Raums.
  • Der Konfigurationsbildschirm zeigt {{port:shake_udp}}: Der Empfänger ist noch nicht gestartet; lade die Seite nach einigen Sekunden neu.
  • Protokolle: Integrationen → Raspberry Shake → Überwachung; LOG_LEVEL=debug zeigt jede Minute und jede Erkennung.

Grenzen​

  • Eine Station pro Gladys. Die Counts werden nicht in Bodengeschwindigkeit umgerechnet und es wird keine Magnitude berechnet: Ein einzelner Seismograf zu Hause kann ein Erdbeben nicht orten.
  • Die Erkennung ist ein einfacher STA/LTA-Auslöser auf einem Kanal, ohne Filter: Der Auslöser sagt, dass der Boden nahe am Shake gebebt hat, egal warum.
  • Der Online-Status ohne UDP braucht eine Station, die ihre Daten im Netz teilt, und kommt etwa 30 Minuten verspätet.

Konfigurationseinstellungen​

Diese Einstellungen fragt Raspberry Shake in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Verbinde deinen Raspberry ShakesectionNeinGib unten den Code deiner Station ein. Für Live-Daten öffne die Webseite deines Shake (rs.local), Settings, Datacast, und füge den Host {{gladys_host}} mit Port {{port:shake_udp}} hinzu (von Gladys gewählt). Ohne das wird nur der Online-Status über die öffentlichen Daten des Netzes verfolgt.
StationscodestringJaSteht auf der Webseite deines Shake und auf der Stationskarte, z. B. R1A2B.
UDP-Ausgabe nutzenbooleanNeinVibrationspegel, Spitze und Erkennung von Erschütterungen, in Gladys aus den Live-Werten berechnet.
Adresse des Shake (optional)stringNeinWenn gesetzt, werden UDP-Pakete von anderen Adressen ignoriert.
Erkennung von ErschütterungenselectNeinSchwelle des STA/LTA-Auslösers: Hoch erfasst auch Schritte und Türen nahe am Shake.
Offline nachselectNeinOhne UDP kommen die öffentlichen Daten des Netzes etwa 30 Minuten verspätet an.
Sprache der Namen und TexteselectNeinNamen der Funktionen (beim Hinzufügen festgelegt) und Datumsangaben.

So installierst du Raspberry Shake in Gladys​

  1. Öffne in Gladys Integrationen: Raspberry Shake erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-raspberry-shake:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-raspberry-shake.

Raspberry Shake benötigt Gladys >=5.2.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen​

Raspberry Shake ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂