Suche

    Universelle Zeitschaltuhr

    Dokumentation direkt aus GitHub Wilkware/UniversalTimer ↗

    Version Product Version License Actions

    Dieses Modul ermöglicht gezielte Schaltvorgänge zu bestimmten Uhrzeiten oder in Abhängigkeit von Ereignissen.

    1. Funktionsumfang

    Für eine einfache Zeitschaltung wäre dieses Modul normalerweise nicht notwendig, ein Wochenplan oder ein zyklisches Ereignis ist mit den Bordmitteln von Symcon schnell erstellt. Interessant wird es erst, wenn man zeitgesteuertes und bedingtes Schalten kombinieren möchte, z.B. …

    • Rollläden/Jalousien an Arbeitstagen zum Sonnenaufgang hochfahren, aber frühestens um 06:30 Uhr und nicht an Feiertagen
    • Außenbeleuchtung zur Dämmerung einschalten und pünktlich um Mitternacht wieder ausschalten
    • Notlicht an der Haustür nur einschalten, wenn jemand zu Hause ist (Bedingung)
    • Weihnachtsbeleuchtung nur im Zeitraum vom 1. Dezember bis 6. Januar schalten
    • Anwesenheitssimulation mit zufälliger Abweichung der Schaltzeiten

    Funktionen im Überblick:

    • Beliebig viele Zeitpläne pro Instanz, jeder mit eigenem Auslöser, eigenen Tagen, eigener Bedingung und eigener Aktion
    • Auslöser: feste Uhrzeit, 8 Sonnenereignisse (Sonnenauf- und -untergang sowie zivile, nautische und astronomische Dämmerung), im Location Control hinterlegte Offsets oder Wechsel einer Variable auf TRUE
    • Versatz zum Sonnenereignis sowie frühester und spätester Schaltzeitpunkt; außerhalb der Grenzen wird wahlweise auf die Grenze verschoben oder an diesem Tag nicht geschaltet (z.B. kein Einschalten, wenn das Ausschalten schon vorher erfolgte)
    • Zufällige Abweichung (± Minuten), stabil pro Tag und Zeitplan
    • Wochentage, Kalenderregeln (Feiertage/Ferien) und Gültigkeitszeitraum (auch über den Jahreswechsel)
    • Bedingungen über die Symcon-Bedingungsauswahl, geprüft zur Schaltzeit
    • Aktionen: Einschalten, Ausschalten (Geräteliste und/oder Skript) oder eine beliebige individuelle Symcon-Aktion (z.B. Dimmwert, Rollladenposition, Szene)
    • Geführte Erstellung neuer Zeitpläne über einen Assistenten mit Vorlagen
    • Vorschau aller Schaltpunkte der nächsten 7 Tage
    • Abgleich der Schaltervariable mit dem Zustand der Geräte, auch bei direktem Schalten der Geräte
    • Optional: Soll-Zustand nach einem Neustart herstellen, Pausieren der Automatik bzw. Überspringen des nächsten Schaltpunkts nach manuellem Schalten, globale Sperre über eine Variable
    • Optional: Variablen ohne Aktion (z.B. eigene Hilfsvariablen) direkt schalten

    Wie erstellt man einen Zeitplan?

    Am einfachsten über den Schalter ASSISTENT unter der Zeitplan-Liste (Panel “Zeitsteuerung …”). Der Assistent führt Schritt für Schritt durch Vorlage und Name, Auslöser, Tage, Bedingung und Aktion und zeigt am Ende eine Zusammenfassung. Mit OK wird der Zeitplan der Liste hinzugefügt, danach müssen die Änderungen noch übernommen werden.

    Alternativ legt HINZUFÜGEN direkt einen Eintrag über den Bearbeiten-Dialog an.


    Wie bearbeitet man einen Zeitplan?

    Über das Bearbeiten-Symbol eines Eintrags öffnet sich ein Dialog. Auslöser (Feste Uhrzeit, Sonnenereignis, Auslöservariable) und Aktion werden über Optionsfelder gewählt, die zugehörigen Einstellungen erscheinen jeweils direkt unter der gewählten Option. Aktiv und die Wochentage können direkt in der Liste umgeschaltet werden, die Reihenfolge lässt sich per Drag & Drop ändern.


    Was passiert, wenn mehrere Zeitpläne gleichzeitig fällig sind?

    Alle fälligen Zeitpläne werden in der Reihenfolge der Liste ausgeführt, der unterste Eintrag gewinnt also. Schalten zwei Zeitpläne mit fester Uhrzeit zur gleichen Zeit am gleichen Wochentag gegensätzlich, wird das über den Instanzstatus gemeldet.


    Wie werden Feiertage und Ferien berücksichtigt?

    Im Panel “Kalender …” werden boolesche Variablen hinterlegt, die für den aktuellen Tag angeben, ob ein Feiertag bzw. Ferien sind (z.B. aus dem Modul Almanach ). Die Kalenderregel eines Zeitplans wird zur Schaltzeit gegen diese Variablen geprüft.

    2. Voraussetzungen

    • Symcon ab Version 9.1
    • Für Sonnenereignisse: eingerichtetes Location Control (Standort)

    3. Installation

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

    4. Einrichtung

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

    Konfigurationsseite:

    Einstellungsbereich:

    🎚️ Schaltung …

    NameBeschreibung
    An / AusAktiviert bzw. deaktiviert die gesamte Zeitschaltuhr

    ⏱️ Zeitsteuerung …

    NameBeschreibung
    ZeitplanListe aller Zeitpläne (Aktiv, Name, Wochentage, Auslöser, Zeit, Regel, Aktion)
    ASSISTENTGeführte Erstellung eines neuen Zeitplans mit Vorlagen

    Einstellungen eines Zeitplans (Bearbeiten-Dialog bzw. Assistent):

    NameBeschreibung
    NameFrei wählbare Bezeichnung (ohne Namen wird die Position ‘#n’ angezeigt)
    AktivZeitplan aktiv bzw. inaktiv
    AuslöserFeste Uhrzeit, Sonnenereignis oder Auslöservariable
    UhrzeitSchaltzeitpunkt (Feste Uhrzeit)
    EreignisEines der 8 Sonnenereignisse oder ein im Location Control hinterlegter Offset (Sonnenereignis)
    Versatz (Minuten)Verschiebung zum Ereignis, auch negativ; bei Offsets des Location Control zusätzlich zu deren Versatz (Sonnenereignis)
    Frühestens / SpätestensBegrenzung des Schaltzeitpunkts (Sonnenereignis) bzw. Zeitfenster, in dem die Auslöservariable schaltet (Auslöservariable); 00:00 bzw. 23:59 = keine Grenze
    Außerhalb nicht schaltenLiegt der Schaltzeitpunkt außerhalb der Grenzen, wird an diesem Tag nicht geschaltet statt auf die Grenze zu verschieben (Sonnenereignis)
    AuslöservariableBoolesche Variable, deren Wechsel auf TRUE schaltet (Auslöservariable)
    Zufällige AbweichungZufällige Verschiebung um bis zu ± n Minuten (nicht bei Auslöservariable)
    MO - SOWochentage, an denen geschaltet wird
    RegelKalenderregel: Immer, an/nicht an Feiertagen, an/nicht an Ferientagen, an/nicht an Feiertagen oder Ferientagen
    Gültig ab / bis (MM-TT)Gültigkeitszeitraum, leer = ganzjährig (über den Jahreswechsel möglich, z.B. 12-01 bis 01-06)
    BedingungBedingung, die zur Schaltzeit erfüllt sein muss
    AktionEinschalten, Ausschalten oder Individuelle Aktion
    Individuelle AktionBeliebige Symcon-Aktion (nur bei Aktion Individuelle Aktion)

    📅 Kalender …

    NameBeschreibung
    Heute FeiertagBoolesche Variable, die anzeigt, ob heute ein Feiertag ist
    Heute FerienBoolesche Variable, die anzeigt, ob heute Ferien sind
    SperreBoolesche Variable; solange sie TRUE ist, wird nicht geschaltet

    💡 Geräte …

    NameBeschreibung
    SchaltvariablenListe der zu schaltenden Variablen (Boolean), geschaltet per RequestAction; Änderungen der Geräte werden überwacht und in die Statusvariable ‘Schalter’ übernommen
    Gleichzeitiges Ausführen eines SkriptesSkript, welches zusätzlich ausgeführt wird (IPS_RunScriptEx); der Zustand wird im Array als ‘State’ (true/false) übergeben

    Hinweis: Geräte und Skript werden von den Aktionen Einschalten und Ausschalten verwendet.

    ⚙️ Erweiterte Einstellungen …

    NameBeschreibung
    Statusvariable anlegenLegt die Statusvariable ‘Schalter’ an, über die die Geräte manuell geschaltet werden (z.B. in der Visualisierung); sie zeigt zugleich den Zustand der Geräte (An, sobald mindestens ein Gerät an ist)
    Soll-Zustand herstellenErmittelt nach einem Neustart bzw. beim Übernehmen der Konfiguration den letzten gültigen Schaltpunkt der letzten 24 Stunden und schaltet die Geräte nur, wenn ihr Zustand davon abweicht. Individuelle Aktionen und Skripte ohne Schaltvariablen werden nur nach einem Neustart nachgeholt (standardmäßig aktiv)
    Nach manuellem SchaltenVerhalten nach manuellem Schalten (über die Statusvariable ‘Schalter’ oder direkt am Gerät): Automatik unverändert fortsetzen; Auslöservariablen und Nachholen bis zum nächsten Schaltpunkt pausieren; zusätzlich den nächsten Schaltpunkt überspringen (z.B. bleibt ein von Hand ausgeschaltetes Licht aus, auch wenn der nächste Zeitplan es einschalten würde)
    Variablen ohne Aktion direkt setzenSchaltvariablen ohne Aktion werden direkt gesetzt (SetValue); nur für Variablen, die zu keiner Instanz gehören

    Aktionsbereich:

    NameBeschreibung
    Jetzt einschaltenSchaltet die Geräte (und das Skript) sofort ein, ohne Prüfung von Zeitplänen und Bedingungen
    Jetzt ausschaltenSchaltet die Geräte (und das Skript) sofort aus, ohne Prüfung von Zeitplänen und Bedingungen
    Vorschau nächste 7 TageZeigt alle berechneten Schaltpunkte der nächsten 7 Tage; Kalenderregeln und Bedingungen werden erst zur Schaltzeit geprüft und daher nur als Hinweis angezeigt

    Hinweis: Fehlt eine Schaltvariable bzw. das Skript oder ist eine Schaltvariable nicht schaltbar, wird das über den Instanzstatus gemeldet.

    Hinweis: Zeitpläne aus Version 2.x werden automatisch in das neue Format übernommen, ein bisher hinterlegter externer Auslöser wird den betreffenden Zeitplänen als Auslöservariable zugeordnet.

    5. Statusvariablen

    Die Statusvariablen werden automatisch angelegt. Das Löschen einzelner kann zu Fehlfunktionen führen.

    NameTypBeschreibung
    SchalterBooleanZustand der Geräte und manuelles Schalten (nur mit ‘Statusvariable anlegen’)
    AutomatikBooleanSchaltet die Automatik ein/aus; bei Aus wird weiter berechnet, aber nicht geschaltet
    Nächste SchaltungIntegerZeitpunkt der nächsten Schaltung
    Nächste AktionStringAktion und Name des nächsten Zeitplans
    Letzte SchaltungIntegerZeitpunkt der letzten ausgeführten Schaltung

    6. Darstellungen

    Die Darstellungen werden direkt an den Statusvariablen hinterlegt, es werden keine Profile angelegt.

    VariableDarstellungWerte
    SchalterSchalterAn / Aus
    AutomatikSchalterAn / Aus
    Nächste SchaltungDatum/UhrzeitWochentag, Tag, Monat, Stunden und Minuten
    Nächste AktionWertanzeigeText
    Letzte SchaltungDatum/UhrzeitWochentag, Tag, Monat, Stunden und Minuten

    7. Visualisierung

    Die Statusvariablen können direkt in der Visualisierung verwendet werden.

    8. Befehlsreferenz

    string UTSC_GetScheduleForm(int $InstanzID);
    

    Liefert den Bearbeiten-Dialog eines Zeitplans für die Konfigurationsseite.
    Hinweis: Die Funktion wird intern vom Konfigurationsformular verwendet, ein direkter Aufruf ist nicht notwendig!

    9. Versionshistorie

    v3.0.20261015

    • NEU: Kompatibilität auf Symcon 9.1 hoch gesetzt
    • NEU: Auswertung der Zeitpläne und Schalten der Geräte (bisher reine Konzeptstudie)
    • NEU: Sonnenereignisse mit Versatz sowie frühestem und spätestem Schaltzeitpunkt (verschieben oder nicht schalten)
    • NEU: Offsets des Location Control als Auslöser
    • NEU: Auslöservariable pro Zeitplan (ersetzt den globalen externen Auslöser)
    • NEU: Zufällige Abweichung, Gültigkeitszeitraum und Kalenderregeln (Feiertage/Ferien über frei wählbare Variablen)
    • NEU: Individuelle Aktion pro Zeitplan
    • NEU: Assistent mit Vorlagen zur geführten Erstellung von Zeitplänen
    • NEU: Bearbeiten-Dialog und Assistent mit Optionsfeldern für Auslöser und Aktion, es werden nur die relevanten Einstellungen gezeigt
    • NEU: Vorschau der Schaltpunkte der nächsten 7 Tage
    • NEU: Statusvariablen Automatik, Nächste Schaltung, Nächste Aktion und Letzte Schaltung
    • NEU: Soll-Zustand nach Neustart bzw. Übernehmen herstellen (nur bei Abweichung), Pausieren nach manuellem Schalten und globale Sperre
    • NEU: Schaltervariable folgt dem Zustand der Geräte, manuelles Schalten am Gerät wird erkannt
    • NEU: Optional direktes Setzen von Variablen ohne Aktion
    • NEU: Prüfung der Schaltvariablen und Referenzen auf alle verwendeten Objekte
    • NEU: Darstellungen statt Profilen
    • NEU: Bestehende Zeitpläne werden automatisch übernommen

    v2.0.20260201

    • NEU: Projektumstrukturierung hin zu einer globalen CI/CD-Pipeline
    • NEU: Kompatibilität auf Symcon 8.1 hoch gesetzt
    • NEU: Umstellung auf IPSModuleStrict
    • NEU: Kompatibilität für Symcon 8.2 vorbereitet
    • NEU: Modulversion wird in Quellcodesektion angezeigt
    • FIX: Bibliotheksfunktionen angeglichen

    v1.0.20220228

    • 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 ;-)

    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