Zum Hauptinhalt springen

Stookwijzer Smart-Home-Integration, kostenlos und Open Source

Stookwijzer-Integration für Gladys Assistant

Holzfeuer-Rat des RIVM (gelb, orange, rot) für dein Haus in den Niederlanden.

Auf GitHub ansehenAlle Integrationen

Der Stookwijzer des RIVM (des niederländischen Reichsinstituts für Volksgesundheit und Umwelt) sagt für jedes vierstellige Postleitzahlgebiet der Niederlande, ob ein Holzofen, ein Kamin, ein Terrassenofen oder eine Feuerschale gerade die Nachbarschaft stört. Diese Integration bringt diesen Rat für jedes deiner Häuser nach Gladys: ein Gerät mit dem aktuellen Rat und dem der nächsten Zeitblöcke, dem Wind und dem Luftqualitätsindex, ein Dashboard-Widget und Szenenauslöser.

Der Stookwijzer deckt nur die Niederlande ab. Anderswo hat die Integration nichts anzuzeigen und sagt das. Die Integration ist nicht mit dem RIVM verbunden.

Was du bekommst​

  • Ein Stookwijzer-Gerät pro Gladys-Haus in den Niederlanden.
  • Den Rat in drei Codes, so wie das RIVM sie gibt:
    • Gelb: „Achtung: Holz verbrennen belästigt und verschmutzt die Luft“ (Windstärke 3 oder mehr und LKI 3 oder weniger);
    • Orange: „Besser jetzt kein Holz verbrennen“ (Windstärke 3 oder mehr und LKI 4, 5 oder 6);
    • Rot: „Verbrenne kein Holz“ (Windstärke 2 oder weniger, oder LKI 7 oder mehr).
  • Den Rat der nächsten drei 6-Stunden-Blöcke (04:00-10:00, 10:00-16:00, 16:00-22:00 und 22:00-04:00, niederländische Zeit).
  • Die Windgeschwindigkeit (m/s), die Windstärke (Beaufort) und den Luftqualitätsindex (LKI, 1 bis 11), auf denen der Rat beruht.
  • Ein Dashboard-Widget und drei Szenenauslöser.

Einen Code Grün gibt es nicht: Kein Holz zu verbrennen ist immer der beste Rat für eine gesunde Umwelt, deshalb hat das RIVM ihn bewusst weggelassen.

Voraussetzungen​

  • Gladys Assistant 5.1 oder neuer.
  • Ein Haus mit einem Standort in Gladys (Einstellungen, Zuhause, die Karte des Hauses), in den Niederlanden. Die Integration bittet bei der Installation um Zugriff auf den Standort deiner Häuser: Er dient nur dazu, das Postleitzahlgebiet zu finden, und nur der umgerechnete Punkt geht an das RIVM.
  • Internetzugang von Gladys zu data.rivm.nl. Kein Konto, kein Schlüssel.

Konfiguration​

  1. Installiere die Integration und erlaube den Zugriff auf den Standort deiner Häuser.
  2. Wähle in Konfiguration die Sprache der Funktionsnamen, des Ratstextes und der Szenenvariablen (standardmäßig Französisch). Die Namen werden beim Anlegen des Geräts festgelegt: Wähle zuerst die Sprache.
  3. Öffne den Tab Entdecken: Für jedes Haus in den Niederlanden erscheint ein Gerät „Stookwijzer Haus“. Füge es zu Gladys hinzu.

Ein später in Gladys hinzugefügter oder geänderter Standort wird bei der nächsten stündlichen Abfrage neu gelesen, oder sofort mit dem Knopf Scannen im Tab „Entdecken“.

Geräte​

Jedes Gerät „Stookwijzer Haus“ hat acht Funktionen, alle nur lesbar:

FunktionTypWerte
Aktueller RatRisikostufe1 gelb, 2 orange, 3 rot
RatText„Orange — Besser jetzt...“
Rat nächster ZeitblockRisikostufe1 gelb, 2 orange, 3 rot
Rat in 2 ZeitblöckenRisikostufe1 gelb, 2 orange, 3 rot
Rat in 3 ZeitblöckenRisikostufe1 gelb, 2 orange, 3 rot
WindgeschwindigkeitGeschwindigkeit0 bis 60 m/s
Windstärke (Beaufort)Geschwindigkeit0 bis 12
Luftqualitätsindex (LKI)Luftqualitätsindex1 bis 11

Gladys beschriftet die Risikostufen mit „Niedrig“, „Mittel“ und „Hoch“: Diese stehen für Gelb, Orange und Rot. „Kein Risiko“ (0) wird nie verwendet. Der Rat des aktuellen und des nächsten Blocks ist endgültig; die beiden danach sind vorläufig und können sich bis 6 Stunden vor ihrem Beginn noch ändern.

Die Werte werden einmal pro Stunde gelesen. Nur geänderte Werte gehen an Gladys, dazu alle 12 Stunden alle Werte, damit das Dashboard nie „kein aktueller Wert“ zeigt.

Dashboard-Widget​

Füge das Widget Stookwijzer zu einem Dashboard hinzu. Es zeigt den Rat des aktuellen Blocks in Worten, die Windstärke und den LKI als Live-Kacheln, eine Liste des aktuellen und der drei nächsten Blöcke mit ihrer Farbe (vorläufige sind markiert), das Postleitzahlgebiet und einen Knopf zur offiziellen Stookwijzer-Seite. Wähle in seinen Einstellungen das Haus; leer gelassen, wird das erste Stookwijzer-Gerät gezeigt.

Szenenauslöser​

Im Szeneneditor, unter der Integration:

  • Stookwijzer: Code Rot (kein Holzfeuer): Der aktuelle Rat für das Haus wird rot.
  • Stookwijzer: Code Rot ist vorbei: Der aktuelle Rat ist wieder gelb oder orange. Mit dem Filter „Neuer Rat“ kannst du nur einen der beiden behalten.
  • Stookwijzer: Code Rot im nächsten Zeitblock angekündigt: Der nächste Block ist sicher rot (endgültiger Rat), obwohl er jetzt nicht rot ist. Einmal pro Block, etwa 6 Stunden vorher.

Jeder Auslöser lässt sich auf ein Haus beschränken. Die folgenden Aktionen können {{triggerEvent.data.advice_text}}, starts_at und ends_at (die Uhrzeiten des Blocks, in der Zeitzone von Gladys), postcode, wind_force und lki verwenden.

Ein Auslöser feuert nie bei der allerersten Abfrage eines Hauses, und nach einem Neustart der Integration nicht erneut für denselben Rat. Das Gerät muss in Gladys hinzugefügt sein, damit seine Auslöser feuern.

Szenenbeispiele​

  • Vor dem Anheizen warnen: Auslöser „Code Rot im nächsten Zeitblock angekündigt“, Aktion „Nachricht senden“: „Code Rot ab {{triggerEvent.data.starts_at}}: Verbrenne kein Holz.“
  • Erinnerung am Abend: um 18:00, wenn „Aktueller Rat“ des Hauses 3 (Hoch) ist, sende „Stookwijzer: Heize heute Abend nicht mit Holz.“
  • Zurück zur Normalität: Auslöser „Code Rot ist vorbei“, Filter „Gelb“, schalte den roten LED-Streifen aus, der die Warnung anzeigte.

Datenquellen und Kontingente​

Der Rat stammt aus dem offenen Geodienst des RIVM (data.rivm.nl/geo/alo, Ebene stookwijzer_v2), denselben Daten wie die Stookwijzer-Seite des Atlas Leefomgeving. Die Integration fragt einmal pro Stunde und Haus, was reicht: Der Rat ändert sich pro 6-Stunden-Block. Wind und LKI sind Modellrechnungen (KNMI, RIVM), pro Block gemittelt: Beide können von den Messungen und dem Wind bei dir abweichen.

Fehlerbehebung​

  • Kein Gerät in „Entdecken“: Gib deinem Haus in Gladys einen Standort in den Niederlanden und drücke dann Scannen. Der Status im Konfigurationsbildschirm sagt warum: kein Haus mit Standort oder Häuser außerhalb der Niederlande.
  • „Der Geodienst des RIVM antwortet nicht“: Der letzte Rat bleibt sichtbar; die Integration versucht es alle 10 Minuten erneut.
  • Die Funktionsnamen sind in der falschen Sprache: Diese werden beim Anlegen festgelegt. Ändere die Sprache, lösche das Gerät und füge es erneut hinzu (sein Verlauf geht verloren).
  • Für Details setze LOG_LEVEL=debug und lies die Logs der Integration.

Grenzen​

  • Nur die Niederlande; der Rat ist der des vierstelligen Postleitzahlgebiets des Hauses.
  • Mit den echten RIVM-Daten entwickelt und getestet, aber am Tag der Entwicklung ohne orangen oder roten Rat: Diese Fälle sind mit veränderten Aufzeichnungen getestet. Rückmeldungen willkommen.
  • Der Stookwijzer ist ein Rat. Manche Gemeinden verbieten Holzfeuer bei Code Orange oder Rot: Prüfe die Regeln vor Ort.
  • Nicht mit dem RIVM verbunden.

Konfigurationseinstellungen​

Diese Einstellungen fragt Stookwijzer in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Holzfeuer-Rat für dein HaussectionNeinDer Stookwijzer des RIVM sagt pro Postleitzahl, ob ein Ofen oder Kamin gerade die Nachbarn stört: gelb, orange oder rot. Gib deinem Haus einen Standort in Gladys und füge dann sein Gerät im Tab „Entdecken“ hinzu.
Quellen und GrenzensectionNeinDaten: offener Geodienst des RIVM (Stookwijzer-Ebene), stündlich ohne Konto gelesen. Nur die Niederlande. Der Rat beruht auf Modellrechnungen und kann von den Bedingungen vor Ort abweichen. Nicht mit dem RIVM verbunden.
Sprache der Namen und TexteselectNeinNamen der Funktionen (beim Anlegen des Geräts festgelegt), Text des Rats und Szenenvariablen.

So installierst du Stookwijzer in Gladys​

  1. Öffne in Gladys Integrationen: Stookwijzer 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-stookwijzer: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-stookwijzer.

Stookwijzer benötigt Gladys >=5.1.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​

Stookwijzer 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 🙂
Zuletzt aktualisiert am