openautomation-svn

[Openautomation-svn] SF.net SVN: openautomation:[735] wiregate/plugin/generic/conf.d/emx_uhr. conf.sample

[<e....@us...>]

Revision: 735
          http://openautomation.svn.sourceforge.net/openautomation/?rev=735&view=rev
Author:   e.max
Date:     2012-03-26 17:11:17 +0000 (Mon, 26 Mar 2012)
Log Message:
-----------
Dokumentation aller erlaubten und gueltigen Zeiteintraege.

Modified Paths:
--------------
    wiregate/plugin/generic/conf.d/emx_uhr.conf.sample

Modified: wiregate/plugin/generic/conf.d/emx_uhr.conf.sample
===================================================================
--- wiregate/plugin/generic/conf.d/emx_uhr.conf.sample	2012-03-26 15:17:41 UTC (rev 734)
+++ wiregate/plugin/generic/conf.d/emx_uhr.conf.sample	2012-03-26 17:11:17 UTC (rev 735)
@@ -6,10 +6,75 @@
 #          'my' hier nicht verwenden!
 #-----------------------------------------------------------------------------
 
+#----------------------------------------------------
+# Hinweis zu den Eintraegen in der '@Zeiten' Tabelle
+# (Bitte auch die nachfolgenden Anmerkungen beachten):
+#----------------------------------------------------
+# Folgende Eintraege werden verarbeitet:
+#  #
+# - Name     Ein beliebiger Text. Ich habe nicht getestst, ob diser Leerstellen 
+#            enthalten darf. Statt dessen besser Unterstriche nehmen oder 
+#            ausprobieren. Dieser Text erscheint im Logfile sofern aktiviert.
+#            Zwingende Angabe.
+# - Aktiv    Wenn null, wird der Eintrag nicht ausgefuehrt.
+#            Wenn nicht definiert, wird 'true' angenommen (Eintrag wird 
+#              ausgefuehrt).
+#            Wahlweise Angabe.
+# - Min  *)  Minute, gueltige Werte 0-59.
+#            Wenn definiert, wird der Eintrag zur angegeben Minute gueltig.
+#            Wenn nicht definiert, ist jede Minute gueltig.
+#            Wahlweise Angabe.#            
+# - Std  *)  Stunde, gueltige Werte 0-23.
+#            Wenn definiert, ist der Eintrag zur angegeben Stunde gueltig.
+#            Wenn nicht definiert, ist jede Stunde gueltig.
+#            Wahlweise Angabe.
+# - MTag *)  Tag des Monats, gueltige Werte 1-31 (abhaengig vom Monat 
+#              natuerlich). 
+#            Wenn definiert, ist der Eintrag am angegegebenen Tag des Monats
+#              gueltig.
+#            Wenn nicht definiert, ist jeder Tag des Monats gueltig.
+#            Wahlweise Angabe.
+# - Mon  *)  Monat, gueltige Werte 1-11.
+#            Wenn definiert, ist der Eintrag im angegegebenen (Monat+1) gueltig.
+#            Wenn nicht definiert, ist jeder Monat gueltig.
+#            Wahlweise Angabe.
+# - WTag *)  Wochentag, gueltige Werte 0-6. 0=Sonntag ... 6=Samstag.
+#            Wenn definiert, ist der Eintragam angegebenen Wochentag gueltig.
+#            Wenn nicht definiert, ist jeder Wochentag gueltig.
+#            Wahlweise Angabe.
+# - Wert     Auf den Bus zu schreibender Wert.
+#            Zwingende Angabe.
+# - DPT      EIB Datentyp.
+#            Zwingende Angabe.
+# - GA       Gruppenadresse in gueltigem Format.
+#            Zwingende Angabe.
+# - Log      Log schreiben. Gueltige Werte: 0 oder 1.
+#            Wenn definiert und ungleich null, wird ein Logeintrag geschrieben
+#              sofern das Telegramm gesendet wurde.
+#            Wenn nicht definiert, wird kein Logeintrag geschrieben.
+#            Wahlweise Angabe.
+#
+# Anmerkungen:
+#
+# - Die Schluesselworte 'Name', 'Aktiv', 'WTag' etc. muessen in exakter 
+#   Gross/Kleinschreibung angegeben werden!
+# - Die Verarbeitung ist auf Werte in einfachen Hochkommata ausgelegt.
+# - Statt fester Werte koennen auch Code-Referenzen angegeben werden.
+#   Ein Beipiel dazu findet sich im knx-user-forum.de unter 
+#   http://knx-user-forum.de/wiregate/14892-zeitschaltuhr-plugin-8.html
+#   Beitrag #76: http://knx-user-forum.de/183739-post76.html
+#
+# *) Es koennen Mehrfachwerte in gemischter Form von Listen und Bereichen 
+#    angegeben werden. z.B: 
+#         Min  => '15,45'           ist fuer Minute 15 und 45 gueltig.
+#         Std  => '0-18,20,23,24'   ist in den Stunden 0 bis 18, 20, 23 und 24 
+#                                     gueltig.
+#         WTag => '1-3,5,6'         ist an den Wochentagen Mo, Di, Mi, Fr und 
+#                                     Sa gueltig.
+
 #------------------------
 # Konfigurierbare Werte
 #------------------------
-
 @Zeiten = 
     ( 
       # Aussenlicht und Aussensteckdosen zyklisch ausschalten

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.

[Openautomation-svn] SF.net SVN: openautomation:[911] wiregate/plugin/generic/conf.d/emx_uhr. conf.sample

[<e....@us...>]

Revision: 911
          http://openautomation.svn.sourceforge.net/openautomation/?rev=911&view=rev
Author:   e.max
Date:     2012-07-06 14:42:12 +0000 (Fri, 06 Jul 2012)
Log Message:
-----------
Zeitzonen eingefuehrt. 

Durch Angabe des neuen Parameters 'Zone' in der @Zeiten Tabelle kann nun festgelegt werden, fuer welche Zeitzone der Schaltzeitpunkt berechnet werden soll.Der Parameter is wahlweise, so dass bisherige conf-Dateien ohne Aenderung weiter verwendet werden koennen. Eine detaillierte Dokumentation findet sich in der conf-Datei, die auch Beipiele enthaelt.

Modified Paths:
--------------
    wiregate/plugin/generic/conf.d/emx_uhr.conf.sample

Modified: wiregate/plugin/generic/conf.d/emx_uhr.conf.sample
===================================================================
--- wiregate/plugin/generic/conf.d/emx_uhr.conf.sample	2012-07-06 14:41:31 UTC (rev 910)
+++ wiregate/plugin/generic/conf.d/emx_uhr.conf.sample	2012-07-06 14:42:12 UTC (rev 911)
@@ -4,15 +4,26 @@
 #-----------------------------------------------------------------------------
 # ACHTUNG: Variablen duerfen nur im Plugin mit 'my' definiert werden,
 #          'my' hier nicht verwenden!
+#
 #-----------------------------------------------------------------------------
-
+# 20120706: Neue Konfigurationsvariablen:
+#
+#           $LokaleZeitZone = "CET";          # lokale Zeitzone
+#           $LokaleSommerZeitZone="CEST";     # lokale Zeitzone im Sommer
+#
+# Die Variablen sind notwendig, um Schaltvorgänge fuer andere Zeitzonen 
+# korrekt berechnen zu koennen.
+#
+# Sofern diese nicht angegeben werden, oder keine conf-Datei existiert, 
+# werden die o.a. Werte angenommen.
+#
 #----------------------------------------------------
 # Hinweis zu den Eintraegen in der '@Zeiten' Tabelle
 # (Bitte auch die nachfolgenden Anmerkungen beachten):
 #----------------------------------------------------
 # Folgende Eintraege werden verarbeitet:
 #  #
-# - Name     Ein beliebiger Text. Ich habe nicht getestst, ob diser Leerstellen 
+# - Name     Ein beliebiger Text. Ich habe nicht getestet, ob dieser Leerstellen
 #            enthalten darf. Statt dessen besser Unterstriche nehmen oder 
 #            ausprobieren. Dieser Text erscheint im Logfile sofern aktiviert.
 #            Zwingende Angabe.
@@ -53,7 +64,34 @@
 #              sofern das Telegramm gesendet wurde.
 #            Wenn nicht definiert, wird kein Logeintrag geschrieben.
 #            Wahlweise Angabe.
+# - Zone     Zeitzone, fuer die die angegebene Zeit stimmen soll.
+#            Wenn nicht angegeben, wird die lokale Zeit angenommen.
+#            Wahlweise Angabe.
 #
+#            Gueltige Zeitzonen-Namen finden sich im Web, z.B. hier:
+#
+#              http://www.timeanddate.com/library/abbreviations/timezones/
+#
+#            Beispiel: 
+#            -  Eine Aktion soll immer dann ausgefuehrt werden, wenn es in 
+#               New-York 12:00 Uhr Mittags ist: 
+#
+#                  { ... Std=>'12', Min=>'0', Zone=>'EST' ... }
+#
+#               wobei die Zeitzone hier 'EST' ist, also 'Eastern Standard Time',
+#               die New-Yorker Zeitzone.
+#            - Eine Aktion soll immer um 17:00 Uhr europäischer Zeit 
+#              ausgefuehrt werden. Die Sommerzeit soll dabei ignoriert werden,
+#              so das im Winter im 12:00 Uhr, im Sommer dagegen erst im 13:00 
+#              Uhr geschaltet wird:
+#
+#                 { ... Std=>'12', Min=>'0', Zone=>'CET' ... }
+#
+#              Da die Aktion immer entsprechend 12:00 CET, also 
+#              'Central European Time' stattfindet, wird das Ereignis im Winter
+#              in Deutschland im 12:00 ausgelöst, im Sommer dagegen um 13:00 
+#              lokaler Zeit.
+#
 # Anmerkungen:
 #
 # - Die Schluesselworte 'Name', 'Aktiv', 'WTag' etc. muessen in exakter 
@@ -75,10 +113,16 @@
 #------------------------
 # Konfigurierbare Werte
 #------------------------
+
+$LokaleZeitZone = "CET";          # lokale Zeitzone
+$LokaleSommerZeitZone="CEST";     # lokale Zeitzone im Sommer
+
 @Zeiten = 
     ( 
       # Aussenlicht und Aussensteckdosen zyklisch ausschalten
       { Name=>'ELW_Terrassenlicht',      Aktiv=>'1', Min=>'0-59', Wert=>'0', DPT=>'1', GA=>'1/5/92', Log=>'1' }, 
+      { Name=>'Keller_Vent', Aktiv=>'1', Std=>'5', Min=>'01', Wert=>'1', DPT=>'1', GA=>'9/2/151', Log=>'1', Zone=>"CET" }, 
+      { Name=>'Keller_Vent', Aktiv=>'1', Std=>'5', Min=>'11', Wert=>'0', DPT=>'1', GA=>'9/2/151', Log=>'1', Zone=>"CET" }, 
     );
 
 #-----------------------------------------------------------------

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.