WAIP-Web

🇩🇪 Deutsche Version dieser README

ioBroker-Adapter für Wachalarm IP-Web (WAIP-Web)

Verbindet sich über Socket.IO mit einem WAIP-Web-Dispatch-Monitor und spiegelt Vorfälle („Einsatz“), Rückmeldungen der Einsatzkräfte („Rückmeldungen“), Routen und TTS-Ansagen in ioBroker-Zustände – ohne dass ein Browser-Tab geöffnet bleiben muss.

Inhaltsverzeichnis

• info · Status · einsatzAktuell · einsatzAktuell.json · einsatzAktuell.tts · Dashboard · debug
• Änderungsprotokoll
• Lizenz

Über diesen Adapter

Dieser Adapter ist ein unabhängiges, von der Community entwickeltes Projekt und steht in keiner Verbindung zum WAIP-Web-Projekt, zu Robert-112 oder zum Betreiber einer bestimmten Instanz (z. B. der Integrierten Regionalleitstelle Lausitz). Er wurde durch Analyse des Verhaltens des Frontends entwickelt (client_waip.js ) dass eine WAIP-Web-Instanz öffentlich für jeden Browser bereitgestellt wird, um dieselben Socket.IO-Ereignisse und Datenfelder zu replizieren, die ein regulärer Browserclient empfängt.

Der Adapter stellt die Verbindung ohne Anmeldung her und empfängt daher ausschließlich die öffentlichen Berechtigungen von WAIP-Web (Schlüsselwort, Standort, ungefähre Position, gemeldete Ressourcen, Feedback) – dieselben Daten, die jeder anonyme Browserbesucher ohne Anmeldung sehen würde. Es werden keine Zugriffsbeschränkungen umgangen.

Hinweis: Ein permanent aktiver, automatisierter Client wie dieser Adapter unterscheidet sich von einem gelegentlich geöffneten Browsertab. Bevor Sie ihn in einer Produktionsumgebung einsetzen, klären Sie bitte kurz mit dem Betreiber/Ihrer Leitstelle ab, ob eine permanente automatisierte Verbindung erwünscht ist.

Über WAIP-Web

Wachalarm IP-Web ist eine Open-Source-Webanwendung von Robert-112 , die Einsatz- und Alarminformationen für Feuerwehren und Rettungsdienste geräteunabhängig im Browser anzeigt (Windows, Linux, Mac, Smartphone – keine Installation erforderlich). Sie bietet unter anderem folgende Funktionen:

• Alarmüberwachung – Vorfallart, Stichwort, Sondersignal, Standort, Karte, alarmierte Einsatzkräfte, App-basierte Rückmeldung an die Einsatzkräfte einschließlich Sprachansagen
• Dashboard – Übersicht aller laufenden Vorfälle
• Feedback-Funktion – App-basiertes Feedback der Einsatzkräfte, gruppiert nach Rolle (EK/GF/ZF/VF) und Zusatzqualifikation (AGT/FZF/MA/MED)
• Administration – Benutzerverwaltung, Stationsdaten, Monitorübersicht

WAIP-Web selbst ist unter der Creative Commons BY-SA 4.0- Lizenz lizenziert. Dieser Adapter enthält keinen Code aus dem WAIP-Web-Projekt; er implementiert einen unabhängigen Client für dessen Socket.IO-Schnittstelle.

Praktische Anwendungsfälle

In diesem Abschnitt geht es darum, was Sie mit den von diesem Adapter bereitgestellten Zuständen konkret realisieren können – typische Anwendung in einer Feuerwehrwache/einem Rettungsdienst:

• Wandmontiertes Alarmdisplay. BindeneinsatzAktuell.json.current auf einem VIS-Tabellen-Widget auf einem an der Wand montierten Tablet oder Fernseher im Aufenthaltsraum/Fahrzeughalle – Vorfallart, Stichwort, Adresse und alarmierte Ressourcen werden automatisch angezeigt, ohne dass jemand einen Browser-Tab auf diesem Bildschirm geöffnet halten muss (was der eigentliche Grund für die Existenz dieses Adapters ist).
• Schlüsselwörter in einfacher Sprache auf Anzeigen und Benachrichtigungen.einsatzAktuell.beschreibung wandelt einen kryptischen Dispatch-Code um (B:Wald groß/WSP ,R1N0 ) in eine lesbare Beschreibung umwandeln („Wald-/Getreidefeldbrand (groß)“, „Rettungswagen: 1, Notfalleinsatzfahrzeug: 0“) – daneben bindeneinsatzAktuell.stichwort auf dem Wanddisplay anzeigen oder in die Push-Benachrichtigung/TTS-Ansage aufnehmen, damit sich die Mitglieder nicht jedes einzelne Schlüsselwort merken müssen.
• Automatisierungen werden sofort nach Eingang eines Alarms ausgelöst. BeobachteneinsatzAktuell.alarmAktiv (oderinfo.connection zusammen damit) in einem Skript/einer Blockly-Regel, um die Beleuchtung in der Fahrzeughalle einzuschalten, ein Tor/eine Tür zu öffnen, eine Push-Benachrichtigung zu senden (z. B. über einen Telegram-/Pushover-Adapter) miteinsatzAktuell.stichwort /einsatzAktuell.beschreibung +einsatzAktuell.ort oder eine intelligente Lichtszene aufblitzen lassen – alles wenige Sekunden nach dem eigentlichen Pager-Alarm, kein Polling erforderlich, da ioBroker-Statusänderungen sofort ausgelöst werden.
• Den Alarm laut ausrufen.einsatzAktuell.tts.last ist eine sofort abspielbare, absolute MP3-URL; verweisen Sie auf asonos /snapcast /text2speech Nutzen Sie dafür eine Automatisierung (oder spielen Sie die URL direkt ab), um den Vorfall über die Lautsprecher im Gebäude bekannt zu geben, sobald er gemeldet wird.io.playtts Feuerstellen – nützlich dort, wo nicht alle Mitglieder auf einen Bildschirm schauen.
• Live-Teilnehmerzählung / Feedback-Anzeigetafel. DieeinsatzAktuell.rueckmeldungen.* Zähler (rollen.ek /.gf /.zf /.vf pro Rollefunktionen.agt /.fzf /.ma /.med (pro Qualifikation) Aktualisierung in Echtzeit, sobald die Einsatzkräfte über die App bestätigen – Verknüpfung mit Mess- oder Zahlen-Widgets für einen schnellen Überblick darüber, wer während des Einsatzes kommt.
• Nachbesprechung des Vorfalls / Statistik.einsatzAktuell.json.history Speichert die letzten N abgeschlossenen Vorfälle (konfigurierbar, Standard 10) als flache Tabelle – bindet sie an eine zweite VIS-Ansicht oder exportiert sie regelmäßig (z. B. über ein Skript, das den Status ausliest).io.standby ) um ein längerfristiges Protokoll zu führen oder die Anzahl der Vorfälle in ein Dashboard/einen Statistikadapter einzuspeisen.
• Routen-/Fahrzeugübersicht auf einer Karte.einsatzAktuell.json.routen trägt die jeder Einsatzstation.lat /lon Undcolor – Binden Sie es an ein VIS-Karten-Widget, um unabhängig von der WAIP-Web-Karte schnell visuell zu erkennen, wer unterwegs ist.
• Schnittstelle zu anderen ioBroker-Automatisierungen. Da jedes Feld ein einfacher ioBroker-Status ist, lässt es sich mit allem anderen, was bereits in der Instanz läuft, kombinieren – vorwärtseinsatzAktuell.* in eine Smart-Home-Szenen-Engine, eine Grafana/InfluxDB-Historie zur Analyse der Antwortzeiten oder einen Node-RED-ähnlichen Ablauf über den ioBroker MQTT-Adapter, ohne eine einzige Zeile Code für die WAIP-Web-API schreiben zu müssen.

Merkmale

• Verbindet sich mit dem/waip Namespace viasocket.io-client , registriert überemit('WAIP', monitorId) einmal (verlässt sich aufREGISTRATION_TIMEOUT_MS als Ausweichlösung anstelle wiederholter Anfragen, da eine redundante Anfrage den Server nur dazu veranlasst, erneut zu antworten, ohne die Zustellungssicherheit zu verbessern)
• Manuelle Wiederverbindungsbehandlung (die automatische Wiederverbindungsfunktion der Bibliothek ist deaktiviert) mit konfigurierbarer Verzögerung
• Registrierungs-Timeout mit Audit-Log (debug.monitorAudit )
• Geodatennormalisierung (wgs84 Felder,position oder GeoJSONgeometry → Schwerpunkt)
• Historie der letzten N abgeschlossenen Vorfälle (konfigurierbar, Standardwert 10;einsatzAktuell.json.history )
• Separate Handler für Alarme (io.new_waip ), Rückmeldung (io.new_rmld ), Routen (io.routes ), TTS (io.playtts ) und Standby (io.standby )
• Automatische Verwaltung von Session-Cookies (siehe unten), sodass die Alarmzustellung auch ohne geöffnete Browsersitzung unbegrenzt funktioniert.
• Server-Neustart-Erkennung überio.version mit automatischer Sitzungsaktualisierung und Wiederverbindung
• Vorfall-, Feedback-, Routen- und Alarmierungsressourcendaten sind als separate, flache JSON-Arrays verfügbar untereinsatzAktuell.json.* – Keine Verschachtelung, sodass VIS-Tabellen-Widgets direkt daran gebunden werden können.
• Zusammengefasste Feedbackzähler pro Rolle/Fähigkeit, die die Live-Badges auf der Web-Benutzeroberfläche widerspiegeln.
• Sauberer Zustand bei jedem Neustart: Alle Zustände werden aktiv auf ihren leeren Wert zurückgesetzt (false /0 /null /[] ) beim Start des Adapters, außereinsatzAktuell.json.history Unddebug.monitorAudit (beide bleiben auch nach Neustarts erhalten). Beachten Sie, dass die Live-Felder des Adapters (einsatzAktuell.* ) werden ebenfalls gelöscht und erst wieder aufgefüllt, wenn der Server das nächste Ereignis für diesen Vorfall sendet.
• Schutz vor veralteten Daten: Wenn ein neuer Vorfall beginnt, bevor die Routen/Feedback-Ereignisse des vorherigen Vorfalls für den neuen Vorfall eingegangen sind,einsatzAktuell.json.routen /.rueckmeldungen und die Feedback-Zähler werden sofort zurückgesetzt, anstatt auf diese Ereignisse zu warten. Und wennio.standby Wird ein Vorfall jemals nicht erfasst (z. B. aufgrund einer Verbindungsunterbrechung zum falschen Zeitpunkt), schließt ein Überwachungssystem den Vorfall automatisch ab, sobald er erfasst ist.ablaufzeit ist mehr als eine Kulanzfrist (60 Sekunden) verstrichen, anstatt veraltete "aktive" Daten auf unbestimmte Zeit zu belassen.
• Es wird stets nur der zuletzt aktive Vorfall angezeigt; mehrere gleichzeitig aktive Vorfälle können derzeit nur über das Dashboard der WAIP-Web-Instanz eingesehen werden.
• Optionale Beschreibung in einfacher Sprache füreinsatzAktuell.stichwort (einsatzAktuell.beschreibung ), lokal aufgelöst aus einer vom Benutzer verwalteten Schlüsselworttabelle plus einem optionalen Decoder für dieR<RTW>N<NEF> Schlüsselwortschema für Rettungsdienste, das von mehreren Leitstellen verwendet wird – siehe Rettungsdienst
• Einsätze des Rettungsdienstes können vollständig ignoriert werden (keine Statusmeldungen, keine Historie, keine Sprachausgabe) – nützlich, wenn WAIP sie von vornherein nur unzuverlässig meldet, siehe Rettungsdienst
• Optionales Einsatzkartenbild: Eine PNG-Datei, zentriert auf die Einsatzkoordinaten, lokal aus OpenStreetMap-Kacheln erstellt, wobei das von WAIP-Web übermittelte Einsatzgebiet als Umriss in konfigurierbarer Farbe/Dicke dargestellt wird (alternativ als einfacher Markierungspunkt umschaltbar), bei Bedarf automatisch verkleinert wird, um das gesamte Gebiet sichtbar zu halten; der Dateipfad wird als Status angezeigt – siehe Einsatzkartenbild
• Optionales Dashboard: Spiegelt die letzten N Vorfälle wider, die dem Monitor dieser Instanz entsprechen.dashboard.einsatz1 …einsatzN Die Daten werden regelmäßig über kurzlebige Verbindungen abgefragt (keine permanente Dashboard-Verbindung) – siehe Dashboard.

Konfiguration

In der Admin-Benutzeroberfläche der Adapterinstanz sind die Einstellungen auf vier Registerkarten gruppiert: Verbindung , Rettungsdienst , Schlüsselwortbeschreibungen und Vorfallkartenbild – siehe unten für alle vier.

Verbindung

Das Session-Keepalive-Intervall ist nicht konfigurierbar – es wird bei jeder Erneuerung automatisch aus der vom Server gemeldeten Cookie-Lebensdauer abgeleitet (min. 55 s, max. 5 min, passend zum aktuellen Cookie)./js/session_keepalive.js (auf der Website selbst).

Warum ein Session-Cookie benötigt wird

Der WAIP-Webserver verknüpft die Alarmzustellung mit einem Express-Session-Cookie, das ein Browser alle paar Minuten automatisch über ein mitgeliefertes Skript erneuert. Ein einfacher Socket.IO-Client erhält dieses Cookie nicht automatisch – der Adapter ruft es daher selbst ab.GET /session/keepalive und verbindet es mit der Socket.IO-Verbindung.

Laut WAIP-Web-Quellcode ist die Lebensdauer des Cookies pro Instanz über eine Umgebungsvariable konfigurierbar (Serverstandard: 60 Sekunden; diese Instanz verwendet offenbar 10 Minuten). Ein festes Erneuerungsintervall wäre daher für andere WAIP-Web-Instanzen möglicherweise ungeeignet. Der Adapter ermittelt das tatsächliche Intervall stattdessen adaptiv aus der vom Server bei jedem Aufruf gemeldeten Ablaufzeit (80 % der beobachteten Lebensdauer, mindestens 55 Sekunden, maximal 5 Minuten) – genau dieselbe Begrenzung, die auch für andere Instanzen gilt./js/session_keepalive.js wird auf der Website selbst verwendet.

Rettungsdienst

Vorfälle des Rettungsdienstes bearbeiten (Administrator-Kontrollkästchen, standardmäßig aktiviert ): Vorfälle, dereneinsatzart kennzeichnet sie als Rettungsdienstanruf (enthält „Rettung“ oder „Krankentransport“, Groß-/Kleinschreibung wird nicht beachtet – siehe dieeinsatzart Beispiele in einsatzAktuell werden standardmäßig normal verarbeitet und entsprechen jeder vorherigen Version des Adapters. Durch Deaktivieren dieses Kontrollkästchens ignoriert der Adapter solche Vorfälle vollständig : neineinsatzAktuell.* Die Status werden aktualisiert, es wird kein Verlaufseintrag geschrieben und keine TTS-Ansage ausgelöst.

• Als ob der Vorfall nie stattgefunden hätte. Dies ist notwendig, da Rettungseinsätze angeblich nur in einigen Regionen/Leitstellen überhaupt über WAIP gemeldet werden. Wo dies nicht der Fall ist oder nicht gewünscht wird, deaktiviert diese Option die Benachrichtigung. Alles unterhalb dieser Option auf dem Tab (das Kontrollkästchen für die Dekodierung und die zugehörigen Beschriftungsfelder) wird nur angezeigt, solange die Option aktiviert ist. Ist sie deaktiviert, werden Rettungseinsätze ohnehin ignoriert, sodass deren Schlüsselwortdekodierung irrelevant ist.

einsatzAktuell.stichwort wird unverändert als reiner Code vom Server weitergeleitet (z. B.B2 ,H:VU mit P ) – WAIP-Web selbst erklärt nicht, was es bedeutet, und es gibt keinen landesweiten Standard: Jede Leitstelle verwendet ihren eigenen Stichwortkatalog.einsatzAktuell.beschreibung Diese Lücke wird vollständig lokal geschlossen, es werden keine Daten an Dritte gesendet. Dieser Tab ist die erste von zwei überprüften Datenquellen (siehe Stichwortbeschreibungen für die zweite):

Dekodierung des Rettungsdienstes (Admin-Kontrollkästchen, standardmäßig aktiviert): wenn das Schlüsselwort mit dem Muster übereinstimmtR<RTW-count>N<NEF-count>[p][f][-NT] (z.BR1N0 → „Rettungswagen: 1, Notfalleinsatzfahrzeug: 0“) wird automatisch eine Beschreibung generiert. Zwei Schreibweisen desp /f /NT Teile werden erkannt: ohne Leerzeichen und mit einem Bindestrich davorNT (z.BR1N1p ,R1N0-NT (siehe Leitstelle Lausitz' dokumentierte Erklärung dazu), und mit Leerzeichen und ohne Bindestrich (z. B.R1N1 p ,R1N0 nt (wie vom IRLS Brandenburg verwendet) – dieses Schema (in beiden Schreibweisen) wird von mehreren deutschen Leitstellen genutzt, nicht nur von diesen beiden – hat keine Auswirkung, wenn Ihre Leitstelle keines dieser Muster verwendet, da das Schlüsselwort dann nicht übereinstimmt. Der Text für jeden Abschnitt ist selbst konfigurierbar (5 zusätzliche Textfelder erscheinen, sobald das Kontrollkästchen aktiviert ist), da der Adapter mehrsprachig ist und diese Bezeichnungen nicht automatisch übersetzt werden:

Schlüsselwortbeschreibungen

Wurde nur geprüft, wenn der Decoder auf der Registerkarte „Rettungsdienst“ nicht übereinstimmte: eine Liste von{keyword pattern, description, match type} Zeilen – Übereinstimmungstyp iststarts with odercontains Der Vergleich unterscheidet nicht zwischen Groß- und Kleinschreibung und behandelt Leerzeichen und Bindestriche als gleichwertig (jede Folge von Leerzeichen oder Bindestrichen wird vor dem Vergleich zu einem einzelnen Zeichen zusammengefasst), z. B.H:VU mit P ,H:VU-mit-P UndH:VU - mit - P Alle Treffer befinden sich in derselben Zeile – es ist nicht nötig, für jede Schreibvariante eine separate Zeile hinzuzufügen. Wenn mehrere Zeilen übereinstimmen, gewinnt automatisch das spezifischste (längste) Muster – die Zeilenreihenfolge hat keinen Einfluss auf die Übereinstimmung, sodass die Tabelle nach jeder Spalte (durch Klicken auf die Spaltenüberschrift) beliebig sortiert werden kann, ohne dass sich das Verhalten ändert. Die Tabelle enthält bereits eine Beispiel-Schlüsselwortliste für Feuerwehr/Rettungsdienst (B:... /H:... Diese Tabelle dient lediglich als Ausgangspunkt – es wird nicht garantiert, dass sie mit dem tatsächlichen Katalog eines bestimmten Dispatch-Centers übereinstimmt. Bearbeiten oder ersetzen Sie sie bei Bedarf vollständig. Um diese Tabelle zu sichern oder zu übertragen, verwenden Sie die Standard-Instanzkonfigurations-Export-/Importfunktion (JSON) von ioBroker. Laden Sie nach dem Import die Admin-Seite neu , bevor Sie diese Tabelle überprüfen – der Dialog zum Öffnen der Konfiguration aktualisiert sie nicht automatisch aus einem externen Import (eine Einschränkung der Status-Synchronisierung der Admin-Tabellenkomponente selbst, die nicht von diesem Adapter gesteuert wird).

Falls weder diese Tabelle noch der obige Decoder übereinstimmen,einsatzAktuell.beschreibung ist einfachnull - kein Fehler.

Abbildung der Vorfallskarte

Für jeden Vorfall wird ein Kartenbild generiert (Administrator-Kontrollkästchen, standardmäßig deaktiviert): Wenn dieses Kontrollkästchen aktiviert ist und ein Vorfall gültige Koordinaten enthält, lädt der Adapter die benötigten Kacheln aus dem öffentlichen Kartenmaterial herunter.tile.openstreetmap.org Der Server fügt sie zu einer einzigen PNG-Datei zusammen, die auf den Ort des Vorfalls zentriert ist, und fügt den OpenStreetMap-Urhebervermerk (der gemäß der ODbL-Lizenz erforderlich ist) in die linke untere Ecke ein.

Standardmäßig sendet der Vorfallbereich WAIP-Web diegeometry Das Ereignisfeld (üblicherweise ein kreisförmiges Polygon um den Ort, nicht nur dessen Mittelpunkt) wird als Umriss in konfigurierbarer Farbe und Stärke in das Bild eingezeichnet – die ursprüngliche Form, die der Server gesendet hat, nicht eine Markierung am Schwerpunkt. Die Option „Ereignisbereich-Polygon anzeigen“ (Admin-Kontrollkästchen, standardmäßig aktiviert) steuert dies: Deaktivieren Sie sie, um stattdessen immer einen einfachen Markierungspunkt im Mittelpunkt anzuzeigen, selbst wenn ein Polygon verfügbar ist. Der Punkt wird auch automatisch verwendet, wenn das Ereignis gar kein Polygon enthält (z. B. nur einen Punkt) – dies ist dann die einzige Option, unabhängig vom Kontrollkästchen. Der Ereignisbereich bleibt beim Zeichnen des Polygons immer vollständig sichtbar: Wenn er bei der konfigurierten Zoomstufe nicht in das Bild passt, zoomt der Adapter automatisch so weit heraus (niemals hinein), dass der gesamte Bereich angezeigt wird, anstatt ihn am Rand abzuschneiden.

Zoomstufe , Markierungs- und Umrissfarbe sowie Bildbreite/-höhe befinden sich oberhalb des Kontrollkästchens, da sie für beide Anzeigemodi gelten: die Zoomstufe wie oben für das Polygon beschrieben oder als fester Wert für den Markierungspunkt; die Farbe für den Polygonumriss oder den Kern des Markierungspunkts; die Breite/Höhe für das Bild selbst. Nur die Umrissstärke wird unterhalb des Kontrollkästchens angezeigt, da sie sich ausschließlich auf den Polygonumriss auswirkt – die Größe des Markierungspunkts ist fest und nicht konfigurierbar.

Der Dateipfad wird geschrieben nacheinsatzAktuell.kartenbildPfad (siehe einsatzAktuell ) – Typischerweise wird diese Datei aus einem Blockly/JavaScript-Skript angehängt, z. B. als Pushover-Benachrichtigungsanhang. Nur die 10 zuletzt generierten Bilder werden auf der Festplatte gespeichert; ältere werden automatisch gelöscht, sobald ein neues Bild geschrieben wird. Die Alarmverarbeitung wartet, bis das Bild fertiggestellt ist, bevor sie fortfährt.einsatzAktuell.kartenbildPfad garantiert, dass der korrekte Wert bereits vorliegt, wenn die übrigen Felder des Vorfalls (z. B.einsatzAktuell.alarmAktiv ) verfügbar werden – jedoch nur bis zum konfigurierbaren OSM-Timeout : Wenn der Download/die Zusammenstellung der Kacheln nicht innerhalb dieser Zeit abgeschlossen ist, wird eine Warnung protokolliert undeinsatzAktuell.kartenbildPfad bleibt für diesen Vorfall leer, ohne die Alarmverarbeitung auf unbestimmte Zeit zu blockieren.

Die Bilder werden im eigenen Datenverzeichnis dieser Adapterinstanz gespeichert (iobroker-data/<instance>/maps/ ), nicht als ioBroker-Dateiobjekte –einsatzAktuell.kartenbildPfad Es handelt sich daher um einen realen, absoluten Dateisystempfad, auf den ein Skript, das auf demselben Host ausgeführt wird, direkt zugreifen kann. Dieses Verzeichnis wird nicht automatisch gelöscht, wenn der Adapter gestoppt oder seine Instanzkonfiguration zurückgesetzt wird. Um es bei der Deinstallation zu entfernen, aktivieren Sie im Bestätigungsdialog beim Löschen der Instanz/des Adapters in der Administration die Option „Auch Instanzdaten löschen“ (verfügbar ab js-controller 4.0 / Admin 5 für jedes Instanzdatenverzeichnis eines Adapters – standardmäßig deaktiviert).

Hinweis: Hierbei wird die offizielle, kostenlose Version verwendet.tile.openstreetmap.org Der Server ist für gelegentliche/geringes Datenaufkommen vorgesehen (siehe die OSM-Kachelnutzungsrichtlinie ). Ein Bild pro Vorfall liegt deutlich innerhalb dieser Grenzen – reduzieren Sie nicht den Zoomfaktor, um große Bereiche abzudecken, oder führen Sie keine Massenkachelabrufe durch.

Armaturenbrett

Dashboard aktivieren (Admin-Kontrollkästchen, standardmäßig deaktiviert): Spiegelt die letzten N Vorfälle wider, die dem für diese Instanz konfigurierten Monitor entsprechen.dashboard.einsatz1 …dashboard.einsatzN , zusätzlich zu dem einzelnen aktuellen Vorfall, der bereits unter einsatzAktuell verfügbar ist. Dies ist nützlich mit einer Monitor-ID, die auf "alle Einsatzleitmonitore" beschränkt ist (0 oder auf einen größeren Bezirk/Netzbetreiber, wo mehrere Vorfälle gleichzeitig aktiv sein können undeinsatzAktuell.* alone zeigt immer nur die aktuellste Version an.

Im Gegensatz zum ständig eingeschalteten/waip Die Verbindung, die dieser Adapter ansonsten aufrechterhält, wird regelmäßig aktualisiert: Der Adapter ruft die öffentlichen Daten ab./dbrd/ Die Übersichtsseite für Vorfälle filtert die Ergebnisse nach Vorfällen, die dem Monitor dieser Instanz entsprechen (derselbe).l /a /b /c Leitstelle/Kreis/Träger/Wache-Korrelation (siehe Monitor-ID-Dropdown-Menü – siehe Verbindung ) und öffnet für jedes von bis zu N übereinstimmenden Ereignissen nacheinander (niemals parallel) eine kurzlebige Socket.IO-Verbindung, um deren aktuellen Status zu erfassen, und schließt diese anschließend wieder. Eine vollständige Aktualisierung dauert daher realistischerweise einige Sekunden pro belegtem Ereignis.einsatzN , nicht Millisekunden – das unten angegebene minimale Aktualisierungsintervall spiegelt dies wider.

Außerdem wird unmittelbar nach jedem (Neu-)Start des Adapters eine Aktualisierung durchgeführt (damit das Dashboard nicht bis zum konfigurierten Intervall leer bleibt) und einmal immer dann, wenn ein neuer Alarm für den Monitor dieser Instanz empfangen wird (einsatzAktuell.* Zusätzlich zum regulären Timer kann jederzeit eine manuelle Aktualisierung ausgelöst werden.dashboard.refreshNow Zustand einer Schaltfläche, z. B. von einer VIS-Schaltfläche oder einem Skript.

Kartenbilder werden angezeigt alsdashboard.einsatzN.kartenbildPfad werden nicht separat für das Dashboard generiert – sie werden in der gleichen Dateihistorie nachgeschlagen , die das Incident Map Image bereits für den Monitor dieser Instanz erzeugt.einsatzN Es wird nur dann ein Kartenbild angezeigt, wenn dieser Adapter bereits über seine eigenen Funktionen eines für genau diesen Vorfall generiert hat.einsatzAktuell.* Alarmbehandlung – am vollständigsten, wenn die Monitor-ID0 (alle Einsatzleitmonitore) und die Generierung eines Kartenbildes für jeden Vorfall ist aktiviert; seitdem wurde jeder Vorfall, der im Dashboard angezeigt werden kann, ebenfalls durchlaufen.einsatzAktuell.* mindestens einmal. Mit einer engeren Monitor-ID,einsatzN Einträge für Vorfälle außerhalb des eigenen Alarmverlaufs des jeweiligen Monitors enthalten kein Kartenbild – dies ist beabsichtigt und kein Fehler.

Durch Deaktivieren der Funktion wird die gesamtedashboard.* Objektbaum (Kanäle und Zustände, nicht nur deren Werte); Reduzierung der Anzahl der anzuzeigenden Vorfälle entfernt nur die nun nicht mehr verwendeten.einsatzN Einträge am Ende (z. B. von 10 auf 5 entfernen)dashboard.einsatz6 …einsatz10 Beide Änderungen werden erst nach dem nächsten Neustart des Adapters nach dem Speichern wirksam (ioBroker startet die Instanz bei jeder Konfigurationsänderung ohnehin neu – die Entfernung erfolgt nicht sofort, während der Admin-Dialog geöffnet ist).

Staaten (unterwaip-web.0.* )

Feedback und Routen sind 1:n-Listen pro Vorfall. Sie werden als flache JSON-Arrays gespeichert untereinsatzAktuell.json.* (keine verschachtelten Objekte/Arrays innerhalb einer Zeile), sodass sie direkt an VIS-Tabellen-Widgets gebunden werden können – ergänzt durch schnell zu bindende Zähler, sodass Bindungen und Trigger überhaupt kein JSON-Parsing benötigen.

Info

Status

einsatzAktuell

Flache Felder des aktuell laufenden Einsatzes. Geräumt (null /0 ) Anio.standby , passend zum offiziellen Frontend –alarmAktiv ist daher ein zuverlässiger Indikator dafür, ob diese Felder aktuell Live-Daten enthalten. Der zuletzt abgeschlossene Vorfall bleibt übereinsatzAktuell.json.history :

Hinweis: Der Adapter spiegelt immer nur den zuletzt aktiven Vorfall wider (einsatzAktuell.* /einsatzAktuell.json.current ) – entsprechend der Alarmüberwachung des offiziellen WAIP-Web-Frontends. WAIP-Web kann prinzipiell mehrere Ereignisse gleichzeitig aktiv haben (z. B. zwei kurz nacheinander eingehende Alarme). Diese Zustände stellen keine Liste gleichzeitig laufender Ereignisse dar – sie werden bei jedem neuen Ereignis überschrieben.io.new_waip Da ein zweites, parallel laufendes Ereignis auftritt, ist es über diesen Adapter derzeit nicht sichtbar. Eine vollständige Übersicht aller aktuell aktiven Ereignisse ist momentan nur über das Dashboard der verbundenen WAIP-Web-Instanz verfügbar.

Hinweis: Der Server von WAIP-Web füllt nureinsatznummer ,objekt /objektteil ,besonderheiten ,strasse /hausnummer ,einsatzdetails und das Berechtigungsflag für angemeldete Clients (db_user_check_permission_for_waip() im eigenen Serverserver/waip.js Da dieser Adapter systembedingt ohne Anmeldung eine Verbindung herstellt (siehe „Über diesen Adapter “), sendet der Server immer diese leeren/false Sie werden daher überhaupt nicht als Zustände exponiert, sondern tragen dauerhaft tote Werte in sich.

einsatzAktuell.json

Flache JSON-Objekte/-Arrays, maximal eine Ebene tief, die direkt an VIS-Tabellen-Widgets gebunden werden sollen (verschachtelte Strukturen wie ein einfaches{routen, rueckmeldungen, ...} Objekte werden im Allgemeinen nicht von diesen Widgets gerendert.routen /rueckmeldungen /emAlarmiert /emWeitere Es werden ausschließlich die Daten des aktuellen Vorfalls gespeichert – diese werden gelöscht ([] ) Anio.standby und gehören nicht zur Geschichte. Wie beieinsatzAktuell.* über,current Es wird immer nur der letzte aktive Vorfall gespeichert – siehe den Hinweis imeinsatzAktuell Abschnitt.

Notiz:routen[].lat /.lon Es handelt sich um den Standort der alarmierten Station , nicht um einen Punkt entlang der tatsächlichen Fahrstrecke und auch nicht um den Unfallort. Der Server sendet jede Route entweder als vollständigeLineString (der berechnete Pfad von der Station zum Ereignisort) oder, falls kein Pfad berechnet werden konnte, als einzelnes Koordinatenpaar für die Station selbst – in beiden Fällen löst der Adapter auflat /lon zum Standort des Bahnhofs (dem ersten Punkt der Linie in derLineString (Fall) für eine einheitliche Bedeutung über alle Einträge hinweg. Die vollständige Routengeometrie selbst wird nicht als Zustand dargestellt.

einsatzAktuell.tts

Sprachansage (io.playtts ) für den aktuell laufenden Vorfall – lebt untereinsatzAktuell Anstatt eines eigenen Hauptkanals, da dieser ohne ein Ereignis bedeutungslos ist. Keine Historie: Eine TTS-Ansage ist nur im Moment relevant, daher wird nur die aktuellste gespeichert.

Armaturenbrett

Nur vorhanden, wenn das Dashboard aktiviert ist – dort finden Sie den Lebenszyklus der Objektstruktur bei Aktivierung/Deaktivierung/Größenänderung.dashboard.einsatzN (N = 1 … die konfigurierte Anzahl der anzuzeigenden Vorfälle) spiegelt die gleiche Form wider wieeinsatzAktuell /einsatzAktuell.json oben, für den N-ten letzten Vorfall, der dem Monitor dieser Instanz entspricht – nicht beschränkt auf den aktuellen Vorfall. Alle Felder eines belegteneinsatzN werden bei jeder Aktualisierung neu geschrieben (nicht nur bei Änderungen), sodass fortlaufendes Feedback für einen Vorfall, der sich nicht ändert,einsatzN Die Aktualisierungen werden fortlaufend aktualisiert; ein unbesetztereinsatzN (weniger übereinstimmende Vorfälle als konfiguriert) hat alle Felder mit dem Wert leer, genau wieeinsatzAktuell.* wenn kein Ereignis aktiv ist.

absichtlich ohnerestzeit /ablaufzeit (WAIP-Web)/dbrd/ Die Vorfalldetailsdaten verfügen im Gegensatz zu den Live-Daten über kein entsprechendes Feld./waip Alarmstrom) und ohneeinsatzAktuell.tts 's Äquivalent (es existiert kein TTS-Ereignis in der/dbrd Namespace).dashboard.einsatzN.json.wachen hat keineeinsatzAktuell.json.* Gegenstück umgekehrt - es stammt von einem Feld (wachen[] , die an dem Vorfall beteiligten Stationen), dass nur die/dbrd Die Nutzlast umfasst:

debuggen

Protokollierung

Alle Protokolltexte sind in Englisch. Wiederholbare Fehlerzustände (Erneuerung von Session-Cookies, WAIP-Registrierung, Socket.IO-Verbindung, Ereignisflut auf dem falschen Monitor) werden einmalig protokolliert.warn beim ersten Auftreten, dann beidebug solange sie bestehen, und sobald sieinfo bei der Wiederherstellung – gemäß der offiziellen ioBroker-Protokollierungsrichtlinie .

Die vollständige Referenz aller vom Adapter erzeugten Protokollmeldungen, gruppiert nach Ebene, mit ihrer Ursache und einem Beispiel, finden Sie in der Datei LOGGING.md.

Changelog

WORK IN PROGRESS

• registrationTimeoutSec and reconnectDelaySec are now clamped in code to their admin UI range (1-120s), matching how every other numeric configuration value (e.g. historySize, mapImageWidth) was already handled - a direct instance config JSON edit/import can no longer set them outside that range.
• The stateChange listener (used only for dashboard.refreshNow) is now registered only while the Dashboard feature is enabled, matching its subscribeStates() call, instead of unconditionally in the constructor.

1.0.0 (2026-08-30)

• Breaking change: the einsatz channel is renamed to einsatzAktuell (to distinguish it from the dashboard.einsatz1 … einsatzN dashboard channels), and einsatzAktuell.json.history10 is renamed to einsatzAktuell.json.history, now holding a configurable number of entries (new "Number of incidents in history" setting on the Connection tab, 1-100, default 10). Update any VIS bindings/scripts referencing the old einsatz.*/einsatz.json.history10 paths - they are removed automatically on upgrade, along with their values.
• Dashboard channel/state display names are now consistent: they use "Einsatz N" throughout, matching the einsatzAktuell.* naming, and the redundant "flat JSON array" phrase was removed from every state name. Object IDs are unaffected, only the display names shown in Admin/VIS.

0.12.1 (2026-08-30)

• Fixed the Dashboard admin config: the tab was mistranslated as "Armaturenbrett" (car dashboard) in German instead of "Dashboard", its help texts used wrong/mistranslated terms ("Versandzentrum"/"Vorfall" instead of "Leitstelle"/"Einsatz"), and the refresh interval label was missing its "(s)" unit suffix.
• Fixed routen[].lat/.lon (both einsatz.json.routen and dashboard.einsatzN.json.routen): previously resolved to the geometric bounding-box center of the entire route line - a point with no real meaning, since it lies "somewhere along the way" rather than at any actual location. Now resolves to the alerted station's own location instead (the first point of the route line, matching a separate coordinate-pair format the server sends when no route could be calculated for a station). Also fixed dashboard.einsatzN.json.routen specifically: it was missing the same geo normalization einsatz.json.routen already applied, so a route's raw, unresolved geometry (dozens of coordinate pairs) or the raw fallback coordinate field ended up in the written JSON instead of flat lat/lon.

0.12.0 (2026-08-28)

• New optional Dashboard feature: mirrors the last N incidents matching this instance's monitor as dashboard.einsatz1 … einsatzN (off by default). Uses short-lived Socket.IO connections to WAIP-Web's /dbrd namespace polled on a configurable interval, not a permanent connection - see Dashboard and dashboard states for the full behavior, including the manual refresh button and the object-deletion behavior when disabling the feature or reducing the number of incidents to show.

0.7.38 (2026-08-27)

• Fixed a race condition where a routes update (io.routes) or TTS announcement (io.playtts) arriving while an incident was being finalized could still repopulate einsatz.json.current, einsatz.json.routen and einsatz.routenGesamt for the already finished incident. The 0.7.37 guard checked a flag that was only cleared at the very end of the finalization, leaving a window open across several await points.
• Fixed lost entries in debug.monitorAudit: the log was written with an unsynchronized read-modify-write, so two entries created within milliseconds of each other (e.g. connect_called followed by emit_WAIP) could overwrite one another. Writes are now serialized.
• Fixed configuration values falling back to the minimum instead of the default when a numeric admin field is left empty - an empty zoom field produced zoom 1 (the whole world map) instead of the configured default, and an empty width field produced 100px instead of 600px.
• Added a unit test suite (npm run test:unit, 75 tests) covering the geo normalization, the keyword decoder/table, the monitor matching and the state-definition consistency. npm test now runs it alongside the package tests.

0.7.37 (2026-08-26)

• Fixed a bug where a routes update (io.routes) or TTS announcement (io.playtts) arriving after an incident had already ended (io.standby) could revive einsatz.json.current/.routen/ einsatz.routenGesamt or einsatz.tts.last/.lastTimestamp for the already-finished incident, while every other einsatz.* field correctly stayed cleared. Both handlers now ignore such events while no incident is active.

Older entries have been moved to CHANGELOG_OLD.md.

License

MIT License (this adapter) – see LICENSE.

The adapter connects to instances of WAIP-Web, which is licensed under CC BY-SA 4.0 by Robert-112. This adapter contains no code from that project.

Copyright (c) 2026 rnc11

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.