Skip to content

Flexibles Timerscript mit Astrofunktion und Vis für iobroker

License

Notifications You must be signed in to change notification settings

Pittini/iobroker-Timer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

41 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Legt eine beliebige Anzahl von Timern an mit folgenden Features:

If you like it, please consider a donation:

paypal

Features

  1. Alle benötigten Datenpunkte werden automatisch erstellt.
  2. Jeder Timer steuert genau einen Schaltvorgang. Für einen kompletten ein/aus Zyklus müssen also 2 Timer genutzt werden.
  3. Es kann ein/aus-geschaltet werden, aber auch Werte gesendet werden (Z.b. Rollo um 13:00 auf 40% fahren).
  4. Timer bietet die Option "Nur bei Anwesenheit" bzw. "Nur bei Abwesenheit" und greift hierfür auf einen schon vorhandenen Anwesenheitsdatenpunkt zu.
  5. Timer ist ein Wochentimer, jeder Tag kann separat an/ab -gewählt werden.
  6. Timer hat Astrofunktion, bei Auswahl einer Astrofunktion kann hier zusätzlich ein +- Offset angegeben werden.
  7. Timer wird komplett via Vis gesteuert, keinerlei Skriptänderungen nötig um Timer anzulegen, zu löschen oder zu ändern.
  8. Vis zeigt Status der Schaltziele durch Farbwechsel.

WICHTIG!!!

Vorraussetzungen: Den zu schaltenden Geräten/Datenpunkten muss eine Funktion, z.B. "TimerTarget" zugewiesen sein.

Aber nur für den Datenpunkt, nicht den gesamten Channel!!!

timertut1.png

Installation

  1. Wenn noch nicht geschehen, allen gewünschten Zieldatenpunkten eine Funktion zuweisen. Die Funktion muss vorher in den Aufzählungen hinzugefügt werden und könnte z.B. "TimerTarget" lauten. Soll ein anderer Begriff verwendet werden, muss dies dann auch im Script geändert werden. Nach der Zuweisung, bzw. dem anlegen neuer Aufzählungspunkte ist es empfehlenswert die JS Instanz neu zu starten da diese bei Aufzählungsänderungen gerne mal "zickt" was dann zu Skriptfehlern führt.
  2. Das Skript in ein neues JS Projekt kopieren.
  3. Als nächstes (Zeile 9) gebt Ihr den Datenpunkt für An/Abwesenheit an.
    Dieser darf numerische oder boolsche Werte beinhalten. Habt Ihr keinen entsprechenden Datenpunkt tragt "" ein.
  4. Das Script starten.
    Im Hintergrund werden nun alle benötigten Channels und Datenpunkte unter dem Channel der in Zeile 7 angegeben wurde, angelegt. Als default ist das: "javascript.0.Timer".
  5. Ab hier habt Ihr mit dem Skript und der Objektliste nichts mehr zu tun, alles weitere wird via Vis erledigt, ihr solltet nun die beigefügte Vorlage (TimerView.txt) via "Widgets importieren" in Euer Vis Projekt integrieren und die Vis RUNTIME aufrufen. Im Vis Editor habt Ihr nach dem Import nichts mehr zu tun.

Bedienung und Anzeigen des Vis Views

Vorab der Hinweis, dass alle in der Tabelle verwendeten Icons und Farben in den Skript/Tabelleneinstellungen verändert werden können. Wie in all meinen Skripten wird für die Icons der Iconsatz "icons-mfd-svg" verwendet. Ist dieser Satz installiert, so seht Ihr dies in der Liste der installierten Instanzen. Ist er dort nicht aufzufinden solltet Ihr ihn installieren (als Adapter).
Der View besteht im wesentlichen aus zwei Bereichen. Der erste, obere, Bereich mit den Einstellfeldern und den Kontrollelementen für speichern/hinzufügen/löschen von Timern, sowie der Übersichtstabelle unten, in der Ihr alle angelegten Timer und deren Status seht.

Nun zur Funktion der einzelnen Elemente:

  1. Das Listenfeld "Timer" - Hier wählt Ihr aus welchen Timer Ihr mit den nachfolgenden Elementen bearbeiten möchtet. Der gewählte Timer wird zur optischen Bestätigung in der Übersichtstabelle dunkelgelb (ocker) dargestellt.
  2. Der Button "on/off" - Hiermit könnt Ihr den jeweiligen Timer aktivieren oder deaktivieren ohne ihn gleich zu löschen.
  3. Das Listenfeld "Aktion" - hier legt Ihr fest was dieser Timer tun soll. anschalten (true), ausschalten (false) oder umschalten. Die Variante "umschalten" dreht den jeweils aktuellen Status des Datenpunktes um, ist dieser true, wird er auf false gesetzt und umgekehrt. Bitte beachtet das ein kompletter Schaltzyklus von an- und ausschalten aus zwei Timereinträgen besteht! Wählt Ihr die Option "Wert senden", erscheint ein neues Eingabefeld, in dem Ihr den zu sendenden Wert (egal ob Zahl, Text oder Bool) eingebt.
  4. Das Listenfeld "Modus" - Hier wird festgelegt ob der Timer zu einer (im nachfolgenden Feld) eingegebenen Zeit schalten soll, oder ob eine der verfügbaren Astroschaltzeiten (Sonnenaufgang, Sonnenuntergang usw.) verwendet werden soll.
  5. Das Eingabe/Anzeige Feld "Zeit" - Dieses Feld hat zwei unterschiedliche Funktionen/Verhalten, je nachdem was unter Modus eingestellt wurde. Wurde dort als Modus "Zeit" gewählt, so dient dieses Feld zur Eingabe der Schaltzeit. Wurde eine Astrofunktion gewählt wird es zu einem reinen Anzeigefeld in das Ihr nichts eingeben könnt und zeigt Euch die durch die Astrofunktion vorgegebene Schaltzeit an.
  6. Das Eingabefeld "Offset" - Wurde unter Modus eine Astrofunktion gewählt, so könnt Ihr hier eine Offsetzeit ,sowohl positiv als auch negativ, in Minuten angeben. Wurde Modus "Zeit" gewählt ist diese Option nicht verfügbar.
  7. Das Listenfeld "Ziel" - Hier wählt Ihr aus welches Ziel geschaltet werden soll. Die hier vorhandenen Einträge, sind die Namen jener Id's, welche Ihr der Funktion "TimerTarget" zugewiesen habt. Schaltbar ist grundsätzlich alles was mit true/false gesteuert wird, egal ob Lampen, Steckdosen oder auch Skripte, Datenpunkte usw.
  8. Die Buttons der "Tage" - Hiermit legt Ihr fest an welchen Tagen der Timer schaltet (Grün=aktiv, grau=inaktiv).
  9. Der Button "Haus mit Person" - Legt fest das nur bei Anwesenheit geschaltet wird (Grün=aktiv, grau=inaktiv).
    Solltet Ihr keinen Anwesenheitsdatenpunkt eingetragen haben, so ist dieser Button, sowie die zugehörige Spalte in der Übersichtstabelle nicht sichtbar. Skriptintern wird die Anwesenheit auf true gesetzt.
  10. Der Button "Haus leer" - Legt fest das bei nur Abwesenheit geschaltet wird (Grün=aktiv, grau=inaktiv).
    Solltet Ihr keinen Anwesenheitsdatenpunkt eingetragen haben, so ist dieser Button, sowie die zugehörige Spalte in der Übersichtstabelle nicht sichtbar. Skriptintern wird die Anwesenheit auf true gesetzt.
  11. Der Button "Briefumschlag" - Hiermit kannst Du festlegen ob Du über die Aktivitäten dieses Timers benachrichtigt werden möchtest oder nicht. Default ist: benachrichtigen. Setzt voraus dass eine Benachrichtigungvariante grundsätzlich in den Skripteinstellungen aktiviert ist.

Aus Sicherheits/Fehlbedienungs-gründen und um Schreibzugriffe zu minimieren werden geänderte Einstellungen erst gespeichert wenn Ihr dies explizit veranlasst. Hierzu dient:

  1. Der Button "Diskette" - Durch Klick auf diesen werden die getroffenen Einstellungen gespeichert. Dieses wird optisch bestätigt durch kurzen Farbwechsel zu grün und zurück zu grau.

Um einen neuen Timereintrag anzulegen verwendest Du:

  1. Den Button "+" - Ein klick auf diesen Button erzeugt einen neuen Eintrag und setzt den Fokus auf diesen so das Du sofort im Editbereich die gewünschten Werte eintragen kannst. Speichern nicht vergessen!

Zuguterletzt gibt es noch die Möglichkeit den Timer mit dem aktuellen Fokus zu löschen, hierzu dient:

  1. Der Button "Papierkorb" - Um versehentliches Löschen zu erschweren hat dieser Button eine Sicherheitsabfrage. Der erste Klick auf den Button "Papierkorb" läßt dessen Farbe zu rot wechseln, das Symbol wandelt sich zu einem Fragezeichen. Erst ein weiterer Klick, nunmehr auf das Fragezeichen, innerhalb 3 Sekunden, löscht den Eintrag tatsächlich und unwiederbringlich. Läßt Du die 3 Sekunden ohne Klick verstreichen, wandelt sich der Button zurück zum Papierkorb, der Löschmodus wird abgebrochen.

Farben der Übersichtstabelle

Weisser Rahmen zeigt Dir den Eintrag mit aktuellem Fokus. Änderungen im Editbereich würden sich auf genau diese Zeile auswirken. Sobald Du im Editbereich eine erste Änderung vornimmst, wandelt sich der Hintergrund in:

gelb und zeigt Dir damit an das Du bereits eine Änderung vorgenommen hast. Gespeichert wird diese aber, wie oben beschrieben, erst, wenn Du das Diskettensymbol anklickst.

grün dargestellt werden alle Einträge welche einstellungsgemäß eingeschaltet wurden. Wird manuell oder durch einen anderen Timer der Status verändert, wechselt die Zeile wieder zu grau.

rot dargestellt werden alle Einträge welche einstellungsgemäß ausgeschaltet wurden. Wird manuell oder durch einen anderen Timer der Status verändert, wechselt die Zeile wieder zu grau.

schwarz dargestellt werden alle Einträge welche neu bzw. ungültig sind. Dies ist der Fall wenn kein Ziel zugeordnet wurde.

Das wars, viel Spaß.

Changelog

V2.2.0 (18.07.2021)

  • Add: Möglichkeit bedingter Ausführung hinzugefügt. Z.B. Bewässerung um 6.00 starten, aber nur wenn Bodenfeuchte kleiner x.

V2.1.10 (03.05.2021)

  • Fix: Fehlermeldung "...has been written without ack-flag" bei Verwendung des Js Controllers 3.3.x oder höher. Issue: #8

V2.1.9 (08.12.2020)

  • Fix: Beim setzen von Werten wird nun der Datentyp des Zieldatenpunktes vorab geprüft und der Wert nötigenfalls entsprechend konvertiert. Issue: #6

V2.1.8 (22.09.2020)

  • Fix: Problem beim löschen von Timern behoben. (fastfood)

V2.1.7 (26.07.2020)

  • Fix: Problem bei Verwendung des Alias.0 Ordners (keine Namensanzeige) behoben.
  • Add: Möglichkeit in den Einstellungen hinzugefügt statt Channelnamen, Id-Namen zu verwenden.

V2.1.5 (19.07.2020)

  • Add: Option "Wert senden" zu Aktionen, sowie entsprechendes Eingabefeld und Spalte in der Tabelle hinzugefügt.

V2.1.4 (30.06.2020)

  • Fix: Fehler bei noch leeren Timern behoben.

V2.1.2 (20.06.2020)

  • Fix: Fehler abgefangen der auftrat wenn Timerzeit ohne Sekunden angegeben wurde.

V2.1.1 (18.06.2020)

  • Add: Namen der Schaltziele können nun geändert werden. Änderungen werden automatisch mit anderen Timern synchronisiert welche das gleiche Ziel haben, Auswahlliste wird automatisch angepasst. Zusätzliches Eingabefeld (über "Ziel") und Button (rechts neben "Ziel") in Vis Vorlage hinzugefügt.

V2.1.0 (14.06.2020)

  • Fix: Diverse Aktualisierungs und Anzeigefehler für Astro behoben.
  • Fix: Mehrfachaufrufe bestimmter Funktionen korrigiert.
  • Fix: Führende Nullen bei Stundenangabe in Astrofunktionen hinzugefügt.
  • Fix: Korrektur der Astrofunktionen wenn nur bestimmte Tage gewählt wurden.
  • Fix: Doppelauslösungen (nur durch Log oder Nachricht bemerkbar) im Sommerhalbjahr bei Astro korrigiert.
  • Fix: Auflaufen von Schedules korrigiert.

V2.0.7 (02.06.2020)

  • Change: Auswahl der Astrofunktionen auf alle verfügbaren erweitert.
  • Change: Kleine interne Codeänderungen.

V2.0.6 (31.05.2020)

  • Fix: Ausnahmeregel für Namensauflösung von Datenpunkten ohne übergeordnetem Channel hinzugefügt.
  • Fix: Anzeigefehler bei Wechsel von Zeit zu Astrofunktion behoben.

V2.0.5 (30.05.2020)

  • Add: Datenpunkt hinzugefügt der die Zahl der aktivierten Timer zeigt.
  • Add: Abfrage hinzugefügt welche verhindert das Timer ohne Ziel aktiviert werden können, hier wird das speichern verweigert.
  • Add: Timer ohne Ziel werden farblich schwarz markiert.
  • Fix: Farbwechsel in der Tabelle korrigiert.

V2.0.4 (25.05.2020)

  • Add: Schriftgrößen der Tabelle nun im Einstellungsbereich konfigurierbar.
  • Add: Benachrichtigung nun zusätzlich pro Timer aktivier/deaktivier-bar, hierzu zusätzliche Spalte + Button ins Vis eingefügt.
  • Change: Triggerhandling geändert. Farbwechsel in der Tabelle erfolgt nun bei schalten des Timers (rot/grün) und zurückschalten (grau) wodurch auch immer. Alle weiteren Schaltvorgänge von außerhalb werden ignoriert.

V2.0.3 Beta (24.05.2020)

  • Fix: Problem welches zur Warnmeldung:
    "Object javascript.0.Timer.x is invalid: obj.common.type has an invalid value (channel) but has to be one of number, string, boolean, array, object, mixed, file, json" führte behoben.
  • Fix: Async Problem beim hinzufügen neuer Timer behoben welche zur Fehlermeldung:
    "Error in callback: TypeError: Cannot read property '0' of undefined" führten.
  • Fix: Problem mit verbleibenden subscriptions behoben welche zur Fehlermeldung:
    "Error in callback: TypeError: Cannot set property '18' of undefined" führten.

V2.0.2 Beta (23.05.2020)

  • Add: Es ist nun nicht mehr möglich die Schaltung gleichzeitig bei Anwesenheit als auch bei Abwesenheit zu deaktivieren da dies zu "nie" führen würde.

V2.0.2 Beta (23.05.2020)

  • Fix: Trigger für TimerTargets wird jetzt beim speichern korrekt gesetzt/aktualisiert.
  • Add: Meldungen können via Datenpunkt gemutet/deaktiviert werden. Weist Ihr diesem Datenpunkt die Funktion TimerTarget zu, kann dies auch zeitgesteuert geschehen.
  • Add: Meldungen hinzugefügt. Ausgeführte Schaltungen können jetzt via Mail/Telegram/Alexa gemeldet werden.
  • Change: Der fokusierte Timer im Vis hat nun farbigen Rahmen statt Hintergrund.
  • Fix: Presence Datenpunkt defaults geändert.

V2.0.1 Beta (22.05.2020)

  • Add: einige Logpunkte hinzugefügt.

V2.0.0 Beta (22.05.2020)

  • Release V2 Beta

V1.1.2 (07.02.2020)

  • Bugfix: Presence Trigger hinzugefügt.

V1.1.1 (26.01.2020)

  • Add: Readme erstellt

V1.1.0 (18.12.2019)

  • Add: Schaltoptionen "Nur bei Anwesenheit" und "Nur bei Abwesenheit" hinzugefügt.

V1.0.0 (2019-10-28)

  • Initial Release

About

Flexibles Timerscript mit Astrofunktion und Vis für iobroker

Resources

License

Stars

Watchers

Forks

Packages

No packages published