FHEM2FHEM/dummy: german doc added (thanks to Stefan)

git-svn-id: https://svn.fhem.de/fhem/trunk@4934 2b470e98-0d58-463d-a4d8-8e2adae1ed80

fhem/FHEM/93_FHEM2FHEM.pm

@@ -301,7 +301,7 @@ FHEM2FHEM_SimpleRead($)
 <a name="FHEM2FHEM"></a>
 <h3>FHEM2FHEM</h3>
 <ul>
-  FHEM2FHEM is a helper module to connect separate fhem installations.
+  FHEM2FHEM is a helper module to connect separate FHEM installations.
   <br><br>
   <a name="FHEM2FHEMdefine"></a>
   <b>Define</b>
@@ -310,19 +310,19 @@ FHEM2FHEM_SimpleRead($)
     </code>
   <br>
   <br>
-  Connect to the <i>remote</i> fhem on &lt;host&gt;. &lt;portnr&gt; is a telnet
+  Connect to the <i>remote</i> FHEM on &lt;host&gt;. &lt;portnr&gt; is a telnet
-  port on the remote fhem, defaults to 7072. The optional :SSL suffix is
+  port on the remote FHEM, defaults to 7072. The optional :SSL suffix is
-  needed, if the remote fhem configured SSL for this telnet port. In this case
+  needed, if the remote FHEM configured SSL for this telnet port. In this case
   the IO::Socket::SSL perl module must be installed for the local host too.<br>
 
-  Note: if the remote fhem is on a separate host, the telnet port on the remote
+  Note: if the remote FHEM is on a separate host, the telnet port on the remote
-  fhem musst be specified with the global option.<br>
+  FHEM musst be specified with the global option.<br>
 
   The next parameter specifies the connection
   type:
   <ul>
   <li>LOG<br>
-    Using this type you will receive all events generated by the remote fhem,
+    Using this type you will receive all events generated by the remote FHEM,
     just like when using the <a href="#inform">inform on</a> command, and you
     can use these events just like any local event for <a
     href="#FileLog">FileLog </a> or <a href="#notify">notify</a>.
@@ -330,20 +330,20 @@ FHEM2FHEM_SimpleRead($)
     see the notify definition.<br>
     Drawbacks: the remote devices wont be created locally, so list wont
     show them and it is not possible to manipulate them from the local
-    fhem. It is possible to create a device with the same name on both fhem
+    FHEM. It is possible to create a device with the same name on both FHEM
     instances, but if both of them receive the same event (e.g. because both
     of them have a CUL attached), then all associated FileLogs/notifys will be
     triggered twice.  </li>
 
   <li>RAW<br>
-    By using this type the local fhem will receive raw events from the remote
+    By using this type the local FHEM will receive raw events from the remote
-    fhem device <i>devicename</i>, just like if it would be attached to the
+    FHEM device <i>devicename</i>, just like if it would be attached to the
-    local fhem.
+    local FHEM.
     Drawback: only devices using the Dispatch function (CUL, FHZ, CM11,
     SISPM, RFXCOM, TCM, TRX, TUL) generate raw messages, and you must create a
     FHEM2FHEM instance for each remote device.<br>
     <i>devicename</i> must exist on the local
-    fhem server too with the same name and same type as the remote device, but
+    FHEM server too with the same name and same type as the remote device, but
     with the device-node "none", so it is only a dummy device. 
     All necessary attributes (e.g. <a href="#rfmode">rfmode</a> if the remote
     CUL is in HomeMatic mode) must also be set for the local device.
@@ -380,6 +380,97 @@ FHEM2FHEM_SimpleRead($)
 
 </ul>
 
-
 =end html
+
+=begin html_DE
+
+<a name="FHEM2FHEM"></a>
+<h3>FHEM2FHEM</h3>
+<ul>
+   FHEM2FHEM ist ein Hilfsmodul, um mehrere FHEM-Installationen zu verbinden.
+   <br><br>
+   <a name="FHEM2FHEMdefine"></a>
+   <b>Define</b>
+   <ul>
+    <code>define &lt;name&gt; FHEM2FHEM &lt;host&gt;[:&lt;portnr&gt;][:SSL] [LOG:regexp|RAW:devicename] {portpassword}
+    </code>
+   <br>
+   <br>
+    Zum <i>remote (entfernten)</i> FHEM auf Rechner &lt;host&gt; verbinden.
+    &lt;portnr&gt; ist der telnetPort des remote FHEM, Standardport ist 7072.
+    Der Zusatz :SSL wird ben&ouml;tigt, wenn das remote FHEM
+    SSL-Verschl&uuml;sselung voraussetzt.  Auch auf dem lokalen Host muss dann
+    das Perl-Modul IO::Socket::SSL installiert sein.<br>
+
+   Anmerkung: Wenn das remote FHEM auf einem eigenen Host l&auml;uft, muss
+   "telnetPort" des remote FHEM als global festgelegt sein.  <br>
+
+   Der n&auml;chste Parameter spezifiziert den Verbindungs-Typ:
+   <ul>
+   <li>LOG<br>
+    Bei Verwendung dieses Verbindungstyps werden alle Ereignisse (Events) der
+    remote FHEM-Installation empfangen.  Die Ereignisse sehen aus wie die, die
+    nach <a href="#inform">inform on</a> Befehl erzeugt werden. Sie k&ouml;nnen
+    wie lokale Ereignisse durch <a href="#FileLog">FileLog </a> oder <a
+    href="#notify">notify</a> genutzt werden und mit einem regul&auml;ren
+    Ausdruck gefiltert werden. Die Syntax daf&uuml;r ist unter der
+    notify-Definition beschrieben.<br>
+
+    Einschr&auml;nkungen: die Ger&auml;te der remote Installation werden nicht
+    lokal angelegt und k&ouml;nnen weder mit list angezeigt noch lokal
+    angesprochen werden.  Auf beiden FHEM-Installationen k&ouml;nnen
+    Ger&auml;te gleichen Namens angelegt werden, aber wenn beide dasselbe
+    Ereignis empfangen (z.B. wenn an beiden Installationen CULs angeschlossen
+    sind), werden alle FileLogs und notifys doppelt ausgel&ouml;st.  </li>
+
+   <li>RAW<br>
+    Bei diesem Verbindungstyp werden unaufbereitete Ereignisse (raw messages)
+    des remote FHEM-Ger&auml;ts <i>devicename</i> genau so empfangen, als
+    w&auml;re das Ger&auml;t lokal verbunden.<br>
+
+    Einschr&auml;nkungen: nur Ger&auml;te, welche die "Dispatch-Funktion"
+    unterst&uuml;tzen (CUL, FHZ, CM11, SISPM, RFXCOM, TCM, TRX, TUL) erzeugen
+    raw messages, und f&uuml;r jedes entfernte Ger&auml;t muss ein eigenes
+    FHEM2FHEM Objekt erzeugt werden.<br>
+
+    <i>devicename</i> muss mit demselben Namen und Typ wie das Remote Devive
+    angelegt sein, aber als Dummy, d.h. als device-node "none".
+    Zus&auml;tzlich m&uuml;ssen alle notwendigen Attribute lokal gesetzt sein
+    (z.B. <a href="#rfmode">rfmode</a>, wenn die remote CUL im HomeMatic-Modus
+    l&auml;uft).  Die Verwendung bereits bestehender lokaler Ger&auml;te ist zu
+    vermeiden, weil sonst die Duplikatsfilterung nicht richtig funktioniert
+    (siehe dupTimeout).  </li>
+
+   </ul>
+   Der letzte Parameter enth&auml;lt das Passwort des Remote-Servers, wenn dort
+   eines aktiviert ist <a href="#portpassword">portpassword</a>.
+
+   <br>
+   Beispiele:
+   <ul>
+     <code>define ds1 FHEM2FHEM 192.168.178.22:7072 LOG:.*</code><br>
+     <br>
+     <code>define RpiCUL CUL none 0000</code><br>
+     <code>define ds2 FHEM2FHEM 192.168.178.22:7072 RAW:RpiCUL</code><br> und auf dem RPi (192.168.178.22):<br>
+     <code>rename CUL_0 RpiCUL</code><br>
+   </ul>
+   </ul>
+   <br>
+
+   <a name="FHEM2FHEMset"></a>
+   <b>Set</b> <ul>N/A</ul><br>
+
+   <a name="FHEM2FHEMget"></a>
+   <b>Get</b> <ul>N/A</ul><br>
+
+   <a name="FHEM2FHEMattr"></a>
+   <b>Attributes</b>
+   <ul>
+     <li><a href="#dummy">dummy</a></li>
+   </ul>
+
+</ul>
+
+=end html_DE
+
 =cut

fhem/FHEM/98_dummy.pm

@@ -96,4 +96,58 @@ dummy_Define($$)
 </ul>
 
 =end html
+
+=begin html_DE
+
+<a name="dummy"></a>
+<h3>dummy</h3>
+<ul>
+
+  Definiert eine Pseudovariable, der mit <a href="#set">set</a> jeder beliebige
+  Wert zugewiesen werden kann.  Sinnvoll zum Programmieren.
+  <br><br>
+
+  <a name="dummydefine"></a>
+  <b>Define</b>
+  <ul>
+    <code>define &lt;name&gt; dummy</code>
+    <br><br>
+
+    Beispiel:
+    <ul>
+      <code>define myvar dummy</code><br>
+      <code>set myvar 7</code><br>
+    </ul>
+  </ul>
+  <br>
+
+  <a name="dummyset"></a>
+  <b>Set</b>
+  <ul>
+    <code>set &lt;name&gt; &lt;value&gt</code><br>
+    Weist einen Wert zu.
+  </ul>
+  <br>
+
+  <a name="dummyget"></a>
+  <b>Get</b> <ul>N/A</ul><br>
+
+  <a name="dummyattr"></a>
+  <b>Attributes</b>
+  <ul>
+    <li><a name="setList">setList</a><br>
+        Liste mit Werten durch Leerzeichen getrennt. Diese Liste wird mit "set
+        name ?" ausgegeben.  Damit kann das FHEMWEB-Frontend Auswahl-Men&uuml;s
+        oder Schalter erzeugen.<br>
+        Beispiel: attr dummyName setList on off
+
+        </li>
+    <li><a href="#readingFnAttributes">readingFnAttributes</a></li>
+  </ul>
+  <br>
+
+</ul>
+
+=end html_DE
+
 =cut