Lichtautomat (Light Automat)

Version Product Version License Actions

Das Modul Lichtautomat (Light Automat) überwacht und schaltet das Licht automatisch nach einer bestimmten Zeit wieder aus.

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

  • Überwacht und schaltet das Licht automatisch nach einer bestimmten Zeit wieder aus.
  • Bei Variablenänderung der Statusvariable (STATE) wird ein Timer gestartet.
  • Nach eingestellter Zeit wird der Staus wieder zurückgestellt ("STATE" = flase).
  • Sollte das Licht schon vorher manuell aus geschalten worden sein, wird der Timer deaktiviert.
  • Zusätzlich bzw. ausschließlich kann ein Script ausgeführt werden.
  • Möglichkeit des manuellen Dauerbetriebes schaltbar über eine boolesche Variable, wenn true wird kein Timer gestartet.
  • Hinterlegung eines Wochenplans zum gezielten Aktivieren bzw. Deaktivierung des Automaten.
  • Berücksichtigung von Bewegungsmelder, wenn dieser aktiv ist wird der Timer immer wieder erneuert.
  • Möglichkeit der Steuerung der Wartezeit über eigene Laufzeit-Variable (z.B. via WebFront).
  • Start der Wartezeit bei Aktivierung des Automaten via Wochenplan (Übergang Inaktiv zu Aktiv).

2. Voraussetzungen

  • IP-Symcon ab Version 6.4

3. Installation

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

4. Einrichten der Instanzen in IP-Symcon

  • Unter 'Instanz hinzufügen' ist das Lichtautomat-Modul (Alias: Treppenautomat) unter dem Hersteller '(Geräte)' aufgeführt.

Konfigurationsseite:

Einstellungsbereich:

Geräte ...

Name Beschreibung
Schaltervariable Quellvariable, über welche der Automat getriggert wird. Meistens im Kanal 1 von HomeMatic Geräten zu finden und ist vom Typ boolean und hat den Namen "STATE" (z.B: wenn man die Geräte mit dem HomeMatic Configurator anlegen lässt.).
Bewegungsvariable Statusvariable eines Bewegungsmelders (true = Anwesend; false = Abwesend).

Zeitsteuerung ...

Name Beschreibung
Zeiteinheit Bestimmt ob Dauer in Sekunden, Minuten, Stunden oder Uhrzeit (freie Zeitwahl) ausgewertet werden soll.
Einschaltdauer Zeitdauer, bis das Licht(Aktor) wieder ausgeschaltet werden soll. Wird bei eigner Variable für Einschaltdauer (siehe Erweiterte Einstellungen) als Vorgabewert/Initialwert benutzt.
Zeitplan Wochenprogram, welches den Lichtautomaten zeitgesteuert aktiviert bzw. deaktiviert.
ZEITPLAN HINZUFÜGEN Button zum Erzeugen und Hinzufügen eines Wochenprogrammes.

Erweiterte Einstellungen ...

Name Beschreibung
Gleichzeitiges Ausführen eines Scriptes Auswahl eines Skriptes, welches zusätzlich ausgeführt werden soll (IPS_ExecScript).
Nur Script ausführen - kein Ausschaltvorgang Schalter, ob nur das Script ausgeführt werden soll.
Starte Einschaltdauer bei eingeschaltem Licht und Aktivierung über Schaltplan Schalter, ob nach Aktivierung über Wochenplan der Automat starten soll.
Variable für Einstellung der Einschaltdauer anlegen Schalter, ob eine Statusvariable für Einschaltdauer angelegt werden soll.
Variable für Aktivierung des Dauerbetriebes anlegen Schalter, ob eine Statusvariable für Dauerbetrieb angelegt werden soll.

5. Statusvariablen und Profile

Die Statusvariablen werden unter Berücksichtigung der erweiterten Einstellungen angelegt. Das Löschen einzelner kann zu Fehlfunktionen führen.

Name Typ Beschreibung
Dauerbetrieb Boolean Ein- und Ausschalten des Dauerbetriebes (z.B. bei Besuch oder Party's)
Einschaltdauer Integer Dauer der Wartezeit in Abhängigkeit der eingestellten Zeiteinheit
Zeitplan (Wochenplan) Einstellen der Zeitpunkte für Aktivieren bzw. Deaktivieren des Automaten

Folgende Profile werden angelegt:

Name Typ Beschreibung
TLA.Seconds Integer Zeitraum von 1 bis 59 Sekunden
TLA.Minutes Integer Zeitraum von 1 bis 59 Minuten
TLA.Hours Integer Zeitraum von 1 bis 23 Stunden

6. Visualisierung

Es ist keine weitere Steuerung oder gesonderte Darstellung integriert.
Der Dauerbetrieb kann über die Statusvariable "Dauerbetrieb" in der Visualisierung realsiert werden.
Die Wartezeit kann auch über die Statusvariable "Einschaltdauer" so realisiert werden.

7. PHP-Befehlsreferenz

Ein direkter Aufruf von öffentlichen Funktionen ist nicht notwendig!

8. Versionshistorie

v7.1.20240920

  • FIX: Modulnamen bzw. Alias-Namen
  • FIX: Auswertung der verknüpften Variablen/Instanzen korriegiert

v7.0.20240908

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

v6.0.20220401

  • NEU: Kompatibilität auf IPS 6.0 hoch gesetzt
  • NEU: Konfigurationsdialog überarbeitet (v6 Möglichkeiten genutzt)
  • NEU: Konfiguration der Zeitsteuerung überarbeitet
  • NEU: Einschaltdauer kann über eine frei wählbare Uhrzeit eingestellt werden (Kombination von Stunden, Minuten und Sekunden)
  • NEU: Eine reine boolesche Schaltvariable wird automatisch erkannt
  • NEU: Referenzieren der Gerätevariablen hinzugefügt (sicheres Löschen)
  • FIX: Public Funktions TLA_Trigger, TLA_Schedule und TLA_CreateSchedule wegen neuer Prozessverarbeitung entfernt
  • FIX: Interne Bibliotheken erweitert und vereinheitlicht
  • FIX: Markdown der Dokumentation überarbeitet

v5.0.20210502

  • NEU: Umstellung auf Statusvariablen für Einschaltdauer und Dauerbetrieb
  • NEU: Wartezeit jetzt frei konfigurierbar (Sekunden, Minuten oder Stunden)
  • NEU: Check ob Licht nach Aktivierung des Automaten über Wochenplan ausgeschalten werden soll
  • FIX: Funktion "TLA_Duration" entfernt (wegen Nutzung von IPS_SetProperty/ IPS_ApplyChanges)
  • FIX: Konfigurationsformular vereinheitlicht bzw. vereinfacht
  • FIX: Interne Bibliotheken überarbeitet

v4.0.20200421

  • NEU: Zeitplan hinzugefügt
  • NEU: Unterstützung für die Erstellung eines Wochenplans
  • FIX: Interne Bibliotheken überarbeitet
  • FIX: Dokumentation überarbeitet

v3.3.20190818

  • NEU: Umstellung für Module Store
  • FIX: Dokumentation überarbeitet

v3.2.20170322

  • FIX: Anpassungen für IPS Version 5

v3.1.20170120

  • FIX: Korrekte Auswertung der Schaltvariable.

v3.0.20170109

  • NEU: Dauerbetrieb miitels hinterlegter booleschen Variable, wenn true wird kein Timer gestartet.
  • NEU: Modul mit Bewegungsmelder, wenn dieser aktiv ist wird der Timer immer wieder erneuert.
  • NEU: Über die Funktion TLA_Duration(id, minuten) kann die Wartezeit via Skript (WebFront) gesetzt werden.

v2.0.20170101

  • FIX: Umstellung auf Nachrichten (RegisterMessage/MessageSink)
  • NEU: Erweiterung zum Ausführen eines Skriptes

v1.0.20161220

  • 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