FHEM/fhem-mirror
2
0
Fork 0
mirror of https://github.com/fhem/fhem-mirror.git synced 2025-04-23 20:52:13 +00:00
Code Issues Releases Wiki Activity

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

Browse Source 
git-svn-id: https://svn.fhem.de/fhem/trunk@4934 2b470e98-0d58-463d-a4d8-8e2adae1ed80
This commit is contained in:
rudolfkoenig 2014-02-15 08:23:12 +00:00
parent 9ca715839f
commit 043281168c
2 changed files with 158 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

117
fhem/FHEM/93_FHEM2FHEM.pm
View File

@ -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
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
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
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
fhem musst be specified with the global option.<br>
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>
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
fhem device <i>devicename</i>, just like if it would be attached to the
local fhem.
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
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

54
fhem/FHEM/98_dummy.pm
View File

@ -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