Lichtautomat – Wilkware

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

1. Funktionsumfang

Überwacht und schaltet das Licht(er) automatisch nach einer bestimmten Zeit wieder aus.
Bei Variablenänderung der Statusvariable(n) 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

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 Symcon

Unter ‘Instanz hinzufügen’ ist das Lichtautomat-Modul unter dem Hersteller ‘(Geräte)’ aufgeführt.

Konfigurationsseite:

Einstellungsbereich:

Geräte …

Name	Beschreibung
Geräteanzahl	‘Ein Gerät’ oder ‘Mehrere Geräte’ - Umschalten zwischen Variablenauswahl und Variablenliste.
Schaltvariable*	Zielvariable, die bei hinreichender Bedingung geschalten wird (true).
Schaltvariablen*	Zielvariablen, welche alle bei hinreichender Bedingung geschalten werden (true).
Bewegungsvariable	Statusvariable eines Bewegungsmelders (true = Anwesend; false = Abwesend).

(*) abhängig von Auswahl der Geräteanzahl

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.2.20241220

NEW: Auswahl ob ein einzelnes oder mehrere Geräte/Lampen geschalten werden sollen
FIX: Alias-Namen gelöscht(Treppenautomat)
FIX: Dokumentation vereinheitlicht

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 Symcon Community und steuere dort verschiedenste Skript und Module bei. Ihr findet mich dort unter dem Namen @pitti ;-)

Spenden

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

Lizenz

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