Feiertagsvariablen im HC2
22. Dezember 2016Leider (oder zum Glück?) sind wir mit der Technologie noch nicht so weit, dass das Home Center eigene Entscheidungen trifft oder gar mitdenkt. Alle Automatismen im Smart Home basieren auf Einsen und Nullen bzw. logischen Abläufen und Bedingungen. So kennt das Home Center einen Kalender, Monate, Tage und so weiter. Alles logische und wiederkehrende Dinge die nahezu überall identisch sind. Sobald es aber individueller wird kommen die Einsen und Nullen schnell an ihre Grenzen. Beispielsweise bei Feiertagen. Diese sind in Deutscland je nach Bundeslang unterschiedlich und fallen auch nicht jedes Jahr auf denselben Tag. In diesem Artikel stelle ich eine Schnittstelle vor, mit deren Hilfe eine Feiertagsvariable im HC2 gefüllt wird.
Feiertagsvariable
Warum Feiertage?
Kalenderdaten in das Home Center zu integrieren ist eine große Herausforderung. Die Daten müssen in einem geeigneten Format geliefert werden um sie mit Lua verarbeiten zu können. Das gängigste Format ist JSON, denn JSON lässt sich schnell und sauber in ein Array bzw. eine Table wandeln und die Daten sicher verwenden.
Aber warum gerade Feiertage? Unsere Feiertage lassen sich mathematisch berechnen, jedoch ist ein Feiertag in Bayern noch lange keiner in Hamburg und schon gar nicht in der Schweiz oder Italien. Für jede Region gibt es individuelle Feiertage. Diese Daten stelle ich ab sofort über eine Webschnittstelle zur Verfügung.
Feiertagsvariable im HC2
Feiertagsvariablen im HC2
Die Feiertage kannst Du nun bequem und ohne viel Aufwand über das Internet beziehen und mit der hier vorgestellten Szene verarbeiten lassen. Es ist weder ein lokaler Webserver notwendig, noch müssen die Feiertage manuell in die Szene eingetragen werden. Lediglich eine Internetverbindung des Home Center ist vorausgesetzt.
Einfach in der Konfiguration der Szene Dein Bundesland hinterlegen und schon kann es losgehen.
|
1 2 3 4 5 6 7 |
APIbl = 'NI' --BW, BY, BE, BB, HB, HH, HE, MV, NI, NRW, RP, SL, SN, ST, SH ,TH gVarStateToday = "holidayToday" gVarNameToday = "holidayTodayName" gVarStateTomorrow = "holidayTomorrow" gVarNameTomorrow = "holidayTomorrowName" advDebug = true version = 'v1.0' |
Kürzel der Bundesländer: BW, BY, BE, BB, HB, HH, HE, MV, NI, NRW, RP, SL, SN, ST, SH ,TH
Scheduler Konfiguration
Der Scheduler lässt sich mit den folgenden Variablen konfigurieren.
|
1 2 3 4 |
--------------------------------------------------- ------------- Timer Config ------------------------ scheduler = true startTime = '00:01' -- Zeitpunkt des Datenabrufs |
- scheduler = Einen Timer aktivieren (true) oder nicht (false)
- startTime = Die Uhrzeit für den Timer im Format (HH:mm)
Ist kein Timer konfiguriert benötigt die Szenen im Header einen Trigger um automatisch ausgeführt zu werden. Weiterhin ist der Autostart zu entfernen. Im Beispiel dient die globale Variable TimeOfDayals Trigger.
|
1 2 3 4 5 6 7 |
--[[ %% properties %% globals TimeOfDay --]] |
Globale Variablen
Weiterhin erstellt die Szene 4 globale Variablen mit den in der Konfiguration hinterlegten Namen (Achtung; unbedingt VOR dem ersten Speichern anpassen). Ich empfehle die Namen unverändert zu lassen, da ich in weiteren Szenen auf diese verweisen werden.
Szene manuell starten
Neben dem Scheduler und möglichen Triggern kann der Abruf der Daten auch manuell erfolgen. Hierfür ist die Anzahl der maximalen Instanzen der Szene auf mindestens 2 zu stellen.
Feiertagsvariable Szenen Konfiguration
Mit der Betätigung des Start-Button in der Konfiguration wird die Szenen gestartet und die Daten von ical2json abgerufen. Der Scheduler bleibt davon unberührt.
Ablauf und Trigger der Szene
Die Szene fragt bei mkshb.de die JSON Daten für das angegebene Bundesland ab und vergleicht anhand der Daten, ob heute und/oder morgen ein Feiertag ist. Wenn dem so ist, werden bis zu 4 globale Variablen gesetzt:
- holidayToday = 1
- holidayTodayName= Name des heutigen Feiertages
- holidayTomorrow = 1
- holidayTomorrowName = Name des morgigen Feiertages
Download
Download “Feiertagsvariable” gVHoliday1_0.zip – 96-mal heruntergeladen – 2 KB
Changelog
Version 0.3 (24.12.2016)
- Bugfix
- Code optimiert
Version 0.4 (26.12.2016)
- Bug korrigiert: Variablen wurde unter bestimmten Bedingungen nicht richtig gesetzt
Version 0.5 (28.12.2016)
- Scheduler Konfiguration hinzugefügt
- Manuelles ausführen ermöglicht
Version 0.6 (28.12.2016)
- „Feiertag morgen“ hinzugefügt
-
Globale Variablen umbenannt
- Bitte vor dem Update die globalen Variablen holidayToday und holidayName löschen
Version 1.0 (21.06.2018)
- Nachdem es immer wieder Probleme mit der Datenbereitstellung gab, verwendet die Szene nun eine öffentliche Quelle für die Abbilung der Feiertage.
Verwendung der Variable
Szenen die mit der Feiertagsvariable gesteuert bzw. von dieser beeinflusst werden:
Feedback
Wie immer freue ich mich über Feedback zur Szene und versuche auf entstehende Probleme einzugehen. Dafür ist die Kommentarfunktion unter dem Artikel schließlich da. Also: Schreibe einen Kommentar, wenn Dir die Szene gefällt, Du Anregungen oder Kritik hast.
Der Autor
Moin, ich heiße Bastian und bin Autor dieser kleinen bescheidenen Seite. Zwanghaft, ja fast schon neurotisch beschäftige ich mich seit Jahren mit jedem erdenklichen technischen Schnick-Schnack. Nichts, was einen Stecker hat ist vor mir sicher. So war es klar, dass ich eines Tages das Haus auf den Kopf stellen und alles vernetzen würde.
Da ich bei meinem Vorhaben sehr viel Hilfe und Unterstützung in diversen Foren, Blogs und Boards erfahren habe, möchte ich diesen Blog zum sammeln meiner Smarthome- und Technikerrungenschaften nutzen um der Community zumindest ein klein wenig was zurückgeben zu können.
Hi,
hilfreich wäre noch die Variable/Info, ob „morgen“ ein Feiertag ist.
Zumindest nutze ich das bei mir für die Rollosteuerung….
VG Hoggle
Hi Hoggle,
sehr gute Idee, vielen Dank! Ich habe es in die Version 0.6 integiert und bereitgestellt.
Gruß
Bastian
Cool – dann müsste ich ja jetzt fast überlegen, ob ich meine aktuelle Szene austausche…..
Ach ich liebe diesen Blog , Danke für die tolle Arbeit Bastian 🙂 Muss das unbedigt umsetzen da die Kaffemaschine immer auch an Feiertagen um 7 Uhr durchläuft, weil ich es wieder verpeilt habe ^^
Hi Chris,
genau für solche Szenarien ist die Szene gedacht. Viel Spaß damit.
Gruß
Bastian
Hallo Bastian,
in BW ist morgen ein Feiertag. Dieser wird in deiner Szene v0.6 bei Feiertag morgen noch nicht angezeigt.
Gruß
Jeff
Hi Jeff,
ich habe meine Szene gerade mal auf BW umgestellt, getestet und der Feiertag wird erfolgreich in die Variable eingetragen.
Zwar stimmt die Codierung des Namens nicht (Heilige Drei Ku00f6nige), aber es wird erfolgreich umgesetzt.
Das Bundesland hast Du aber in der Szene gepflegt, oder?
Gruß
Bastian
[…] zu können muss das HC2 erstmal wissen, ob heute ein Feiertag ist oder nicht. Dafür habe ich eine Szene mit der Anbindung an meinen Webdienst veröffentlicht. Mit Hilfe der gelieferten Daten und daraus generierten globalen Variablen weiß […]
Hallo, habe heute das Script noch mal getestet. Bekomme leider folgenden „Fehler“
[DEBUG] 10:45:25: ——————–START——————————–
[DEBUG] 10:45:25: ——— Feiertagsvariable by mkshb.de ————-
[DEBUG] 10:45:25: ———————————————————–
[DEBUG] 10:45:25: ——— Prüfe globale Variablen
[DEBUG] 10:45:25: ——— Benötigte Variablen sind vorhanden
[DEBUG] 10:45:25: Datenabfrage manuell gestartet
[DEBUG] 10:45:25: Get JSON Data from ical2json@mkshb.de
[DEBUG] 10:45:32: ——————–START——————————–
[DEBUG] 10:45:32: ——— Feiertagsvariable by mkshb.de ————-
[DEBUG] 10:45:32: ———————————————————–
[DEBUG] 10:45:32: ——— Prüfe globale Variablen
[DEBUG] 10:45:32: ——— Benötigte Variablen sind vorhanden
[DEBUG] 10:45:32: Datenabfrage manuell gestartet
[DEBUG] 10:45:32: Get JSON Data from ical2json@mkshb.de
[DEBUG] 10:45:46: error Software caused connection abort
Installiert ist die Version 0.6. Steht der Dienst nicht mehr zur Verfügung?
Morgen schön,
kann es sein, dass das Script für heute (Ostersonntag ) „kein Feiertag“ angibt?
VG Hoggle
Guten Morgen, wenn Du nicht gerade in Brandenburg wohnst, dann ist der Ostersonntag kein Feiertag 😉
Ich hatte SH eingestellt..
Der Ostersonntag ist nur in Brandenburg Feiertag. 😉
ah jetzt – okay…..
Hallo Bastian,
du, wie läuft das mit der json-File? Kannst du die vielleicht zur Verfügung stellen, damit man die Feiertage eigenständig editieren kann? Der Grund ist, dass ich gern auch noch die Ferientage integriert hätte. Damit die Kids in den Ferien ausschlafen können und nicht ständig das Rollo hochfährt etc 😉
Danke schonmal für deine Hilfe
Hallo Eldar,
ich generiere das JSON File mit einer PHP Eigenentwicklung und speichere es in einer MySQL Datenbank, daher kann ich es Dir leider nicht so einfach zur Verfügung stellen. Sorry.
Grüße
Bastian
In NRW stand auch, dass Ostersonntag kein Feiertag ist…aber da Ostersonntag immer nen Sonntag ist, ist es ja egal…ansonsten hat es super funktioniert…nur das Feiertagsheizprogramm hatte zicken gemacht…es schrieb die gespeicherten Daten nicht zurück, nach mehrmaligem neustart des HC2 und nach rausschmiss des HCL als Gateway lief es dann
Hallo Sven,
Danke für Dein Feedback. Das Problem mit dem Ostersonntag ist kein Problem, denn der Ostersonntag ist ausschließlich in Brandenburg ein Feiertag.
Da ich kein HCL als Gateway betreibe, kann ich das Verhalten nicht nachstellen. Wenn Du weitere Erkenntnisse hast, dann immer her damit 😉
Gruß
Bastian
@Bastian…wenn ich wieder mehr Zeit habe, versuche ich es noch mal nach zu stellen, doch derzeit steht erst mal eine Wohnungsrenovierung an und dann möchte Frau und Kind wieder mal was von mir haben. Ich danke dir auf jeden Fall für deine Skripte; nutze schon einige, teilweise abgewandelt für meine Zwecke (kann selber kein Lua, aber aus mehreren Skripten eigene bauen geht schon; Verständnis aus alten Basic-Zeiten 😛 ) Zu dem Thema melde ich mich auf jeden Fall wieder