(Version 1.6.14)

Script um offene Türen und Fenster pro Raum und insgesamt zu zählen sowie offen/zu/gekippt States anzulegen und eine pro Raum konfigurierbare Lüftungsempfehlung (zeitbezogen) zu geben. Direkte Ausgabe aller Stati via HTML Tabelle und/oder Alexa/Telegram/Mail. Flexibel konfigurierbar.

If you like it, please consider a donation:

Features

• Kann beliebige Tür/Fenster Kontakte verwenden. Noch nicht erfasste Varianten können über die Einstellungen hinzugefügt werden.

• Berücksichtigt mehrflügelige Fenster bzw. mehrere Fenster pro Raum.

• Legt pro Raum 13 Datenpunkte an (Raumfensteroffenzähler, Raumfenstergekipptzähler, Raumtürzähler ,Raumfensterstatus und die Einstellfelder für die Lüftungsempfehlung und welche Nachrichten Ihr haben möchtet, sowie das Feld in dem Ihr eine Benutzdefinierte Reihenfolge für die Ausgabe festlegen könnt), sowie 14 Datenpunkte fürs gesamte. (Siehe Beschreibung der Datenpunkte weiter unten)

• Möglichkeit eine Meldung/Ansage via Mail/Telegram/Alexa nach x Minuten einmalig oder zyklisch bis Fensterschließung auszugeben.

• Meldungen können bei Bedarf über einen Mute Datenpunkt entweder gesamt oder nur für Sprachnachrichten stummgeschaltet werden.

• Gibt dynamische HTML Tabelle mit Übersicht aller Räume und farblicher Kennzeichnug der jeweiligen Stati aus. Verwendete Bilder und Farben sind frei konfigurierbar.

• Möglichkeit die Tabelle nicht/alphabetisch/benutzerdefiniert zu sortieren

• Gibt zeitbezogene Lüftungswarnung aus wenn Fenster für Zeit x (pro Raum einstellbar) nicht geöffnet wurden.

• Gibt Liste mit Räumen für welche aktuell eine Fensteroffen Warnung besteht aus und zählt diese.

• Gibt Liste mit Räumen in denen gekippte Fenster sind aus und zählt diese.

• Gibt Liste mit Räumen in denen offfene Türen sind aus und zählt diese.

• Gibt Liste mit Räumen für welche aktuell eine Lüftungs Warnung besteht aus.

• Kann kurze auf/zu Änderungen innerhalb Zeit x (einstellbar) ignorieren.

WICHTIG!!!

Vorraussetzungen: Den Geräten müssen Räume (für den gesamten Channel) zugewiesen sein, sowie eine Funktion, z.B. "Fenster", bzw. "Tuer" für jeden entsprechenden Datenpunkt.

Hier aber nur für den Datenpunkt, nicht den gesamten Channel!!!

Installation

1. Wenn noch nicht geschehen, allen gewünschten Sensoren einen Raum und eine Funktion zuweisen. Die Funktion muss vorher in den Aufzählungen hinzugefügt werden und könnte z.B. "Fenster", bzw. "Tuer" lauten. Sollen andere Begriffe verwendet werden, muss dies dann auch im Script, Zeile 12 und 13 geändert werden. Nach der Zuweisung, bzw. dem anlegen neuer Aufzählungspunkte ist es empfehlenswert die JS Instanz neu zu starten da diese bei Aufzählungsänderungen gerne mal "zickt" was dann zu Skriptfehlern führt.

2. Das Skript in ein neues JS Projekt kopieren.

3. Zeile 9-53 kontrollieren und bei Bedarf anpassen, siehe Beschreibungen direkt neben den Variablen.

4. Zeile 18-27 wäre der richtige Ort falls Telegram, Alexa etc. die Meldungen ausgeben sollen.

5. Skript starten

6. In den Objekten, unter Javascript.0.FensterUeberwachung sollte es jetzt für jeden definierten Raum einen Channel mit 13 Datenpunkten geben:

   1. RoomIsOpen (readonly): Sind in diesem Raum ein oder mehrere Fenster und/oder eine Tür geöffnet?
   2. DoorIsOpen (readonly): Sind in diesem Raum ein oder mehrere Türen geöffnet?
   3. WindowIsOpen (readonly): Sind in diesem Raum ein oder mehrere Fenster geöffnet?
   4. RoomOpenCount (readonly): Summe der in diesem Raum geöffneten (inkl. der gekippten!) Fenster und Türen, 0 wenn alle geschlossen.
   5. RoomOpenWindowCount (readonly): Anzahl der in diesem Raum geöffneten (inkl. der gekippten!) Fenster, 0 wenn alle geschlossen.
   6. RoomOpenDoorCount (readonly): Anzahl der in diesem Raum geöffneten Türen, 0 wenn alle geschlossen.
   7. RoomTiltedWindowCount (readonly): Anzahl der in diesem Raum gekippten Fenster, 0 wenn alle geschlossen.
   8. VentWarnTime: Einstellfeld für die Anzahl Tage nach denen eine Lüftungsempfehlung ausgegeben wird. Lüftungsempfehlung ist bei 0 für diesen Raum deaktiviert.
   9. SendVentMsg: Einstellfeld ob Ihr für diesen Raum eine Lüftungswarnung haben möchtet.
   10. SendWindowOpenCloseMsg: Einstellfeld ob Ihr für diesen Raum eine Benachrichtigung für das erste Öffnen und das letzte Schließen der/des Fensters haben möchtet.
   11. SendDoorOpenCloseMsg: Einstellfeld ob Ihr für diesen Raum eine Benachrichtigung für das erste Öffnen und das letzte Schließen einer Tür haben möchtet.
   12. SendWindowWarnMsg: Einstellfeld ob Ihr für diesen Raum eine Offenwarnung haben möchtet.
   13. RoomOrderPriority: Einstellfeld für die benutzerdefinierte Sortierung der Raumliste (wichtige Räume an den Listenanfang um nicht scrollen zu müssen). Keine doppelten Zahlen verwenden! Änderungen hier treten erst nach Skriptneustart in Kraft.

7. Zusätzlich werden 15 weitere Datenpunkte in der Skript Root ("javascript.0.FensterUeberwachung") angelegt:

   1. AllWindowsClosed (Ersetzt ab V.1.6.0 die Bezeichnung "AlleFensterZu"): Gesamtstatus aller Fenster
   2. AllDoorsClosed: Gesamtstatus aller Türen
   3. DoorsOpen: Anzahl der offenen Türen über alle Räume summiert.
   4. WindowsOpen: Anzahl der offenen Fenster über alle Räume summiert (inkl. der gekippten Fenster!).
   5. WindowsTilted: Anzahl der gekippten Fenster über alle Räume summiert.
   6. RoomsWithOpenDoors: Eine Textliste von Räumen mit geöffneten Türen und deren Anzahl. Sinnvoll für Kurzfassungsanzeigen in Vis.
   7. RoomsWithOpenWindows: Eine Textliste von Räumen mit geöffneten Fenstern und deren Anzahl, sowie die Untermenge der davon gekippten Fenster (Funktioniert natürlich nur wenn entsprechende Sensoren verwendet werden die gekippt als Status melden). Sinnvoll für Kurzfassungsanzeigen in Vis.
   8. RoomsWithTiltedWindows: Eine Textliste von Räumen mit gekippten Fenstern und deren Anzahl. Sinnvoll für Kurzfassungsanzeigen in Vis (Funktioniert natürlich nur wenn entsprechende Sensoren verwendet werden die gekippt als Status melden).
   9. RoomsWithOpenings: Eine Textliste von Räumen mit geöffneten Fenstern und Türen sowie deren Anzahl, sowie die Untermenge der davon gekippten Fenster (Funktioniert natürlich nur wenn entsprechende Sensoren verwendet werden die gekippt als Status melden). Sinnvoll für Kurzfassungsanzeigen in Vis.
   10. RoomsWithVentWarning: Eine Textliste von Räumen bei denen eine Lüftungswarnung besteht.
   11. LastMessage: Die zuletzt ausgegebene Nachricht. Ermöglicht es die Meldungen mit History zu erfassen oder mit Vis auszugeben.
   12. MessageLog: Ein kleines Log der ausgegebenen Meldungen mit Zeitstempel. Zeitstempel Format und max. Anzahl der Logeinträge in den Einstellungen konfigurierbar. Default Trennzeichen ist ">br>", somit kann die Liste direkt in einem HTML Widget via Binding ({javascript.0.FensterUeberwachung.MessageLog}) in Vis ausgegeben werden.
   13. OverviewTable: Dynamisch erzeugte HTML Tabelle mit allen Räumen und den jeweiligen Fensterstati. Verwendung in Vis als Binding: {javascript.0.FensterUeberwachung.OverviewTable} in einem HTML Widget, optimale Breite 310px, Hintergrundfarbe, Schriftfarbe und Schriftart nach Wahl.
   14. MuteMode: Bietet die Möglichkeit via Datenpunkt z.B. nachts Nachrichtenausgaben zu verhindern.
       • 0 = Alle Ansagen werden ausgegeben.
       • 1 = "Stumme" Nachrichten via Telegram/Mail etc. werden ausgegeben, Sprachausgaben geblockt.
       • 2 = Alle Nachrichten werden geblockt.
   15. SendRoomsWithOpeningsMsg: Legt fest ob bei Statusänderungen eine Übersichtsmeldung gesendet wird.

Es werden drei Icons aus dem Satz: "icons-mfd-svg" verwendet. Solltet Ihr diese nicht installiert haben, so könnt Ihr dies nachholen (wird als Adapter installiert) oder beliebige eigene Icons verwenden, hierzu muß dann jedoch der Name und Pfad im Skript, Zeile 30 - 36 angepasst werden. Sieht dann z.B. so aus:

Diese Datenpunkte könnt Ihr jetzt z.B. in Vis verwenden um offene Türen/Fenster pro Raum anzuzeigen. Es wird dabei berücksichtigt dass es mehrere Türen/Fenster pro Raum, bzw. mehrflügelige Fenster geben kann.

Changelog

22.11.21 (1.6.15)

• Add: Zu verwendende Funktionsaufzählung nun konfigurierbar gemacht.

09.10.21 (1.6.14)

• Add: SendRoomsWithOpeningsMsg: Legt fest ob bei Statusänderungen eine Übersichtsmeldung gesendet wird.

06.05.21 (1.6.13)

• Fix: Unbenutzte PushOver Instanz wird jetzt verwendet.
• Add: PushOver Sound Option zu Einstellungen hinzugefügt. #38

03.05.21 (1.6.12)

• Fix: Fehlermeldung "Read-only state ... has been written without ack-flag with value ..." nach update des Js Controller auf Version 3.3.x oder höher behoben. Issue: #34

18.03.21 (V1.6.11)

• Fix: Anzeigefehler für Pluralvariante von RoomsWithOpenings behoben.

16.03.21 (V1.6.10)

• Fix: Fehler im Trigger des AnwesenheitsDp korrigiert.

11.02.21 (V1.6.9)

• Add: Alexa Lautstärke und Instanz nun einstellbar.

08.02.21 (V1.6.8)

• Add: PushOver Option zu Nachrichten hinzugefügt. (#28)

15.10.20 (V1.6.7)

• Add: Zeit bis Benachrichtigung kann nun für Fenster und Türen separat gesetzt werden.

29.07.20 (V1.6.6)

• Fix: Dp "RoomIsOpen" wird nun korrekt gesetzt.

04.07.20 (V1.6.5)

• Add: Türenbenachrichtigung hinzugefügt.

02.07.20 (V1.6.4)

• Fix: Problem bei HM Instanzen ungleich 0 behoben.
• Fix: Fehlende Implementierung von NoMsgAtPresence behoben.
• Change: Layout der ersten Tabellenspalte geändert. Wenn ein Raum nur Fenster oder Tür -> eine Spalte. Wenn Raum Fenster und Tür -> zwei Spalten.
• Add: Türen können nun auch "gekippt" Status haben.

29.06.20 (V1.6.3)

• Fix: Problem mit zusätzlicher Tabellenspalte behoben wenn sowohl Fenster als auch Türsensoren vorhanden waren und beides geschlossen.

24.06.20 (V1.6.2)

• Change: Tabellendetails hinzugefügt/geändert.
• Change: Zahlenspalte angepasst.

24.06.20 (V1.6.0)

• Add: Raumliste kann jetzt alphabetisch oder benutzerdefiniert sortiert werden, wodurch es möglich wird gewünschte Räume für die Tabellemausgabe in der Reihenfolge nach oben zu schieben.
• Add: Es ist jetzt möglich auch Türen separat mitzuzählen, hierfür muß eine zweite Funktion, z.B. "Tuer" festgelegt und den entsprechenden Türkontakten zugewiesen werden. Bei der Tabellenausgabe gibt es eine weitere Spalte für Türen mit eigenem Icon und eigener Farbe. Die gesamte Textausgabe wurde angepasst und nennt nun pro geöffneten Raum, sowohl Fenster als auch Türöffnungsstatusänderungen.
• Change: der bisherige Defaultwert für die Funktionsbezeichnung der Fenster wurde geändert von "Verschluss" zu "Fenster".

03.05.20 (V1.5.3)

• Fix: Zeitversatz bei Lüftungsmeldungen behoben welcher zu 23 Stunden, 59 Minuten Meldungen (statt 1 Tag) führte.
• Fix: Mail Messaging auf Html umgestellt damit Umbrüche korrekt angezeigt werden.
• Change: Einige default Werte geändert, kleine interne Codeänderungen.

27.4.20 (V1.5.2)

• Add/Fix: Da sich HM Geräte nicht einig sind welcher Wert welchen Zustand bedeutet (bei einfachen Fensterkontakten 0=zu / 1=offen, bei Drehgriffkontakten 0=zu / 1=gekippt / 2=offen) wird jetzt zusätzlich der Text der Werteliste, wenn vorhanden, verwendet.
• Fix: Timingproblem behoben welches bei Verwendung von HM Drehgriffkontakten und Statusänderung von gekippt nach zu auftrat.

24.4.20 (V 1.5.0)

• Add: Nachrichtenausgabe kann nun in den Raumdatenpunkten pro Raum konfiguriert werden. Hierzu die Datenpunkte: SendOpenCloseMsg, SendVentMsg und SendWarnMsg angelegt.
• Add: In den Skripteinstellungen, MaxMsg hinzugefügt. Hier kann festgelegt werden wieviele Nachrichten Ihr maximal pro Raum erhalten möchtet. Wegfall der Option RepeatInfoMsg, da dies durch MaxMsg=1 konfiguriert werden kann.
• Add: Zusätzlicher Status "gekippt". Ausgabe der entsprechenden Werte sowohl als Gesamtzählung, als Liste, als auch pro Raum. Entsprechende Änderung der Texte (Wenn Fenster im Raum nur gekippt, Ausgabe Fenster gekippt, wenn nur offen, Ausgabe Fenster offen, wenn Fenster im Raum sowohl gekippt als auch offen, Ausgabe x Fenster offen, davon x Fenster gekippt). Zusätzliche Farbe und Bild für HTML Tabelle.
• Fix: Problem mit inkorrekten Lüftungswarnungen nach öffnen/schliessen innerhalb Berechnungstimeout.
• Add: Kurzzeitige (Zeit einstellbar) öffnen/schliessen Aktionen werden nun ignoriert (z.B. mal schnell aus dem Fenster guggen)

17.4.20 (V 1.4.3)

• Add: Zusätzliche Logpunkte.
• Fix: Problem mit inkorrekten Lüftungswarnungen nach Initphase.

13.4.20 (V 1.4.2)

• Add: Zusätzlicher Datenpunkt "MuteMode" in der Skript Root eingefügt.
• Add: Zusätzlicher Datenpunkt "RoomsWithVentWarning" in der Skript Root eingefügt.

12.4.20 (V 1.4.0)

• Add: Zusätzlicher Datenpunkt "LastMessage" in der Skript Root eingefügt.
• Add: Zusätzlicher Datenpunkt "MessageLog" in der Skript Root eingefügt.
• Change: Tabelle, Defaultfarben an MaterialDesign2 Farben angepasst. Schriftgrößenfestlegung von em auf px und Tabellenaufbau geändert um bessere Kompatibilität mit MD2 zu erreichen.
• Add: Tabelle, Überschrift, Zusammenfassung und Detailbereich können nun in den Einstellungen deaktiviert werden.
• Add: Bilder können in Einstellungen invertiert werden.
• Change: Tabelle, Bilder horizontal zentriert.
• Change: Zur besseren Verständlichkeit einige Einstellungskonstanten umbenannt.

9.4.20 (V 1.3.0)

• Add: Unterstriche werden in Meldungen nun als Leerzeichen ausgegeben. Ae, ue, oe, wird in Meldungen nun als ä, ü, ö ausgegeben.
• Change: offen/geschlossen Zeiten werden nicht mehr als Zeitstempel angezeigt sondern die jeweilige Dauer berechnet und minütlich aktualisiert.
• Add: Pro Raum konfigurierbare Lüftungsempfehlung integriert. Bei Skriptneustarts wird bereits vorhandene geschlossen Zeit berücksichtigt.
• Change: Tabellenfarben jetzt heller / freundlicher.
• Fix: Ignorieren von geöffneten Fenstern bei Skriptstart behoben, wenn diese in einem Raum mit mehreren/zweiflügeligen Fenstern waren und das geöffnete Fenster in der Aufzählung vor dem geschlossenen gelistet war.

1.4.20 (V 1.2.3) Add: Tabellendatumsformatierung ist jetzt in Einstellungen konfigurierbar.

31.3.20 (V1.2.2)

• Add: Benachrichtigung via Mail hinzugefügt.
• Add: Option hinzugefügt um auch erstmaliges öffnen sowie schliessen zu melden.
• Change: Zeitausgaben werden nun auf eine Nachkommastelle gerundet.

29.3.20 (V1.2.1)Add: Möglichkeit integriert die Tabelle ohne Kopf darzustellen

28.3.20 (V1.2.0)Add: Dynamisch erstellte HTML Übersichtstabelle über alle Räume/Fenster

25.3.20 (V1.1.7) Add: HMIP Drehgriffe integriert; Statebezeichnungen für auf/zu jetzt User-konfigurierbar -erweiterbar

23.3.20 (V1.1.6)Add: Neuer Datenpunkt mit Textübersicht ausschliesslich der Räume mit geöffneten Fenstern

22.3.20 (V1.1.5) Bugfix für HM Drehgriff Sensoren, Logging erweitert

5.2.20 (V1.1.4)Add: Fehlerabfangroutinen integriert

3.2.20 (V1.1.3) Kleinere Bugfixes und upload zu git

1.2.20 (V1.1.2) Add: Möglichkeit eine Ansage nach x Minuten einmalig oder zyklisch bis Fensterschließung anzugeben.

14.1.20 (V1.1.1) Add: "Offen" erweitert um "Open", "Tilted", "Gekippt"

9.8.19 (V1.1.0) Zählung der Fenster gesamt ausgeweitet auf Fenster pro Raum

4.8.19 Init (V1.0.0)