Dieses Modul ermöglicht das Schalten eines Gerätes (Variable und/oder Skripts) in Abhängigkeit von Uhrzeit und/oder des täglichen Sonnenganges.

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

Für eine einfache Zeitschaltung wäre dieses Modul normalerweise nicht notwendig. Die Erstellung einen Wochenplanes oder eines zyklischen Ereignisses ist mit IPS Bordmitteln recht einfach möglich. Interessant wird die Sache erst wenn man bedingtes und zyklisches Schalten verbinden möchte. Für eine solche Kombination gibt es eine Reihe von Anwendungsfälle, wie z.B. ...

• Rollläden/Jalousien am Morgen zu einer definierten Zeit hochfahren (Arbeitstag unabhängig von Jahreszeit), aber abends zum Sonnenuntergang runterfahren
• Außenbeleuchtung bei einsetzender Dunkelheit einschalten, aber pünktlich um Mitternacht wieder ausschalten
• Haustür Notlicht einsetzenden der Dämmerung Ein- bzw.- Ausschalten
• oder zur Weihnachtszeit die Beleuchtung situativ schalten.

Das nur um einige Anregungen zu geben. Wahrscheinlich gibt es da noch einiges mehr an Ideen, welche sich so umsetzen lassen.

• Zeitschaltung anhand verschiedener Einstellmöglichkeiten:
  1. Aus => Ein- bzw. Ausschalten wird nicht vollzogen (externer Auslöser)
  2. Sonnengang => 8 mögliche Zeitpunkte wählbar (Sonnenaufgang und -untergang; zivile, nautische oder astronomische Dämmerung)
  3. Wochenplan => Steuerung über Zeitplan
• Zusätzlich bzw. ausschließlich kann ein Skript ausgeführt werden.
• Schaltvariable muss nicht eine Aktionsvariable sein, sondern kann auch einfach eine boolesche Variable sein.
• Option das Einschalten nur zu erlauben, wenn sich die Zeiten nicht überschneiden (zeitlich korrekte Abfolge, AN-vor-AUS).
• Statusvariable als Proxy-Schalter, z.B. für Verwendung im WebFront.
• Schalten kann über mehrere Tage hinweg organisiert werden (gezielter Einsatz des täglichen Zeitplanes).

• IP-Symcon ab Version 6.4

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

• Unter "Instanz hinzufügen" ist das Zeitschaltuhr-Modul unter dem Hersteller '(Geräte)' aufgeführt.

Konfigurationsseite:

Einstellungsbereich:

Schaltung ...

Name	Beschreibung
An /Aus	Schalter zum Aktivieren bzw. Deaktivieren der gesamten Schaltung, z.B. Weihnachtsbeleuchtung nur im Winter 😉

Zeitssteuerung ...

Name	Beschreibung
Auslöser Einschalten	Auswahlmöglichkeiten: Aus; Sonnenaufgang oder -untergang; zivile, nautische oder astronomische Dämmerung; Wochenplan (An)
Auslöser Ausschalten	Auswahlmöglichkeiten: ; Sonnenaufgang oder -untergang; zivile, nautische oder astronomische Dämmerung; Wochenplan (Aus)
(Zeitplan)	Hinterlegung einer täglichen Uhrzeit für AN & AUS (Montag - Sonntag)

Geräte ...

Name	Beschreibung
Geräteanzahl	Auswahl bzw. Umschalter zwischen einzelnen und mehreren Geräten
Schaltvariable	Schalt(Aktions-)variable (ein Gerät)
Schaltvariablen	Liste von Geräten (mehrere Geräte)
Skript	Auszuführendes Skript (Status true/false wird als Array 'State' übergeben)

Einstellungen ...

Name	Beschreibung
Schaltvariable nur ein- bzw. ausschalten wenn zeitliche Abfolge korrekt ist (nur in Verbindung mit einem Wochenplan)!	true/false
Zusätzlich noch eine normale Schaltervariable anlegen (z.B. für Webfront)?	true/false

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

Es ist keine weitere Steuerung oder gesonderte Darstellung integriert.

Ein direkter Aufruf von öffentlichen Funktionen ist nicht notwendig!

v3.0.20240908

• NEU: Modulumbenennung in nur noch "Zeitschaltuhr" (ohne Licht-...)
• 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

v2.0.20220216

• NEU: Umschalten zwischen einem oder mehreren Geräten
• NEU: Eine reine boolesche Schaltvariable (ein Gerät) wird automatisch erkannt
• NEU: Referenzieren der Gerätevariablen hinzugefügt
• FIX: Globale Aktivierung bzw. Deaktivierung der Schaltung umgebaut
• FIX: Schaltung der Proxy Schaltvariable für Webfront korrigiert
• FIX: Übersetzungen erweitert bzw. korrigiert

v1.6.20220119

• NEU: Schalter zum manuellen aktivieren bzw. deaktivieren der Instanz (Zeitschaltuhr)
• NEU: Kompatibilität auf IPS 6.0 hoch gesetzt
• NEU: Bibliotheks- bzw. Modulinfos vereinheitlicht
• NEU: Konfigurationsdialog überarbeitet (v6 Möglichkeiten genutzt)

v1.5.20210625

• FIX: Start Bedingung korrigiert
• FIX: Timer Update Berechnung vereinheitlicht

v1.4.20210505

• FIX: Komplett neue Steuerung für die Einhaltung der zeitlichen Reihenfolge
• NEU: Die eingestellte Zeit kann jetzt vom Sontag auf den Montag kopiert werden

v1.3.20210426

• FIX: Fix für die Einhaltung der zeitlichen Reihenfolge

v1.2.20210330

• FIX: Umstellung auf direkte Eingabe der Uhrzeiten (kein externer Wochenplan mehr notwendig)
• NEU: Beachtung der zeitlichen Reihenfolge (EIN-vor-AUS) hinzugefügt

v1.1.20210326

• NEU: Umstellung auf frei wählbaren Ein- und Ausschaltzeitpunkt
• NEU: Schaltung über Tagesgrenze hinweg möglich

v1.0.20210322

• NEU: Initialversion

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 😉

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

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