mirror of
https://github.com/fhem/fhem-mirror.git
synced 2025-05-04 22:19:38 +00:00
notify: german doc
git-svn-id: https://svn.fhem.de/fhem/trunk/fhem@5470 2b470e98-0d58-463d-a4d8-8e2adae1ed80
This commit is contained in:
rudolfkoenig
parent
6c76c250bc
commit
649a9c706c
@ -139,7 +139,6 @@ notify_Attr(@)
|
||||
<code>define b3lampV3 notify btn3 "/usr/local/bin/setlamp "$EVENT""</code><br>
|
||||
<code>define b3lampV3 notify btn3 set lamp1 $EVENT;;set lamp2 $EVENT</code><br>
|
||||
<code>define wzMessLg notify wz:measured.* "/usr/local/bin/logfht $NAME "$EVENT""</code><br>
|
||||
<!-- <code>define LogHToDB notify .*H:.* {DbLog("$NAME","$EVENT")}</code><br> -->
|
||||
<code>define LogUndef notify global:UNDEFINED.* "send-me-mail.sh "$EVENT""</code><br>
|
||||
</ul>
|
||||
<br>
|
||||
@ -191,12 +190,12 @@ notify_Attr(@)
|
||||
definition.</li>
|
||||
</ul></li>
|
||||
|
||||
<li>To use database logging, define a dblog instance and change the
|
||||
$dbconn parameter in the file.</li>
|
||||
|
||||
<li>Following special events will be generated for the device "global"
|
||||
<ul>
|
||||
<li>INITIALIZED after initialization is finished.</li>
|
||||
<li>REREADCFG after the configuration is reread.</li>
|
||||
<li>SAVE before the configuration is saved.</li>
|
||||
<li>SHUTDOWN before FHEM is shut down.</li>
|
||||
<li>DEFINED <devname> after a device is defined.</li>
|
||||
<li>DELETED <devname> after a device was deleted.</li>
|
||||
<li>RENAMED <old> <new> after a device was renamed.</li>
|
||||
@ -261,4 +260,183 @@ notify_Attr(@)
|
||||
</ul>
|
||||
|
||||
=end html
|
||||
|
||||
=begin html_DE
|
||||
|
||||
<a name="notify"></a>
|
||||
<h3>notify</h3>
|
||||
<ul>
|
||||
<br>
|
||||
|
||||
<a name="notifydefine"></a>
|
||||
<b>Define</b>
|
||||
<ul>
|
||||
<code>define <name> notify <Suchmuster> <Anweisung></code>
|
||||
<br><br>
|
||||
Führt eine oder mehrere Anweisungen aus, wenn ein Event generiert
|
||||
wurde, was dem <Suchmuster> (Gerätename oder
|
||||
Gerätename:Event) entspricht.
|
||||
|
||||
Die Anweisung ist einer der FHEM <a href="#command">Befehlstypen</a>.
|
||||
Zum Test dient das <a href="#trigger">trigger</a>-Kommando.
|
||||
<br><br>
|
||||
|
||||
Beispiele:
|
||||
<ul>
|
||||
<code>define b3lampV1 notify btn3 set lamp $EVENT</code><br>
|
||||
<code>define b3lampV2 notify btn3 { fhem "set lamp $EVENT" }</code><br>
|
||||
<code>define b3lampV3 notify btn3 "/usr/local/bin/setlamp
|
||||
"$EVENT""</code><br>
|
||||
|
||||
<code>define b3lampV3 notify btn3 set lamp1 $EVENT;;set lamp2
|
||||
$EVENT</code><br>
|
||||
|
||||
<code>define wzMessLg notify wz:measured.* "/usr/local/bin/logfht $NAME
|
||||
"$EVENT""</code><br>
|
||||
|
||||
<code>define LogUndef notify global:UNDEFINED.* "send-me-mail.sh
|
||||
"$EVENT""</code><br>
|
||||
|
||||
</ul>
|
||||
<br>
|
||||
|
||||
Hinweise:
|
||||
<ul>
|
||||
<li><code><Suchmuster></code> ist entweder der Name des
|
||||
auslösenden ("triggernden") Gerätes oder die Kombination aus
|
||||
Gerät und auslösendem Ereignis (Event)
|
||||
<code>Gerätename:Event</code>.</li>
|
||||
|
||||
<li>Das <code><Suchmuster></code> muss exakt (!)
|
||||
entweder dem Gerätenamen entsprechen oder der Zusammenfügung
|
||||
aus Gerätename:Event. Events lassen sich mit "inform" in Telnet
|
||||
oder durch Beobachtung des "Event-Monitors" in FHEMWEB ermitteln.</li>
|
||||
|
||||
<li>In der Anweisung von Notify kann das auslösende Ereignis (Event)
|
||||
genutzt werden:
|
||||
|
||||
<ul>
|
||||
<li>Die Anweisung $EVENT wird das komplette Ereignis (Event)
|
||||
beinhalten, z.B. <code>measured-temp: 21.7 (Celsius)</code></li>
|
||||
|
||||
<li>$EVTPART0,$EVTPART1,$EVTPART2,etc enthalten die durch Leerzeichen
|
||||
getrennten Teile des Events der Reihe nach (im Beispiel also
|
||||
<code>$EVTPART0="measured-temp:", $EVTPART1="21.7",
|
||||
$EVTPART2="(Celsius)"</code>.<br> Diese Daten sind verfügbar
|
||||
als lokale Variablen in Perl, als Umgebungs-Variablen für
|
||||
Shell-Scripts, und werden als Text ausgetauscht in
|
||||
FHEM-Kommandos.</li>
|
||||
|
||||
<li>$NAME enthält den Namen des Ereignis auslösenden
|
||||
Gerätes, z.B. <code>myFht</code></li>
|
||||
</ul></li>
|
||||
|
||||
<li>Achtung: Folgende Vorgehensweise ist abgekündigt und wird in
|
||||
einem zukünftigen Release von FHEM nicht mehr unterstützt.
|
||||
Wenn keine der oben genannten Variablen ($NAME/$EVENT/usw.) in der
|
||||
Anweisung gefunden wird, werden Platzhalter ersetzt.
|
||||
|
||||
<ul>
|
||||
<li>Das Zeichen <code>%</code> wird ersetzt mit dem empfangenen
|
||||
Ereignis (Event), z.B. mit <code>on</code> oder <code>off</code> oder
|
||||
<code>measured-temp: 21.7 (Celsius)</code>.
|
||||
</li>
|
||||
|
||||
<li>Das Zeichen <code>@</code> wird ersetzt durch den
|
||||
Gerätenamen.</li>
|
||||
|
||||
<li>Um % oder @ im Text selbst benutzen zu können, müssen
|
||||
sie verdoppelt werden (%% oder @@).</li>
|
||||
|
||||
<li>Anstelle von <code>%</code> und <code>@</code>, können die
|
||||
Parameter <code>%EVENT</code> (funktionsgleich mit <code>%</code>),
|
||||
<code>%NAME</code> (funktionsgleich mit <code>@</code>) und
|
||||
<code>%TYPE</code> (enthält den Typ des Gerätes, z.B.
|
||||
<code>FHT</code>) benutzt werden. Die von Leerzeichen unterbrochenen
|
||||
Teile eines Ereignisses (Event) sind verfügbar als %EVTPART0,
|
||||
%EVTPART1, usw. Ein einzeln stehendes <code>%</code> verliert seine
|
||||
%oben beschriebene Bedeutung, falls auch nur einer dieser Parameter
|
||||
%in der Definition auftaucht.</li>
|
||||
|
||||
</ul></li>
|
||||
|
||||
<li>Folgende spezielle Ereignisse werden für das Gerät "global"
|
||||
erzeugt:
|
||||
<ul>
|
||||
<li>INITIALIZED sobald die Initialization vollständig ist.</li>
|
||||
<li>REREADCFG nachdem die Konfiguration erneut eingelesen wurde.</li>
|
||||
<li>SAVE bevor die Konfiguration gespeichert wird.</li>
|
||||
<li>SHUTDOWN bevor FHEM heruntergefahren wird.</li>
|
||||
<li>DEFINED <devname> nach dem Definieren eines
|
||||
Gerätes.</li>
|
||||
<li>DELETED <devname> nach dem Löschen eines
|
||||
Gerätes.</li>
|
||||
<li>RENAMED <old> <new> nach dem Umbenennen eines
|
||||
Gerätes.</li>
|
||||
<li>UNDEFINED <defspec> beim Auftreten einer Nachricht für
|
||||
ein undefiniertes Gerät.</li>
|
||||
</ul></li>
|
||||
|
||||
<li>Notify kann dazu benutzt werden, um Makros für eine manuelle
|
||||
Ausführung zu speichern. Mit einem <a
|
||||
href="#trigger">trigger</a> Kommando können solche Makros dann
|
||||
ausgeführt werden. Z.B.<br> <code>fhem> define MyMacro notify
|
||||
MyMacro { Log 1, "Hello"}</code><br> <code>fhem> trigger
|
||||
MyMacro</code><br> </li>
|
||||
|
||||
</ul>
|
||||
</ul>
|
||||
<br>
|
||||
|
||||
|
||||
<a name="notifyset"></a>
|
||||
<b>Set</b> <ul>N/A</ul><br>
|
||||
|
||||
<a name="notifyget"></a>
|
||||
<b>Get</b> <ul>N/A</ul><br>
|
||||
|
||||
<a name="notifyattr"></a>
|
||||
<b>Attribute</b>
|
||||
<ul>
|
||||
<li><a href="#disable">disable</a></li>
|
||||
<a name="forwardReturnValue"></a>
|
||||
<li>forwardReturnValue<br>
|
||||
Rückgabe der Werte eines ausgeführten Kommandos an den
|
||||
Aufrufer. Die Voreinstellung ist 0 (ausgeschaltet), um weniger
|
||||
Meldungen im Log zu haben.
|
||||
</li>
|
||||
|
||||
<li>showTriggerTime<br/>
|
||||
Zeigt den Zeitstempel der letzten Ausführung als Status an.
|
||||
Voreinstellung ist 1 (an).
|
||||
</li>
|
||||
|
||||
<a name="addStateEvent"></a>
|
||||
<li>addStateEvent<br>
|
||||
Das mit dem state Reading verknüpfte Event ist speziell, da das
|
||||
dazugehörige Prefix "state: " entfernt wird, d.h. $EVENT ist nicht
|
||||
"state: on", sondern nur "on". In manchen Fällen ist es aber
|
||||
erwünscht ein zusätzliches Event zu bekommen, wo "state: " nicht
|
||||
entfernt ist. Für diese Fälle sollte addStateEvent auf 1
|
||||
gesetzt werden, die Voreinstellung ist 0 (deaktiviert).<br>
|
||||
|
||||
Achtung:
|
||||
<ul>
|
||||
<li>dieses Attribut muss beim Empfänger (notify, FileLog, etc)
|
||||
gesetzt werden.</li>
|
||||
|
||||
<li>dieses Attribut zeigt nur für solche Geräte-Events eine
|
||||
Wirkung, die <a href="#readingFnAttributes">readingFnAttributes</a>
|
||||
unterstützen.</li>
|
||||
|
||||
</ul>
|
||||
|
||||
</li>
|
||||
</ul>
|
||||
<br>
|
||||
|
||||
</ul>
|
||||
|
||||
=end html_DE
|
||||
|
||||
=cut
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user