Fenster- und Türkontakt (Contact Sensor)

Version Product Version License Actions

Das Modul reagiert entsprechend hinterlegter Verzögerungszeit und Bedingungen auf das Öffnen bzw. Schließen von Fenster- bzw. Türkontakten und führt eine Temperaturabsenkung durch.

Wer die Meldungsverwaltung (Thema: Meldungsanzeige im Webfront) kann sich über den Schaltvorgang informieren lassen.

Inhaltverzeichnis

  1. Funktionsumfang
  2. Voraussetzungen
  3. Installation
  4. Einrichten der Instanzen in IP-Symcon
  5. Statusvariablen und Profile
  6. Visualisierung
  7. PHP-Befehlsreferenz
  8. Versionshistorie

1. Funktionsumfang

  • Überwachen von bis zu 4 Kontaktsensoren (z.B. pro Raum)
  • Verzögertes Absenken der Heizung entsprechend eingestellter Zeit
  • Schalten von bis zu 2 Heizkörpern (Thermostaten bzw. Ventilantrieben)
  • Bedingtes Schalten in Abhängigkeit ...
    • der Ventilstellung / Ventilöffnung
    • der Differenz zwischen Aussen- und Innentemperatur
    • Wiederholtes Testen der Bedingungen nach einstellbarer Zeit
  • Automatisches Aufheben der Absenkung unabhängig von Zustand der Sensoren

2. Voraussetzungen

  • IP-Symcon ab Version 6.4
  • Heizkörpersteuerung getestet mit HmIP-WTH2 und/oder HmIP-eTRV(-2)

3. Installation

  • Über den Modul Store das Modul Contact Sensor installieren.
  • Alternativ Über das Modul-Control folgende URL hinzufügen.
    https://github.com/Wilkware/ContactSensor oder git://github.com/Wilkware/ContactSensor.git

4. Einrichten der Instanzen in IP-Symcon

  • Unter 'Instanz hinzufügen' ist das Contact Sensor-Modul (Alias: Fenster- und Türkontakt, Türkontakt oder Fensterkontakt) unter dem Hersteller '(Geräte)' aufgeführt.

Konfigurationsseite:

Einstellungsbereich:

Kontakt-Sensoren ...

Name Beschreibung
1.Sensor Statusvariable, eines Kontaktsensors (offen/geschlossen)
2.Sensor StatusVariable, eines zweiten Kontaktsensors (offen/geschlossen)
3.Sensor StatusVariable, eines dritten Kontaktsensors (offen/geschlossen)
4.Sensor StatusVariable, eines vierten Kontaktsensors (offen/geschlossen)

Bedingtes Schalten ...

Name Beschreibung
Reaktionszeit (Verzögerung) Zeit zwischen Erkennen und Schalten
Checkbox Ventilöffnung Nur Absenken wenn gerade geheizt wird (Ventilstellung > 0%)
Positionsvariable Variable, welche die aktuelle Ventilposition enthält
Checkbox Temperatur Nur Absenken wenn Differenz (Schwellwert) zwischen Außen- und Innentemperatur eingestellten Wert überschreitet
Temeraturdifferenz Schwellert zwischen Außen- und Innentemperatur
Checkbox Wiederholungsintervall Zeitraum in welchem wiederholt die eingstellten Bedingungen (Ventilposition & Temperaturdifferenz) getestet werden
Zeitspanne (Wiederholung) Intervall (Zeit) zwischen den Tests
Checkbox Absenkung aufheben Aktivierung der automatischen Aufhebung der Absenkung unabhängig vom Zustand der Sensoren
Zeitspanne (Aufhebung) Zeitraum nach dem die Absenkung aufgehoben werden soll

Heizungssystem ...

Name Beschreibung
1.Heizkörper Steuerungskanal des ersten Heizungsthermostats oder -stellantriebs
2.Heizkörper Steuerungskanal des zweiten Heizungsthermostats oder -stellantriebs
Skript Auswahl eines Skriptes, welches nur oder zusätzlich ausgeführt werden soll (IPS_RunScriptEX). Status 1(open) bzw. 0(close) wird im Array als 'WINDOW_STATE' übergeben. Die ID des ausführenden Moduls wird in 'MODUL' mitgegeben.).

Klimawerte ...

Name Beschreibung
Außentemperatur Aktuelle Außentemperatur
Innentemperatur Aktuelle Raumtemperatur

Meldungsverwaltung ...

Name Beschreibung
Meldung an Anzeige senden Auswahl ob Eintrag in die Meldungsverwaltung erfolgen soll oder nicht (Ja/Nein)
Auslöser der Nachricht Auswahl bei welcher Aktion eine Nachricht erfolgen soll
Lebensdauer der Nachricht (Öffnen) Wie lange soll die öffnende Meldung angezeigt werden?
Lebensdauer der Nachricht (Schließen) Wie lange soll die schließende Meldung angezeigt werden?
Nachricht an Visualisierung senden Auswahl ob Push-Nachricht gesendet werden soll oder nicht (Ja/Nein)
Auslöser der Nachricht Auswahl bei welcher Aktion eine Nachricht erfolgen soll
Raumname Text zur eindeutigen Zuordnung des Raums
Format der Textmitteilung (Öffnen) Frei wählbares Format der öffnenden Nachricht/Meldung
Format der Textmitteilung (Schließen) Frei wählbares Format der schließenden Nachricht/Meldung
Visualisierungs-Instanz ID der Visualisierung, an welches die Push-Nachrichten gesendet werden soll (WebFront oder TileVisu Instanz)
Meldsungsskript Skript ID des Meldungsverwaltungsskripts

5. Statusvariablen und Profile

Es werden keine zusätzlichen Statusvariablen/Profile benötigt.

6. Visualisierung

Es ist keine weitere Steuerung oder gesonderte Darstellung integriert.

Hinweis: Das Script 'Meldungsanzeige im Webfront' (Meldungsverwaltung) wird unterstützt.

7. PHP-Befehlsreferenz

Das Modul stellt keine direkten Funktionsaufrufe zur Verfügung.

8. Versionshistorie

v3.0.20240908

  • NEU: Kompatibilität auf IPS 6.4 hoch gesetzt
  • FIX: Unterscheidung der verschiedenen Visualisierungsinstanzen (PushNotification)
  • FIX: Bibliotheks- bzw. Modulinfos vereinheitlicht
  • FIX: Namensnennung und Repo vereinheitlicht
  • FIX: Update Style-Checks
  • FIX: Übersetzungen überarbeitet und verbessert
  • FIX: Dokumentation vereinheitlicht

v2.1.20230110

  • NEU: Referenzieren der Gerätevariablen hinzugefügt (sicheres Löschen)
  • NEU: Erweiterung zum Ausführen eines Skriptes
  • FIX: 4. Kontaktsensor wurde nicht berücksichtigt

v2.0.20221204

  • NEU: Konfigurationsformular überarbeitet und vereinheitlicht
  • NEU: Kompatibilität auf 6.0 hoch gesetzt
  • NEU: Meldungswesen komplett überarbeitet und erweitert
  • FIX: Interne Bibliotheken überarbeitet und vereinheitlicht
  • FIX: Dokumentation überarbeitet

v1.2.20201219

  • NEU: 3. und 4. Kontaktsensor hinzugefügt
  • FIX: Meldungslogik verbessert

v1.1.20201204

  • NEU: 2. Kontaktsensor hinzugefügt
  • NEU: Wiederholungsintervall für bedingtes Schalten hinzugefügt
  • NEU: Zeitspanne für Aufhebung der Absenkung hinzugefügt
  • NEU: Aliase für Modul auf Türkontakt und Fensterkontakt geändert
  • FIX: Schaltungslogik komplett neu umgesetzt (via WINDOW_STATE)
  • FIX: Zugriff auf interne Funktionen aufgehoben
  • FIX: Meldungslogik umgebaut

v1.0.20200515

  • NEU: Initialversion

Entwickler

Seit nunmehr über 10 Jahren fasziniert mich das Thema Haussteuerung. In den letzten Jahren betätige ich mich auch intensiv in der IP-Symcon Community und steuere dort verschiedenste Skript und Module bei. Ihr findet mich dort unter dem Namen @pitti 😉

GitHub

Spenden

Die Software ist für die nicht kommerzielle Nutzung kostenlos, über eine Spende bei Gefallen des Moduls würde ich mich freuen.

PayPal

Lizenz

Namensnennung - Nicht-kommerziell - Weitergabe unter gleichen Bedingungen 4.0 International

Licence