From 1e3df003af7e031561d1297d63c02bd28bb9bd3e Mon Sep 17 00:00:00 2001
From: rudolfkoenig <rudolfkoenig@2b470e98-0d58-463d-a4d8-8e2adae1ed80>
Date: Thu, 6 Feb 2014 09:08:17 +0000
Subject: [PATCH] FHT8V, at, watchdog: DE translation of the doc

git-svn-id: svn://svn.code.sf.net/p/fhem/code/trunk@4818 2b470e98-0d58-463d-a4d8-8e2adae1ed80
---
 fhem/FHEM/11_FHT8V.pm    |  84 ++++++++++++++++++++++++
 fhem/FHEM/90_at.pm       | 137 ++++++++++++++++++++++++++++++++++++++-
 fhem/FHEM/91_watchdog.pm |  99 ++++++++++++++++++++++++++++
 3 files changed, 319 insertions(+), 1 deletion(-)

diff --git a/fhem/FHEM/11_FHT8V.pm b/fhem/FHEM/11_FHT8V.pm
index 07c018953..5d17496df 100755
--- a/fhem/FHEM/11_FHT8V.pm
+++ b/fhem/FHEM/11_FHT8V.pm
@@ -201,6 +201,90 @@ FHT8V_Get($@)
   <br>
 </ul>
 
+=end html
+
+=begin html_DE
+
+<a name="FHT8V"></a>
+<h3>FHT8V</h3>
+<ul>
+   
+  Fhem kann die Ventile vom Typ FHT8V durch einen <a href="#CUL">CUL</a> 
+  direkt, ohne zwischengeschalteten FHT, ansteuern. Dieser Abschnitt 
+  beschreibt einen der Bausteine, der andere ist das <a href="#PID">PID</a> Device.
+  <br>
+  <br>
+
+  <a name="FHT8Vdefine"></a>
+  <b>Define</b>
+  <ul>
+    <code>define &lt;name&gt; FHT8V &lt;Hauscode&gt; [IODev|FHTID]</code>
+    <br><br>
+
+    <code>&lt;Hauscode&gt;</code> ist eine vierstellige hexadezimale Zahl, die
+    folgende Beziehung zum zust&auml;ndigen CUL-Device aufweisen muss:
+
+    <ul>Bei gegebenem Hauscode des CUL als AABB muss dieser Hauscode die Form CCBB 
+    haben, wobei CC gr&ouml;&szlig;er oder gleich AA, aber kleiner AA+8 sein muss.
+    </ul>
+    
+    Diese Form wurde gew&auml;hlt, damit der CUL alle FHT8V-Ventilstellungen
+    innerhalb von zwei Minuten aktualisieren kann.  <br><br>
+
+    <code>&lt;IODev&gt;</code> mu&szlig; angegeben werden, wenn der als letzter
+    definierte CUL nicht der zust&auml;ndige ist. Normalerweise wird dies mit
+    dem <a href="#IODev">IODev</a>-Attribut gesetzt, da die
+    &Uuml;berpr&uuml;fung der Adresse aber w&auml;hrend der Definition erfolgt,
+    brauchen wir hier eine Ausnahme.  <br>
+
+    Als Alternative kann man die FHTID des zust&auml;ndigen IODev-Ger&auml;tes
+    (anstelle des IODev selbst) setzen. Diese Methode ist n&ouml;tig, wenn man
+    FHT8V &uuml;ber FHEM2FHEM betreibt.  <br>
+
+    Beispiel:
+    <ul>
+      <code>define wz FHT8V 3232</code><br>
+    </ul>
+  </ul>
+  <br>
+
+  <a name="FHT8Vset"></a>
+  <b>Set </b>
+  <ul>
+      <li>set &lt;name&gt; valve &lt;Wert&gt;<br>
+        &Ouml;ffnet das Ventil auf den angegebenen Wert (in Prozent, von 0 bis 100).
+        </li>
+      <li>set &lt;name&gt; pair<br>
+        Verbindet das Ventil mit dem CUL.
+        </li>
+      <li>set &lt;name&gt; decalc<br>
+        Startet einen Entkalkungslauf des angegebenen Ventils.
+        </li>
+  </ul>
+  <br>
+
+  <a name="FHT8Vget"></a>
+  <b>Get </b>
+  <ul>
+      <li>get &lt;name&gt; valve<br>
+      Liest die Ventil&ouml;ffnung aus dem FHT-Puffer des CUL und wandelt sie
+      in Prozent (von 0 bis 100) um.
+      </li>
+  </ul>
+  <br>
+
+  <a name="FHT8Vattr"></a>
+  <b>Attributes</b>
+  <ul>
+    <li><a href="#IODev">IODev</a></li>
+    <li><a href="#dummy">dummy</a></li>
+    <li><a href="#ignore">ignore</a></li>
+    <li><a href="#eventMap">eventMap</a></li><br>
+    <li><a href="#readingFnAttributes">readingFnAttributes</a></li>
+  </ul>
+  <br>
+</ul>
 
 =end html
+
 =cut
diff --git a/fhem/FHEM/90_at.pm b/fhem/FHEM/90_at.pm
index fe307e46f..40f6f5d6e 100755
--- a/fhem/FHEM/90_at.pm
+++ b/fhem/FHEM/90_at.pm
@@ -234,7 +234,7 @@ at_State($$$$)
 <h3>at</h3>
 <ul>
 
-  Start an arbitrary fhem.pl command at a later time.<br>
+  Start an arbitrary FHEM command at a later time.<br>
   <br>
 
   <a name="atdefine"></a>
@@ -355,4 +355,139 @@ at_State($$$$)
 </ul>
 
 =end html
+
+=begin html_DE
+
+<a name="at"></a>
+<h3>at</h3>
+<ul>
+
+  Startet einen beliebigen FHEM Befehl zu einem sp&auml;teren Zeitpunkt.<br>
+  <br>
+
+  <a name="atdefine"></a>
+  <b>Define</b>
+  <ul>
+    <code>define &lt;name&gt; at &lt;timespec&gt; &lt;command&gt;</code><br>
+    <br>
+    <code>&lt;timespec&gt;</code> Format: [+][*{N}]&lt;timedet&gt;<br>
+    <ul>
+      Das optionale <code>+</code> zeigt, dass die Angabe <i>relativ</i> ist 
+      (also zur jetzigen Zeit dazugez&auml;hlt wird).<br>
+
+      Das optionale <code>*</code> zeigt, dass die Ausf&uuml;hrung
+      <i>wiederholt</i> erfolgen soll.<br>
+
+      Das optionale <code>{N}</code> nach dem * bedeutet, dass der Befehl genau
+      <i>N-mal</i> wiederholt werden soll.<br>
+
+      &lt;timedet&gt; ist entweder HH:MM, HH:MM:SS oder {perlfunc()}, wobei
+      perlfunc HH:MM or HH:MM:SS zur&uuml;ckgeben muss. Hinweis: {perlfunc()}
+      darf keine Leerzeichen enthalten.
+
+    </ul>
+    <br>
+
+    Beispiele:
+    <PRE>
+    # Absolute Beispiele:
+    define a1 at 17:00:00 set lamp on                            # fhem Befehl
+    define a2 at 17:00:00 { Log 1, "Teatime" }                   # Perl Befehl
+    define a3 at 17:00:00 "/bin/echo "Teatime" > /dev/console"   # shell Befehl
+    define a4 at *17:00:00 set lamp on                           # Jeden Tag
+
+    # Realtive Beispiele:
+    define a5 at +00:00:10 set lamp on                  # Einschalten in 10 Sekunden
+    define a6 at +00:00:02 set lamp on-for-timer 1      # Einmal blinken in 2 Sekunden
+    define a7 at +*{3}00:00:02 set lamp on-for-timer 1  # Blinke 3 mal
+
+    # Blinke 3 mal wenn  piri einen Befehl sendet
+    define n1 notify piri:on.* define a8 at +*{3}00:00:02 set lamp on-for-timer 1
+
+    # Lampe von Sonnenuntergang bis 23:00 Uhr einschalten
+    define a9 at +*{sunset_rel()} set lamp on
+    define a10 at *23:00:00 set lamp off
+
+    # Elegantere Version, ebenfalls von Sonnenuntergang bis 23:00 Uhr
+    define a11 at +*{sunset_rel()} set lamp on-till 23:00
+
+    # Nur am Wochenende ausf&uuml;hren
+    define a12 at +*{sunset_rel()} { fhem("set lamp on-till 23:00") if($we) }
+
+    # Schalte lamp1 und lamp2 ein von 7:00 bis 10 Minuten nach Sonnenaufgang
+    define a13 at *07:00 set lamp1,lamp2 on-till {sunrise(+600)}
+
+    # Schalte lamp jeden Tag 2 Minuten nach Sonnenaufgang aus
+    define a14 at +{sunrise(+120)} set lamp on
+
+    # Schalte lamp1 zum Sonnenuntergang ein, aber nicht vor 18:00 und nicht nach 21:00
+    define a15 at *{sunset(0,"18:00","21:00")} set lamp1 on
+
+    </PRE>
+
+    Hinweise:<br>
+    <ul>
+      <li>wenn kein <code>*</code> angegeben wird, wird der Befehl nur einmal
+      ausgef&uuml;hrt und der entsprechende <code>at</code> Eintrag danach
+      gel&ouml;scht. In diesem Fall wird der Befehl im Statefile gespeichert
+      (da er nicht statisch ist) und steht nicht im Config-File (siehe auch <a
+      href="#save">save</a>).</li>
+
+      <li>wenn die aktuelle Zeit gr&ouml;&szlig;er ist als die angegebene Zeit,
+      dann wird der Befehl am folgenden Tag ausgef&uuml;hrt.</li>
+
+      <li>F&uuml;r noch komplexere Datums- und Zeitabl&auml;ufe muss man den
+      Aufruf entweder per cron starten oder Datum/Zeit mit perl weiter
+      filtern. Siehe hierzu das letzte Beispiel und das <a href="#perl">Perl
+      special</a>.  </li>
+
+    </ul>
+    <br>
+  </ul>
+
+
+  <a name="atset"></a>
+  <b>Set</b> <ul>N/A</ul><br>
+
+  <a name="atget"></a>
+  <b>Get</b> <ul>N/A</ul><br>
+
+  <a name="atattr"></a>
+  <b>Attribute</b>
+  <ul>
+    <a name="disable"></a>
+    <li>disable<br>
+        Kann f&uuml;r at/watchdog/notify/FileLog Devices gesetzt werden.<br>
+        Deaktiviert das entsprechende at/notify oder FileLog Device. Hinweis:
+        Wenn angewendet auf ein <a href="#at">at</a>, dann wird der Befehl
+        nicht ausgef&uuml;hrt, jedoch die n&auml;chste Ausf&uuml;hrungszeit
+        berechnet.</li><br>
+
+    <a name="skip_next"></a>
+    <li>skip_next<br>
+        Wird bei at Befehlen verwendet um die n&auml;chste Ausf&uuml;hrung zu
+        &uuml;berspringen</li><br>
+
+    <a name="alignTime"></a>
+    <li>alignTime<br>
+        Nur f&uuml;r relative Definitionen: Stellt den Zeitpunkt der
+        Ausf&uuml;hrung des Befehls so, dass er auch zur alignTime
+        ausgef&uuml;hrt wird.  Dieses Argument ist ein timespec. Siehe oben
+        f&uuml; die Definition<br>
+
+        Beispiel:<br>
+        <ul>
+        # Stelle sicher das es gongt wenn eine neue Stunde beginnt.<br>
+        define at2 at +*01:00 set Chime on-for-timer 1<br>
+        attr at2 alignTime 00:00<br>
+        </ul>
+        </li><br>
+
+  </ul>
+  <br>
+
+</ul>
+
+=end html
+
 =cut
diff --git a/fhem/FHEM/91_watchdog.pm b/fhem/FHEM/91_watchdog.pm
index 0541b3983..1ec300929 100755
--- a/fhem/FHEM/91_watchdog.pm
+++ b/fhem/FHEM/91_watchdog.pm
@@ -235,5 +235,104 @@ watchdog_Undef($$)
   <br>
 </ul>
 
+=end html
+
+=begin html_DE
+
+<a name="watchdog"></a>
+<h3>watchdog</h3>
+<ul>
+  <br>
+
+  <a name="watchdogdefine"></a>
+  <b>Define</b>
+  <ul>
+    <code>define &lt;name&gt; watchdog &lt;regexp1&gt; &lt;timespec&gt;
+    &lt;regexp2&gt; &lt;command&gt;</code><br>
+    <br>
+
+    Startet einen beliebigen fhem.pl Befehl wenn nach dem Empfang des
+    Ereignisses &lt;regexp1&gt; nicht innerhalb von &lt;timespec&gt; ein
+    &lt;regexp2&gt; Ereignis empfangen wird.<br>
+
+    Der Syntax f&uuml;r &lt;regexp1&gt; und &lt;regexp2&gt; ist der gleiche wie
+    regexp f&uuml;r <a href="#notify">notify</a>.<br>
+
+    &lt;timespec&gt; ist HH:MM[:SS]<br>
+
+    &lt;command&gt; ist ein gew&ouml;hnlicher fhem Befehl wie z.B. in <a
+    href="#at">at</a> oderr <a href="#notify">notify</a>
+    <br><br>
+
+    Beispiele:
+    <code><ul>
+    # Frage Daten vom FHT80 _einmalig_ ab, wenn wir keine Nachricht f&uuml;r<br>
+    # 15 Minuten erhalten haben.<br>
+    define w watchdog FHT80 00:15:00 SAME set FHT80 date<br><br>
+
+    # Frage Daten vom FHT80 jedes Mal ab, wenn keine Nachricht f&uuml;r<br>
+    # 15 Minuten emfpangen wurde, d.h. reaktiviere den Watchdog nachdem er
+    getriggert wurde.<br>
+
+    # Kann gef&auml;hrlich sein, da er so in einer Schleife getriggert werden
+    kann.<br>
+    define w watchdog FHT80 00:15:00 SAME set FHT80 date;; trigger w .<br><br>
+
+    # Alarmiere einmalig wenn vom FHT80 f&uuml;r 15 Minuten keine Nachricht
+    # emfpangen wurde.<br>
+    define w watchdog HMS100-FIT 01:00:00 SAME "alarm-fit.sh"<br><br>
+
+    # Sende eine Mail wenn das Fenster offen gelassen wurde<br>
+    define w watchdog contact1:open 00:15 contact1:closed "mail_me close
+    window1"<br>
+    attr w regexp1WontReactivate<br><br>
+    </ul></code>
+
+    Hinweise:<br>
+    <ul>
+      <li>Wenn &lt;regexp1&gt; . (Punkt) ist, dann aktiviere den Watchdog zur
+      definierten Zeit.  Sonst wird er durch den Empfang des ersten passenden
+      Events aktiviert.</li>
+
+      <li>&lt;regexp1&gt; Resetet den Timer eines laufenden Watchdogs. Um das
+      zu verhindern wird das regexp1WontReactivate Attribut gesetzt.</li>
+
+      <li>Wenn &lt;regexp2&gt; SAME ist , dann ist es das gleiche wie das erste
+      regexp, und wird reaktiviert wenn es empfangen wird.  </li>
+
+      <li>trigger &lt;watchdogname&gt; . aktiviert den Trigger wenn dessen
+      Status defined ist und setzt ihn in den Status defined wenn sein status
+      triggered ist.<br>
+
+      Der Watchdog musst immer mit diesem Befehl reaktiviert werden wenn er
+      getriggert wurde.</li>
+
+      <li>Ein generischer Watchdog (ein Watchdog, verantwortlich f&uuml;r
+      mehrere Devices) ist derzeit nicht m&ouml;glich.</li>
+
+    </ul>
+
+    <br>
+  </ul>
+
+  <a name="watchdogset"></a>
+  <b>Set</b> <ul>N/A</ul><br>
+
+  <a name="watchdogget"></a>
+  <b>Get</b> <ul>N/A</ul><br>
+
+  <a name="watchdogattr"></a>
+  <b>Attributes</b>
+  <ul>
+    <li><a href="#disable">disable</a></li>
+    <li><a name="regexp1WontReactivate">regexp1WontReactivate</a><br>
+        Wenn ein Watchdog aktiv ist, wird ein zweites Ereignis das auf regexp1
+        passt normalerweise den Timer zur&uuml;cksetzen. Dieses Attribut wird
+        das verhindern.
+    </li>
+  </ul>
+  <br>
+</ul>
+
 =end html
 =cut