mirror of
https://github.com/fhem/fhem-mirror.git
synced 2025-01-31 12:49:34 +00:00
commandref_frame.html: Attribute rewrite by Boris + some reformatting by me (Forum #27451)
git-svn-id: https://svn.fhem.de/fhem/trunk@6671 2b470e98-0d58-463d-a4d8-8e2adae1ed80
This commit is contained in:
rudolfkoenig
parent
f22f82b909
commit
9b06a6dbfe
@ -29,6 +29,7 @@
|
|||||||
<a href="#intro">Introduction</a><br>
|
<a href="#intro">Introduction</a><br>
|
||||||
<a href="#command">Fhem command types</a><br>
|
<a href="#command">Fhem command types</a><br>
|
||||||
<a href="#devspec">Device specification</a><br>
|
<a href="#devspec">Device specification</a><br>
|
||||||
|
<a href="#attributes">Attributes</a><br>
|
||||||
|
|
||||||
<br>
|
<br>
|
||||||
<b>Fhem commands</b>
|
<b>Fhem commands</b>
|
||||||
@ -314,7 +315,7 @@ A line ending with \ will be concatenated with the next one, so long lines
|
|||||||
<li>the spec may not contain space characters.</n>
|
<li>the spec may not contain space characters.</n>
|
||||||
<li>if there is a device which exactly corresponds to the spec, then
|
<li>if there is a device which exactly corresponds to the spec, then
|
||||||
no special processing is done.</li>
|
no special processing is done.</li>
|
||||||
<li>first the spec is separated by komma, then the regular expression and
|
<li>first the spec is separated by comma, then the regular expression and
|
||||||
filter operations are executed.</li>
|
filter operations are executed.</li>
|
||||||
<li>the returned list can contain the same device more than once, so
|
<li>the returned list can contain the same device more than once, so
|
||||||
"set lamp3,lamp3 on" switches lamp3 twice.</li>
|
"set lamp3,lamp3 on" switches lamp3 twice.</li>
|
||||||
@ -323,30 +324,44 @@ A line ending with \ will be concatenated with the next one, so long lines
|
|||||||
</ul>
|
</ul>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
<a name="help"></a>
|
|
||||||
<h3>?, help</h3>
|
<a name="attributes"></a>
|
||||||
|
<h3>Attributes</h3>
|
||||||
|
|
||||||
|
All devices have attributes. These can be set by means of the <a
|
||||||
|
href="#attr">attr</a> command, displayed with the <a
|
||||||
|
href="#displayattr">displayattr</a> command, and deleted by the <a
|
||||||
|
href="#deleteattr">deleteattr</a> command.<p>
|
||||||
|
|
||||||
|
There are global attributes that are used by all devices and local attributes
|
||||||
|
that apply to individual device classes only.<p>
|
||||||
|
|
||||||
|
Some devices (like <a href="#FHEMWEB">FHEMWEB</a>) automatically define new
|
||||||
|
global attributes on the first definition of a device of such type.<p>
|
||||||
|
|
||||||
|
You can use the command <p><code>attr global userattr
|
||||||
|
<attributelist></code><p> for the <a href="#global">global</a> device to
|
||||||
|
declare new global attributes and <p><code>attr <devicespec> userattr
|
||||||
|
<attributelist></code><p> for individual devices according to <a
|
||||||
|
href="#devspec">devspec</a> to declare new local attributes.
|
||||||
|
|
||||||
|
<code><attributelist></code> is a space-separated list which contains the
|
||||||
|
names of the additional attributes. See the documentation of the <a
|
||||||
|
href="#attr">attr</a> command for examples.<p>
|
||||||
|
|
||||||
|
Be careful not to overwrite additional global attributes previously defined by
|
||||||
|
yourself or a device. Use the <code>attr global userattr
|
||||||
|
<attributelist></code> as early in your configuration as possible.
|
||||||
|
|
||||||
|
<h4>Device specific attributes</h4>
|
||||||
|
|
||||||
|
Device specific attributes are documented in the corresponding device section.
|
||||||
|
|
||||||
|
|
||||||
|
<h4>Global attributes used by all devices</h4>
|
||||||
|
|
||||||
<ul>
|
<ul>
|
||||||
<code>?</code><br>
|
|
||||||
<code>help</code><br>
|
|
||||||
<br>
|
|
||||||
Get a list of all commands and short description for each one
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<a name="attr"></a>
|
|
||||||
<h3>attr</h3>
|
|
||||||
<ul>
|
|
||||||
<code>attr <devspec> <attrname> [<value>] </code><br>
|
|
||||||
|
|
||||||
<br>Set an attribute for a device defined by <a href="#define">define</a>.
|
|
||||||
You can define your own attributes too to use them in other applications.
|
|
||||||
|
|
||||||
Use "attr <name> ?" to get a list of possible attributes.
|
|
||||||
See the <a href="#devspec">Device specification</a> section for details on
|
|
||||||
<devspec>.
|
|
||||||
<br><br>
|
|
||||||
|
|
||||||
Attributes used by all devices:
|
|
||||||
<ul>
|
|
||||||
<a name="verbose"></a>
|
<a name="verbose"></a>
|
||||||
<li>verbose<br>
|
<li>verbose<br>
|
||||||
Set the verbosity level. Possible values:
|
Set the verbosity level. Possible values:
|
||||||
@ -365,10 +380,12 @@ A line ending with \ will be concatenated with the next one, so long lines
|
|||||||
<a name="comment"></a>
|
<a name="comment"></a>
|
||||||
<li>comment<br>
|
<li>comment<br>
|
||||||
Add an arbitrary comment.
|
Add an arbitrary comment.
|
||||||
|
|
||||||
<a name="alias"></a>
|
<a name="alias"></a>
|
||||||
<li>alias<br>
|
<li>alias<br>
|
||||||
Used by FHEMWEB to display a device with another name e.g. when using
|
Used by FHEMWEB to display a device with another name e.g. when using
|
||||||
special characters/spaces not accepted by device definition.
|
special characters/spaces not accepted by device definition.
|
||||||
|
|
||||||
<a name="room"></a>
|
<a name="room"></a>
|
||||||
<li>room<br>
|
<li>room<br>
|
||||||
Filter/group devices. Recognized by web-pgm2 and web-pgm3. A device
|
Filter/group devices. Recognized by web-pgm2 and web-pgm3. A device
|
||||||
@ -397,13 +414,31 @@ A line ending with \ will be concatenated with the next one, so long lines
|
|||||||
devices.
|
devices.
|
||||||
</li>
|
</li>
|
||||||
|
|
||||||
|
<a name="eventMap"></a>
|
||||||
|
<li>eventMap<br>
|
||||||
|
Replace event names and set arguments. The value of this attribute
|
||||||
|
consists of a list of space separated values, each value is a colon
|
||||||
|
separated pair. The first part specifies the "old" value, the second
|
||||||
|
the new/desired value. If the first character is slash(/) or comma(,)
|
||||||
|
then split not by space but by this character, enabling to embed spaces.
|
||||||
|
Examples:<ul><code>
|
||||||
|
attr store eventMap on:open off:closed<br>
|
||||||
|
attr store eventMap /on-for-timer 10:open/off:closed/<br>
|
||||||
|
set store open
|
||||||
|
</code></ul>
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
|
||||||
|
</ul>
|
||||||
|
|
||||||
<a name="readingFnAttributes"></a>
|
<a name="readingFnAttributes"></a>
|
||||||
<h4>readingFnAttributes</h4>
|
<h4>readingFnAttributes</h4><p>
|
||||||
The following attributes are honored by the modules that make use
|
|
||||||
of the standardized readings updating mechanism in fhem.pl. Check the
|
The following global attributes are honored by the modules that make use of the
|
||||||
modules attribute list if you want to know if it is supporting it.
|
standardized readings updating mechanism in fhem.pl. Check the module's
|
||||||
<br>
|
attribute list if you want to know if a device supports these attributes. <br>
|
||||||
<br>
|
|
||||||
|
<ul>
|
||||||
|
|
||||||
<a name="stateFormat"></a>
|
<a name="stateFormat"></a>
|
||||||
<li>stateFormat<br>
|
<li>stateFormat<br>
|
||||||
@ -514,11 +549,50 @@ A line ending with \ will be concatenated with the next one, so long lines
|
|||||||
<li>the name of the defined Readings consists of alphanumeric characters
|
<li>the name of the defined Readings consists of alphanumeric characters
|
||||||
with underscore (_) and the minus (-) sign.</li>
|
with underscore (_) and the minus (-) sign.</li>
|
||||||
</ul>
|
</ul>
|
||||||
</li><br>
|
</li>
|
||||||
</ul>
|
</ul>
|
||||||
<br>
|
|
||||||
|
|
||||||
Device specific attributes are documented in the corresponding device section.
|
<h4>Common attributes</h4>
|
||||||
|
|
||||||
|
The following local attributes are used by a wider range of devices:
|
||||||
|
|
||||||
|
<ul>
|
||||||
|
<a name="IODev"></a>
|
||||||
|
<li>IODev<br>
|
||||||
|
Set the IO or physical device which should be used for sending signals
|
||||||
|
for this "logical" device. An example for the physical device is an FHZ
|
||||||
|
or a CUL. Note: Upon startup FHEM assigns each logical device
|
||||||
|
(FS20/HMS/KS300/etc) the last physical device which can receive data
|
||||||
|
for this type of device. The attribute IODev needs to be used only if
|
||||||
|
you attached more than one physical device capable of receiving signals
|
||||||
|
for this logical device.</li><br>
|
||||||
|
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
|
||||||
|
<br><br>
|
||||||
|
|
||||||
|
<a name="help"></a>
|
||||||
|
<h3>?, help</h3>
|
||||||
|
<ul>
|
||||||
|
<code>?</code><br>
|
||||||
|
<code>help</code><br>
|
||||||
|
<br>
|
||||||
|
Get a list of all commands and short description for each one
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<a name="attr"></a>
|
||||||
|
<h3>attr</h3>
|
||||||
|
<ul>
|
||||||
|
<code>attr <devspec> <attrname> [<value>] </code><br>
|
||||||
|
|
||||||
|
<br>Set an attribute for a device defined by <a href="#define">define</a>.
|
||||||
|
You can define your own <a href="#attributes">attributes</a> too to use them
|
||||||
|
in other applications.
|
||||||
|
|
||||||
|
Use "attr <name> ?" to get a list of possible attributes.
|
||||||
|
See the <a href="#devspec">Device specification</a> section for details on
|
||||||
|
<devspec>.
|
||||||
<br><br>
|
<br><br>
|
||||||
|
|
||||||
Examples:
|
Examples:
|
||||||
|
|||||||
@ -29,6 +29,7 @@
|
|||||||
<a href="#intro">Einleitung</a><br>
|
<a href="#intro">Einleitung</a><br>
|
||||||
<a href="#command">FHEM Befehls-Typen</a><br>
|
<a href="#command">FHEM Befehls-Typen</a><br>
|
||||||
<a href="#devspec">Geräte-Spezifikation</a><br>
|
<a href="#devspec">Geräte-Spezifikation</a><br>
|
||||||
|
<a href="#attributes">Attribute</a><br>
|
||||||
|
|
||||||
<br>
|
<br>
|
||||||
<b>FHEM-Befehle</b>
|
<b>FHEM-Befehle</b>
|
||||||
@ -334,33 +335,48 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
|
|||||||
</ul>
|
</ul>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
<a name="help"></a>
|
|
||||||
<h3>?, help</h3>
|
|
||||||
<ul>
|
|
||||||
<code>?</code><br>
|
|
||||||
<code>help</code><br>
|
|
||||||
<br>
|
|
||||||
Sie erhalten eine Liste aller Befehle mit einer Kurzbeschreibung jedes
|
|
||||||
Befehls.
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<a name="attr"></a>
|
|
||||||
<h3>attr</h3>
|
|
||||||
<ul>
|
|
||||||
<code>attr <devspec> <attrname> [<value>] </code><br>
|
|
||||||
|
|
||||||
<br>
|
<a name="attributes"></a>
|
||||||
Dieser Befehl setzt ein Attribut für ein Gerät welches mit <a
|
<h3>Attribute</h3>
|
||||||
href="#define">define</a> definiert wurde. Sie können auch Ihre eigenen
|
|
||||||
Attribute definieren, um sie in anderen Applikationen anzuwenden. Geben Sie
|
|
||||||
"<attr <name> ?" ein, um eine Liste verfügbarer Attribute
|
|
||||||
anzuzeigen.
|
|
||||||
|
|
||||||
Siehe den Abschnitt über <a href="#devspec">Geräte-Spezifikation</a>
|
Alle Geräte haben Attribute. Diese werden mittels des Befehls <a
|
||||||
für Details der <devspec>.<br>
|
href="#attr">attr</a> gesetzt, angezeigt mit dem Befehl <a
|
||||||
|
href="#displayattr">displayattr</a>, und mit dem Kommando <a
|
||||||
|
href="#deleteattr">deleteattr</a> entfernt.<p>
|
||||||
|
|
||||||
|
Es gibt globale Attribute, die von allen Geräten genutzt werden, und lokale
|
||||||
|
Attribute, die nur auf individuelle Geräteklassen zutreffen.<p>
|
||||||
|
|
||||||
|
Manche Geräte (wie <a href="#FHEMWEB">FHEMWEB</a>) definieren automatisch
|
||||||
|
neue globale Attribute bei der ersten Definition eines Gerätes dieses
|
||||||
|
Typs.<p>
|
||||||
|
|
||||||
|
Sie können den Befehl<p><code>attr global userattr
|
||||||
|
<attributelist></code><p> für das Gerät <a
|
||||||
|
href="#global">global</a> verwenden, um neue globale Attribute zu deklarieren,
|
||||||
|
und <p><code>attr <devicespec> userattr
|
||||||
|
<attributelist></code>,<p>um neue lokale Attribute für bestimmte
|
||||||
|
individuelle Geräte gemäß <a href="#devspec">devspec</a> zu
|
||||||
|
deklarieren.
|
||||||
|
|
||||||
|
<code><attributelist></code> ist eine durch Leerzeichen getrennte Liste,
|
||||||
|
die die Namen der zusätzlichen Attribute enthält. In der
|
||||||
|
Dokumentation zum Befehl <a href="#attr">attr</a> sind Beispiele.<p>
|
||||||
|
|
||||||
|
Seien Sie vorsichtig und überschreiben Sie keine zusätzlichen
|
||||||
|
globale Attribute, die bereits zuvor durch Sie selbst oder ein Gerät
|
||||||
|
definiert wurden. <code>attr global userattr <attributelist></code>
|
||||||
|
sollte so früh wie möglich in der Konfiguration erscheinen.
|
||||||
|
|
||||||
|
<h4>Gerätespezifische Attribute</h4>
|
||||||
|
|
||||||
|
Gerätespezifische Attribute sind in dem jeweiligen Abschnitt zum
|
||||||
|
Gerät dokumentiert.
|
||||||
|
|
||||||
|
|
||||||
|
<h4>Globale Attribute für alle Geräte</h4>
|
||||||
|
|
||||||
<p>Attribute, die für
|
|
||||||
alle Geräte anwendbar sind: </p>
|
|
||||||
<ul>
|
<ul>
|
||||||
<a name="verbose"></a>
|
<a name="verbose"></a>
|
||||||
<li>verbose<br>
|
<li>verbose<br>
|
||||||
@ -415,13 +431,34 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
|
|||||||
für FS20 PIRI Geräte.
|
für FS20 PIRI Geräte.
|
||||||
</li>
|
</li>
|
||||||
|
|
||||||
|
<a name="eventMap"></a>
|
||||||
|
<li>eventMap<br>
|
||||||
|
Ersetze Event Namen und setze Argumente. Der Wert dieses Attributes
|
||||||
|
besteht aus einer Liste von durch Leerzeichen getrennte Werten. Jeder
|
||||||
|
Wert ist ein durch Doppelpunkt getrenntes Paar. Der erste Teil stellt den
|
||||||
|
"alten" Wert, der zweite Teil den "neuen" Wert dar. Wenn der erste Wert
|
||||||
|
ein Slash (/) oder ein Komma (,) ist, dann wird nicht durch Leerzeichen
|
||||||
|
sondern durch das vorgestellte Zeichen getrennt.
|
||||||
|
Beispiele:
|
||||||
|
<ul><code>
|
||||||
|
attr store eventMap on:open off:closed<br>
|
||||||
|
attr store eventMap /on-for-timer 10:open/off:closed/<br>
|
||||||
|
set store open
|
||||||
|
</code></ul>
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
|
||||||
<a name="readingFnAttributes"></a>
|
<a name="readingFnAttributes"></a>
|
||||||
<h4>readingFnAttribute</h4>
|
<h4>readingFnAttribute</h4>
|
||||||
|
|
||||||
Die folgenden Attribute werden bei Modulen verwendet, die standardisierte
|
Die folgenden Attribute werden bei Modulen verwendet, die standardisierte
|
||||||
"readings" Aktualisierung der fhem.pl benutzen. Informieren Sie sich in der
|
"readings" Aktualisierung der fhem.pl benutzen. Informieren Sie sich in der
|
||||||
Liste der Modulattribute wenn Sie wissen möchten ob dies
|
Liste der Modulattribute wenn Sie wissen möchten ob dies
|
||||||
unterstützt wird.<br><br>
|
unterstützt wird.<br><br>
|
||||||
|
|
||||||
|
<ul>
|
||||||
<a name="stateFormat"></a>
|
<a name="stateFormat"></a>
|
||||||
<li>stateFormat<br>
|
<li>stateFormat<br>
|
||||||
Ändert den Gerätestatus, dies ist z.Bsp. in der Ausgabe des list
|
Ändert den Gerätestatus, dies ist z.Bsp. in der Ausgabe des list
|
||||||
@ -534,7 +571,55 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
|
|||||||
|
|
||||||
|
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
|
<h4>Allgemeine Attribute</h4>
|
||||||
|
|
||||||
|
Die folgenden lokalen Attribute werden von mehreren Geräte verwendet:
|
||||||
|
|
||||||
|
<ul>
|
||||||
|
|
||||||
|
<a name="IODev"></a>
|
||||||
|
<li>IODev<br>
|
||||||
|
Setzt das IO oder das physische Device welches zum Senden der Signale an
|
||||||
|
dieses logische Device verwendet werden soll (Beispielsweise FHZ oder
|
||||||
|
CUL). Hinweis: Beim Start weist FHEM jedem logischen Device das letzte
|
||||||
|
physische Device zu, das Daten von diesem Typ empfangen kann. Das
|
||||||
|
Attribut IODev muss nur gesetzt werden wenn mehr als ein physisches
|
||||||
|
Device fähig ist Signale von diesem logischen Device zu empfangen.
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
|
||||||
|
<br><br>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<a name="help"></a>
|
||||||
|
<h3>?, help</h3>
|
||||||
|
<ul>
|
||||||
|
<code>?</code><br>
|
||||||
|
<code>help</code><br>
|
||||||
<br>
|
<br>
|
||||||
|
Sie erhalten eine Liste aller Befehle mit einer Kurzbeschreibung jedes
|
||||||
|
Befehls.
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<a name="attr"></a>
|
||||||
|
<h3>attr</h3>
|
||||||
|
<ul>
|
||||||
|
<code>attr <devspec> <attrname> [<value>] </code><br>
|
||||||
|
|
||||||
|
<br>
|
||||||
|
Dieser Befehl setzt ein Attribut für ein Gerät welches mit <a
|
||||||
|
href="#define">define</a> definiert wurde. Sie können auch Ihre eigenen
|
||||||
|
Attribute definieren, um sie in anderen Applikationen anzuwenden. Geben Sie
|
||||||
|
"<attr <name> ?" ein, um eine Liste verfügbarer Attribute
|
||||||
|
anzuzeigen.
|
||||||
|
|
||||||
|
Siehe den Abschnitt über <a href="#devspec">Geräte-Spezifikation</a>
|
||||||
|
für Details der <devspec>.<br>
|
||||||
|
|
||||||
Gerätespezifische Attribute sind in der Beschreibung zum jeweiligen
|
Gerätespezifische Attribute sind in der Beschreibung zum jeweiligen
|
||||||
Gerät aufgeführt.
|
Gerät aufgeführt.
|
||||||
@ -762,13 +847,13 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
|
|||||||
<ul>
|
<ul>
|
||||||
<code>inform {on|off|timer|raw} [regexp]</code> <br>
|
<code>inform {on|off|timer|raw} [regexp]</code> <br>
|
||||||
<br>
|
<br>
|
||||||
Wenn auf "on" gesetzt und der Status eines Gerätes ändert sich, dann wird eine
|
Wenn auf "on" gesetzt und der Status eines Gerätes ändert
|
||||||
Nachricht an den Client gesendet. Dieser Befehl kann von anderen
|
sich, dann wird eine Nachricht an den Client gesendet. Dieser Befehl kann von
|
||||||
Programmen/Modulen dazu benutzt werden, eine Hinweisnachricht zu erhalten. <br>
|
anderen Programmen/Modulen dazu benutzt werden, eine Hinweisnachricht zu
|
||||||
Die Option "timer" fügt der Nachricht einen Zeitstempel hinzu. Hinweis:
|
erhalten. <br> Die Option "timer" fügt der Nachricht
|
||||||
Dieser Befehl erleichtert Ihnen die bessere Kontrolle in
|
einen Zeitstempel hinzu. Hinweis: Dieser Befehl erleichtert Ihnen die bessere
|
||||||
<a href="#notify">notify</a> oder <a href="#FileLog">FileLog</a> , wann welche
|
Kontrolle in <a href="#notify">notify</a> oder <a href="#FileLog">FileLog</a>
|
||||||
Ereignisse erzeugt wurden.
|
, wann welche Ereignisse erzeugt wurden.
|
||||||
|
|
||||||
<br>
|
<br>
|
||||||
</ul>
|
</ul>
|
||||||
@ -778,16 +863,15 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
|
|||||||
<ul>
|
<ul>
|
||||||
<code>list [devspec] [value]</code>
|
<code>list [devspec] [value]</code>
|
||||||
<br><br>
|
<br><br>
|
||||||
Auflistung aller "definitions", "notify" und "at"-Definitionen. Dies ist eines
|
Auflistung aller "definitions", "notify" und
|
||||||
der wenigen Befehle, die im Normalfall eine Zeichenkette ausgeben.<br>
|
"at"-Definitionen. Dies ist eines der wenigen Befehle, die im
|
||||||
Siehe den Abschnitt über <a href="#devspec">Geräte-Spezifikation</a>
|
Normalfall eine Zeichenkette ausgeben.<br> Siehe den Abschnitt über <a
|
||||||
für Details der <devspec>.<br>
|
href="#devspec">Geräte-Spezifikation</a> für Details der
|
||||||
|
<devspec>.<br>
|
||||||
|
|
||||||
<br>
|
<br> Wenn value angegeben ist, der von ( DEF, TYPE, usw) oder reading
|
||||||
Wenn value angegeben ist, der von ( DEF, TYPE, usw) oder reading (actuator,
|
(actuator, measured-temp) für alle Geräte die in devspec angegeben
|
||||||
measured-temp) für alle Geräte die in devspec angegeben sind.
|
sind. <br><br> Beispiel:
|
||||||
<br><br>
|
|
||||||
Beispiel:
|
|
||||||
<pre><code>fhem> list
|
<pre><code>fhem> list
|
||||||
|
|
||||||
Type list <name> for detailed info.
|
Type list <name> for detailed info.
|
||||||
@ -819,9 +903,9 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
|
|||||||
avglog (active)
|
avglog (active)
|
||||||
|
|
||||||
</name></code></pre>
|
</name></code></pre>
|
||||||
Wenn Sie für <code>name</code> einen Gerätenamen eingeben, dann erhalten Sie
|
Wenn Sie für <code>name</code> einen Gerätenamen eingeben, dann
|
||||||
einen genauen Status für das in<code> name</code> angegebene Gerät angezeigt,
|
erhalten Sie einen genauen Status für das in<code> name</code>
|
||||||
z.B.:
|
angegebene Gerät angezeigt, z.B.:
|
||||||
<pre><code> fhem> list fl
|
<pre><code> fhem> list fl
|
||||||
|
|
||||||
Internals:
|
Internals:
|
||||||
@ -847,12 +931,14 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
|
|||||||
<code>modify <name> <type-dependent-options></code>
|
<code>modify <name> <type-dependent-options></code>
|
||||||
<br><br>
|
<br><br>
|
||||||
|
|
||||||
Dieser Befehl wird benutzt, um Definitionen zu verändern. Er ist nützlich, um <a href="#at">at</a> oder <a href="#notify">notify</a>
|
Dieser Befehl wird benutzt, um Definitionen zu verändern. Er ist
|
||||||
Definitionen zu verändern. Wenn Sie einen Wert einer an Definition verändern,
|
nützlich, um <a href="#at">at</a> oder <a href="#notify">notify</a>
|
||||||
dann wird nur der für die Zeit zuständige Teil geändert. Im Falle der
|
Definitionen zu verändern. Wenn Sie einen Wert einer an Definition
|
||||||
Veränderung einer Definition vom Typ "notify" wird nur der regex Teil
|
verändern, dann wird nur der für die Zeit zuständige Teil
|
||||||
geändert. Alle anderen Werte (Stati, Attribute, etc) bleiben erhalten.
|
geändert. Im Falle der Veränderung einer Definition vom Typ
|
||||||
<br><br>
|
"notify" wird nur der regex Teil geändert. Alle anderen
|
||||||
|
Werte (Stati, Attribute, etc) bleiben erhalten. <br><br>
|
||||||
|
|
||||||
Beispiel:
|
Beispiel:
|
||||||
<ul>
|
<ul>
|
||||||
<code>define lampon at 19:00 set lamp on</code><br>
|
<code>define lampon at 19:00 set lamp on</code><br>
|
||||||
@ -897,9 +983,10 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
|
|||||||
<ul>
|
<ul>
|
||||||
<code>rename <oldname> <newname></code>
|
<code>rename <oldname> <newname></code>
|
||||||
<br><br>
|
<br><br>
|
||||||
Benennt ein Gerät von <oldname> in <newname>, einschliesslich der
|
Benennt ein Gerät von <oldname> in <newname>,
|
||||||
Attribute, um. Das globale Ereignis "RENAMED" wird erstellt, Lesen Sie bitte
|
einschliesslich der Attribute, um. Das globale Ereignis "RENAMED"
|
||||||
den Abschnitt "notify" durch um Details zu erfahren.
|
wird erstellt, Lesen Sie bitte den Abschnitt "notify" durch um
|
||||||
|
Details zu erfahren.
|
||||||
<br><br>
|
<br><br>
|
||||||
Beispiel:
|
Beispiel:
|
||||||
<ul>
|
<ul>
|
||||||
@ -913,14 +1000,14 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
|
|||||||
<ul>
|
<ul>
|
||||||
<code>rereadcfg [fhem-config-file]</code>
|
<code>rereadcfg [fhem-config-file]</code>
|
||||||
<br><br>
|
<br><br>
|
||||||
Liest entweder die aktuelle Konfigurationsdatei oder die angegebene Datei ein.<br>
|
Liest entweder die aktuelle Konfigurationsdatei oder die angegebene Datei
|
||||||
Der Ablauf ist dabei wie folgt: Zuerst wird das <a href="#statefile">statefile</a>
|
ein.<br> Der Ablauf ist dabei wie folgt: Zuerst wird das <a
|
||||||
gesichert. Dann werden alle Geräte gelöscht. Dann wird die aktuelle
|
href="#statefile">statefile</a> gesichert. Dann werden alle Geräte
|
||||||
Konfigurationsdatei (oder die angegebene Datei) eingelesen zuletzt wird das statefile
|
gelöscht. Dann wird die aktuelle Konfigurationsdatei (oder die
|
||||||
neu eingelesen.<br>
|
angegebene Datei) eingelesen zuletzt wird das statefile neu eingelesen.<br>
|
||||||
Wenn dieser Ablauf abgeschlossen ist, wird das globale REREADCFG Ereignis
|
Wenn dieser Ablauf abgeschlossen ist, wird das globale REREADCFG Ereignis
|
||||||
ausgelöst. Alle existierenden Verbindungenwerden bis zum "rereadcfg" Ereignis
|
ausgelöst. Alle existierenden Verbindungenwerden bis zum
|
||||||
getrennt.
|
"rereadcfg" Ereignis getrennt.
|
||||||
|
|
||||||
<br><br>
|
<br><br>
|
||||||
Beipiel:
|
Beipiel:
|
||||||
@ -939,16 +1026,17 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
|
|||||||
anstelle der allgemeinen Konfigurationsdatei benutzt.<br><br>
|
anstelle der allgemeinen Konfigurationsdatei benutzt.<br><br>
|
||||||
Hinweise:
|
Hinweise:
|
||||||
<ul>
|
<ul>
|
||||||
<li>Der Befehl speichert nur "definitions" und "attributes" aber keine (set/get)
|
<li>Der Befehl speichert nur "definitions" und
|
||||||
Befehle die vorher Teil der Konfigurationsdatei waren. Wenn Sie solche
|
"attributes" aber keine (set/get) Befehle die vorher Teil der
|
||||||
Befehle nach der Initialisierung (z.B. <a href="http://fhem.de/FHZset">FHTcode</a>)
|
Konfigurationsdatei waren. Wenn Sie solche Befehle nach der
|
||||||
benötigen,dann müssen Sie sie mit <a href="#notify">notify</a> triggern wenn
|
Initialisierung (z.B. <a href="http://fhem.de/FHZset">FHTcode</a>)
|
||||||
das
|
benötigen,dann müssen Sie sie mit <a href="#notify">notify</a>
|
||||||
INITIALIZED Ereignis eintritt.</li>
|
triggern wenn das INITIALIZED Ereignis eintritt.</li>
|
||||||
|
|
||||||
<li>Der Befehl "save" versucht Kommentarzeilen (Zeilen die mit #
|
<li>Der Befehl "save" versucht Kommentarzeilen (Zeilen die
|
||||||
beginnen) und "include"-Zeilen zu erhalten, aber arbeitet nicht korrekt wenn
|
mit # beginnen) und "include"-Zeilen zu erhalten, aber arbeitet
|
||||||
FHEM für diese Dateien keine Schreibrechte besitzt.</li>
|
nicht korrekt wenn FHEM für diese Dateien keine Schreibrechte
|
||||||
|
besitzt.</li>
|
||||||
|
|
||||||
</ul>
|
</ul>
|
||||||
</ul>
|
</ul>
|
||||||
@ -1047,13 +1135,12 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
|
|||||||
<ul>
|
<ul>
|
||||||
<code>setstate <devspec> <value></code>
|
<code>setstate <devspec> <value></code>
|
||||||
<br><br>
|
<br><br>
|
||||||
Der Befehl setzt den STATE Eintrag des Ger&aauml;tes direkt, ohne Ereignisse zu
|
Der Befehl setzt den STATE Eintrag des Ger&aauml;tes direkt, ohne Ereignisse
|
||||||
generieren oder ein Signal an das Gerät zu senden. Dieser Eintrag ist
|
zu generieren oder ein Signal an das Gerät zu senden. Dieser Eintrag ist
|
||||||
maßgebend für die Status-Anzeige in diversen Frontends.
|
maßgebend für die Status-Anzeige in diversen Frontends. Dieser
|
||||||
Dieser Befehl wird auch im <a href="#statefile">statefile</a> benutzt.<br>
|
Befehl wird auch im <a href="#statefile">statefile</a> benutzt.<br> Siehe den
|
||||||
Siehe den Abschnitt über <a href="#devspec">Geräte-Spezifikation</a>
|
Abschnitt über <a href="#devspec">Geräte-Spezifikation</a> für
|
||||||
für Details der <devspec>.<br>
|
Details der <devspec>.<br> <br>
|
||||||
<br>
|
|
||||||
Beispiel:
|
Beispiel:
|
||||||
<ul>
|
<ul>
|
||||||
setstate lampe An
|
setstate lampe An
|
||||||
@ -1124,8 +1211,8 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
|
|||||||
<ul>
|
<ul>
|
||||||
<code>version [filter]</code>
|
<code>version [filter]</code>
|
||||||
<br><br>
|
<br><br>
|
||||||
Gibt die Versionsinformation von fhem.pl und aller geladenen Module aus. Mit der
|
Gibt die Versionsinformation von fhem.pl und aller geladenen Module aus. Mit
|
||||||
optionalen Parameter kann man die Ausgabe filtern.
|
der optionalen Parameter kann man die Ausgabe filtern.
|
||||||
|
|
||||||
<br><br>
|
<br><br>
|
||||||
Beispiel der Ausgabe:
|
Beispiel der Ausgabe:
|
||||||
@ -1142,9 +1229,10 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
|
|||||||
<a name="global"></a>
|
<a name="global"></a>
|
||||||
<h3>global</h3>
|
<h3>global</h3>
|
||||||
<ul>
|
<ul>
|
||||||
Das "global" Gerät wird benutzt, um allgemeingültige Attribute zu setzen. Es
|
Das "global" Gerät wird benutzt, um allgemeingültige
|
||||||
wird automatisch erstellt und kann nicht gelöscht oder umbenannt werden. Es
|
Attribute zu setzen. Es wird automatisch erstellt und kann nicht
|
||||||
hat keine "set" oder "get" Parameter.<br>
|
gelöscht oder umbenannt werden. Es hat keine "set" oder
|
||||||
|
"get" Parameter.<br>
|
||||||
<br>
|
<br>
|
||||||
|
|
||||||
<b>Define</b><ul>N/A</ul><br>
|
<b>Define</b><ul>N/A</ul><br>
|
||||||
@ -1170,11 +1258,11 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
|
|||||||
|
|
||||||
<a name="backupcmd"></a>
|
<a name="backupcmd"></a>
|
||||||
<li>backupcmd<br>
|
<li>backupcmd<br>
|
||||||
Sie können das Update durch Ihre eigenen Befehle/Skripts durchführen
|
Sie können das Update durch Ihre eigenen Befehle/Skripts
|
||||||
indem Sie dieses Attribut setzen.
|
durchführen indem Sie dieses Attribut setzen. Wenn dieses
|
||||||
Wenn dieses Attribut gesetzt ist, dann startet es als ein SHELL-Befehl
|
Attribut gesetzt ist, dann startet es als ein SHELL-Befehl und erstellt
|
||||||
und erstellt eine durch Leerzeichen getrennte Liste von
|
eine durch Leerzeichen getrennte Liste von Dateien/Verzeichnissen als
|
||||||
Dateien/Verzeichnissen als <strong>ein</strong> Argument zum Befehl, z.B.:
|
<strong>ein</strong> Argument zum Befehl, z.B.:
|
||||||
<br>
|
<br>
|
||||||
<ul>
|
<ul>
|
||||||
<code>"/etc/fhem.cfg /var/log/fhem/fhem.save /usr/share/fhem/contrib
|
<code>"/etc/fhem.cfg /var/log/fhem/fhem.save /usr/share/fhem/contrib
|
||||||
@ -1182,9 +1270,11 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
|
|||||||
/usr/share/fhem/www"</code>
|
/usr/share/fhem/www"</code>
|
||||||
</ul>
|
</ul>
|
||||||
Bemerkung: Ihr Befehl/Skript muss die Zeichenkette "backup done"
|
Bemerkung: Ihr Befehl/Skript muss die Zeichenkette "backup done"
|
||||||
zurückgeben oder eine entsprechende Zeichenkette um Fehlermeldungen
|
zurückgeben oder eine entsprechende Zeichenkette um
|
||||||
auszugeben, damit die Zusammenarbeit mit updatefhem funktioniert!<br>
|
Fehlermeldungen auszugeben, damit die Zusammenarbeit mit updatefhem
|
||||||
Dieses Attribut wird vom <a href="#backup">backup</a> Befehl benutzt.<br>
|
funktioniert!<br> Dieses Attribut wird vom <a href="#backup">backup</a>
|
||||||
|
Befehl benutzt.<br>
|
||||||
|
|
||||||
Beispiel:<br>
|
Beispiel:<br>
|
||||||
<ul>
|
<ul>
|
||||||
attr global backupcmd /usr/local/bin/myBackupScript.sh
|
attr global backupcmd /usr/local/bin/myBackupScript.sh
|
||||||
@ -1194,8 +1284,8 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
|
|||||||
<a name="backupdir"></a>
|
<a name="backupdir"></a>
|
||||||
<li>backupdir<br>
|
<li>backupdir<br>
|
||||||
Ein Ordner um die komprimierten Sicherheitsdateien zu speichern.
|
Ein Ordner um die komprimierten Sicherheitsdateien zu speichern.
|
||||||
Dieses Attribut wird vom <a href="#backup">backup</a> Befehl benutzt.<br>
|
Dieses Attribut wird vom <a href="#backup">backup</a> Befehl
|
||||||
Beispiel:<br>
|
benutzt.<br> Beispiel:<br>
|
||||||
<ul>
|
<ul>
|
||||||
attr global backupdir /Volumes/BigHD
|
attr global backupdir /Volumes/BigHD
|
||||||
</ul>
|
</ul>
|
||||||
@ -1203,11 +1293,11 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
|
|||||||
|
|
||||||
<a name="backupsymlink"></a>
|
<a name="backupsymlink"></a>
|
||||||
<li>backupsymlink<br>
|
<li>backupsymlink<br>
|
||||||
Wenn dieses Attribut auf etwas anderes als "no", dann unterstützt der
|
Wenn dieses Attribut auf etwas anderes als "no", dann unterstützt
|
||||||
Archviierungsbefehl "tar" symbolische Links in Ihrem Backup. Andererseits,
|
der Archviierungsbefehl "tar" symbolische Links in Ihrem
|
||||||
wenn dieses Attribut auf
|
Backup. Andererseits, wenn dieses Attribut auf "no" gesetzt ist werden
|
||||||
"no" gesetzt ist werden symbolische Links vom Befehl "tar" ignoriert.
|
symbolische Links vom Befehl "tar" ignoriert. Dieses
|
||||||
Dieses Attribut wird vom <a href="#backup">backup</a> Befehl benutzt.<br>
|
Attribut wird vom <a href="#backup">backup</a> Befehl benutzt.<br>
|
||||||
Beispiel:<br>
|
Beispiel:<br>
|
||||||
<ul>
|
<ul>
|
||||||
attr global backupsymlink yes
|
attr global backupsymlink yes
|
||||||
@ -1272,7 +1362,7 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
|
|||||||
|
|
||||||
<a name="motd"></a>
|
<a name="motd"></a>
|
||||||
<li>motd<br>
|
<li>motd<br>
|
||||||
Nachricht des Tages. Wird im Begrüßungsbildschirm von FHEM
|
Nachricht des Tages. Wird im Begrüßungsbildschirm von FHEM
|
||||||
angezeigt, oder direkt beim Start einer "telnet" Sitzung,
|
angezeigt, oder direkt beim Start einer "telnet" Sitzung,
|
||||||
bevor der fhem> Prompt erscheint. Der SecurityCheck setzt motd wenn
|
bevor der fhem> Prompt erscheint. Der SecurityCheck setzt motd wenn
|
||||||
es bisher nicht gesetzt ist. Um das zu verhindern, können sie den
|
es bisher nicht gesetzt ist. Um das zu verhindern, können sie den
|
||||||
@ -1321,29 +1411,6 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
|
|||||||
|
|
||||||
<li><a href="#fheminfo">uniqueID</a>
|
<li><a href="#fheminfo">uniqueID</a>
|
||||||
|
|
||||||
<a name="updatebranch"></a>
|
|
||||||
<li>updatebranch<br>
|
|
||||||
Dieses Attribut wird mittels der Datei FhemUtils/release.pm gesetzt die
|
|
||||||
im "modpath"-Verzeichnis enthalten ist. Z.B, wenn eine stabile Version von
|
|
||||||
FHEM (ab Version 5.3 aufwärts) über eine direkte Download-Verbindung vom
|
|
||||||
Archiv der FHEM-Webseite installiert wurde, then wird automatisch der Zweig
|
|
||||||
der Aktualisierung auf "stable"eingestellt.
|
|
||||||
In dieser Form der Aktualisierung werden nur behobene Fehler, relevante
|
|
||||||
Sicherheitslücken oder neue stabile Versionen aktualisiert.<br>
|
|
||||||
Mittels dem Befehl "update development <filename>" benutzen,
|
|
||||||
können Dateien oder Pakete jederzei direkt aus dem Entwicklungszweig
|
|
||||||
(z.B. mittels "update development <package>") installiert werden.<br>
|
|
||||||
Wenn Sie anstelle von Entwicklungsversionen eine stabile Version
|
|
||||||
installieren wollen, so können Sie dies durch Angabe des Attributes "updatebranch DEVELOPMENT"
|
|
||||||
erzwingen.
|
|
||||||
Bei der Installation von FHEM sollten Sie generell die
|
|
||||||
Entwicklungsversion installieren. Dieses Attribut muss nicht gesetzt werden.
|
|
||||||
Benutzen Sie dagegen "update development force"
|
|
||||||
um alle Dateien, einschliesslich der Datei release.pm (enthält die
|
|
||||||
aktuellen Informationen)
|
|
||||||
zu aktualisieren.
|
|
||||||
</li><br>
|
|
||||||
|
|
||||||
<a name="userattr"></a>
|
<a name="userattr"></a>
|
||||||
<li>userattr<br>
|
<li>userattr<br>
|
||||||
Enthält eine durch Leerzeichen getrennte Liste in welcher die
|
Enthält eine durch Leerzeichen getrennte Liste in welcher die
|
||||||
@ -1375,16 +1442,17 @@ Zeilen erstreckende Befehle, indem man keine \ am Zeilenende eingeben muss.</p>
|
|||||||
|
|
||||||
<a name="perl"></a>
|
<a name="perl"></a>
|
||||||
<h3>Perl specials</h3>
|
<h3>Perl specials</h3>
|
||||||
Wenn Sie einige Aufgaben automatisieren wollen, dann sollten Sie die Befehle <a href="#at">at</a> oder <a href="#notify">notify</a>
|
Wenn Sie einige Aufgaben automatisieren wollen, dann sollten Sie die Befehle
|
||||||
nutzen. Für komplexere Aufgaben sollten Sie lieber ein SHELLl-Skiipt oder einen
|
<a href="#at">at</a> oder <a href="#notify">notify</a> nutzen. Für
|
||||||
PERL "oneliner" als das at/notify
|
komplexere Aufgaben sollten Sie lieber ein SHELLl-Skiipt oder einen PERL
|
||||||
argument anwenden. Dieser Abschnitt gibt Ihnen einige Tipps zur Anwendung der
|
"oneliner" als das at/notify argument anwenden. Dieser Abschnitt gibt Ihnen
|
||||||
PERL-oneliner.<br><br>
|
einige Tipps zur Anwendung der PERL-oneliner.<br><br>
|
||||||
|
|
||||||
<li>Um PERL-"oneliner" zu testen, geben Sie diese am "telnet" Prompt (oder in
|
<li>Um PERL-"oneliner" zu testen, geben Sie diese am
|
||||||
der FHEMWEB Text-Eingabezeile) eingeschlossen von geschweiften Klammern {} in
|
"telnet" Prompt (oder in der FHEMWEB Text-Eingabezeile)
|
||||||
einer Zeile ein. Die letzte Beispielzeile schreibt nur etwas in die Logdatei,
|
eingeschlossen von geschweiften Klammern {} in einer Zeile ein. Die letzte
|
||||||
während das Ergebnis der anderen Zeilen direkt auf der Webseite sichtbar ist.<ul>
|
Beispielzeile schreibt nur etwas in die Logdatei, während das Ergebnis
|
||||||
|
der anderen Zeilen direkt auf der Webseite sichtbar ist.<ul>
|
||||||
Beispiele:<p>{ "Hello" }<br>
|
Beispiele:<p>{ "Hello" }<br>
|
||||||
{ 1+3*4 }<br>
|
{ 1+3*4 }<br>
|
||||||
{ `ls /etc` }<br>
|
{ `ls /etc` }<br>
|
||||||
@ -1393,18 +1461,22 @@ PERL-oneliner.<br><br>
|
|||||||
</ul>
|
</ul>
|
||||||
<br>
|
<br>
|
||||||
|
|
||||||
</li><li>
|
</li>
|
||||||
PERL Ausdrücke werden durch ein Semikolon (;) getrennt. In FHEM "oneliners"
|
|
||||||
müssen sie durch ein weiteres Semikolon (;;) "escaped" (maskiert) werden<br>
|
<li>
|
||||||
|
PERL Ausdrücke werden durch ein Semikolon (;) getrennt. In FHEM
|
||||||
|
"oneliners" müssen sie durch ein weiteres Semikolon (;;)
|
||||||
|
"escaped" (maskiert) werden<br>
|
||||||
Beispiel:<ul>
|
Beispiel:<ul>
|
||||||
{ my $a = 1+1;; Log 1, "Hello $a" }
|
{ my $a = 1+1;; Log 1, "Hello $a" }
|
||||||
</ul>
|
</ul>
|
||||||
<br>
|
</li><br>
|
||||||
|
|
||||||
</li><li>Um FHEM-Kommandos in den PERL-Ausdrücken zu verwenden, benutzen Sie
|
<li>Um FHEM-Kommandos in den PERL-Ausdrücken zu verwenden, benutzen
|
||||||
bitte die Funktion fhem(),
|
Sie bitte die Funktion fhem(), mit einem Textargument. Dieser Text wird als
|
||||||
mit einem Textargument. Dieser Text wird als FHEM-Kommando interpretiert.<br>
|
FHEM-Kommando interpretiert.<br>
|
||||||
<p> Beispiel<ul>
|
<p> Beispiel<ul>
|
||||||
|
|
||||||
{ fhem "set light on" }<br>
|
{ fhem "set light on" }<br>
|
||||||
define n1 notify piri:on { fhem "set light on" }
|
define n1 notify piri:on { fhem "set light on" }
|
||||||
<p> </p>
|
<p> </p>
|
||||||
@ -1413,9 +1485,7 @@ bitte die Funktion fhem(),
|
|||||||
in der allgemeinen Logdatei gespeichert.. Benutzen sie "1" als
|
in der allgemeinen Logdatei gespeichert.. Benutzen sie "1" als
|
||||||
zweites Argument um dieses speichern zu verhindern. Sinnvoll ist dieses
|
zweites Argument um dieses speichern zu verhindern. Sinnvoll ist dieses
|
||||||
Argument bei der Abfrage von Werten mittels "get...".
|
Argument bei der Abfrage von Werten mittels "get...".
|
||||||
<br>
|
</li><br>
|
||||||
<br>
|
|
||||||
</li>
|
|
||||||
|
|
||||||
<li>Notify kann auch dazu verwendet werden, um Macros manuell
|
<li>Notify kann auch dazu verwendet werden, um Macros manuell
|
||||||
auszuführen. Verwenden Sie den <a href="#trigger">trigger</a>-Befehl
|
auszuführen. Verwenden Sie den <a href="#trigger">trigger</a>-Befehl
|
||||||
@ -1473,14 +1543,16 @@ bitte die Funktion fhem(),
|
|||||||
gibt den Status eines Gerätes zurück (entsprechend dem
|
gibt den Status eines Gerätes zurück (entsprechend dem
|
||||||
Ausdruck in Klammern, den Sie beim List-Befehl sehen).
|
Ausdruck in Klammern, den Sie beim List-Befehl sehen).
|
||||||
</li><br>
|
</li><br>
|
||||||
|
|
||||||
<li>OldValue(<devicename>)</li>
|
<li>OldValue(<devicename>)</li>
|
||||||
<li>OldTimestamp(<devicename>)<br>
|
<li>OldTimestamp(<devicename>)<br>
|
||||||
gibt den vorherigen Wert/Zeitstempel des Gerätes zurück.
|
gibt den vorherigen Wert/Zeitstempel des Gerätes zurück.
|
||||||
</li><br>
|
</li><br>
|
||||||
|
|
||||||
<li>
|
<li>
|
||||||
ReadingsVal(<devicename>,<reading>,<defaultvalue>)<br>
|
ReadingsVal(<devicename>,<reading>,<defaultvalue>)<br>
|
||||||
Gibt den Inhalt der "readings" zurück (den Inhalt der in dem "Readings"-Abschnitt
|
Gibt den Inhalt der "readings" zurück (den Inhalt der in
|
||||||
von "list device" angezeigt wird)
|
dem "Readings"-Abschnitt von "list device" angezeigt wird)
|
||||||
</li><br>
|
</li><br>
|
||||||
<li>
|
<li>
|
||||||
AttrVal(<devicename>,<attribute>,<defaultvalue>)<br>
|
AttrVal(<devicename>,<attribute>,<defaultvalue>)<br>
|
||||||
@ -1502,16 +1574,16 @@ bitte die Funktion fhem(),
|
|||||||
|
|
||||||
|
|
||||||
</li><li>
|
</li><li>
|
||||||
Wenn Sie das 99_SUNRISE_EL.pm Modul benutzen, haben Sie zugriff auf folgende
|
Wenn Sie das 99_SUNRISE_EL.pm Modul benutzen, haben Sie zugriff auf
|
||||||
Funktionen: <br>
|
folgende Funktionen: <br>
|
||||||
<ul>
|
<ul>
|
||||||
sunset($offset, $min, $max)<br>
|
sunset($offset, $min, $max)<br>
|
||||||
sunrise($offset, $min, $max)<br>
|
sunrise($offset, $min, $max)<br>
|
||||||
isday()<br>
|
isday()<br>
|
||||||
</ul>
|
</ul>
|
||||||
Der Wert von "offset" wird in Sekunden angegeben und das Format für min/max ist "HH:MM" oderr "HH:MM:SS".
|
Der Wert von "offset" wird in Sekunden angegeben und das Format
|
||||||
isday gibt 1 zurück, wenn die Sonne sichtbar ist und ansonsten den Wert 0.
|
für min/max ist "HH:MM" oderr "HH:MM:SS". isday gibt 1 zurück,
|
||||||
</li>
|
wenn die Sonne sichtbar ist und ansonsten den Wert 0. </li>
|
||||||
|
|
||||||
<br>
|
<br>
|
||||||
<br>
|
<br>
|
||||||
@ -1523,9 +1595,11 @@ bitte die Funktion fhem(),
|
|||||||
Modulen falls das <a href="#plotmode">plotmode</a>-Attribut auf SVG gesetzt
|
Modulen falls das <a href="#plotmode">plotmode</a>-Attribut auf SVG gesetzt
|
||||||
ist. In diesem Fall wird nur eine geringere Anzahl der .gnuplot Attribute
|
ist. In diesem Fall wird nur eine geringere Anzahl der .gnuplot Attribute
|
||||||
benutzt, und einige Linien haben eine besondere Bedeutung: Die Unterschiede
|
benutzt, und einige Linien haben eine besondere Bedeutung: Die Unterschiede
|
||||||
werden in diesem Kapitel erklärt. Lesen Sie bitte auch <a href="http://fhemwiki.de/wiki/Creating_Plots">
|
werden in diesem Kapitel erklärt. Lesen Sie bitte auch <a
|
||||||
diesen</a> fhemwiki Eintrag zur Erstellung von Logdateien.<br>
|
href="http://fhemwiki.de/wiki/Creating_Plots"> diesen</a> fhemwiki Eintrag
|
||||||
Im folgenden ist eine minimale .gplot Definition (gültig nur bei Plotmode SVG):<br>
|
zur Erstellung von Logdateien.<br> Im folgenden ist eine minimale .gplot
|
||||||
|
Definition (gültig nur bei Plotmode SVG):<br>
|
||||||
|
|
||||||
<pre> set terminal size <SIZE>
|
<pre> set terminal size <SIZE>
|
||||||
#FileLog 4:::
|
#FileLog 4:::
|
||||||
plot title 'Temperature' with lines
|
plot title 'Temperature' with lines
|
||||||
@ -1535,30 +1609,33 @@ bitte die Funktion fhem(),
|
|||||||
<li>set Befehle<br>
|
<li>set Befehle<br>
|
||||||
Folgende "sets" werden erkannt:
|
Folgende "sets" werden erkannt:
|
||||||
<ul>
|
<ul>
|
||||||
<li>terminal, nur die Größenparameter.<br>
|
<li>terminal, nur die Größenparameter.<br>
|
||||||
Dieser ist in der Regel auf <SIZE> gesetzt, welcher ersetzt wird
|
Dieser ist in der Regel auf <SIZE> gesetzt, welcher ersetzt wird
|
||||||
durch das <a href="#plotsize">plotsize</a> Attribut von FHEMWEB oder einer
|
durch das <a href="#plotsize">plotsize</a> Attribut von FHEMWEB oder
|
||||||
Weblink-Instanz.</li>
|
einer Weblink-Instanz.</li>
|
||||||
|
|
||||||
<li>title<br>
|
<li>title<br>
|
||||||
Normalerweise gesetzt auf <TL> welcher durch das Weblink <a href="#title">title</a>-Attribut, oder
|
Normalerweise gesetzt auf <TL> welcher durch das Weblink <a
|
||||||
durch <Lx>, welches wiederum vom Weblink <a href="#label">label</a>
|
href="#title">title</a>-Attribut, oder durch <Lx>, welches
|
||||||
Attribut ersetzt wird.</li>
|
wiederum vom Weblink <a href="#label">label</a> Attribut ersetzt
|
||||||
|
wird.</li>
|
||||||
|
|
||||||
<li>ylabel,y2label<br>
|
<li>ylabel,y2label<br>
|
||||||
Linke und rechte vertikale Achsenbeschriftungen. Are also subject to label
|
Linke und rechte vertikale Achsenbeschriftungen. Are also subject to
|
||||||
replacement.</li>
|
label replacement.</li>
|
||||||
|
|
||||||
<li>yrange,y2range<br>
|
<li>yrange,y2range<br>
|
||||||
Legen den Wertebereich der linken und rechten y-Achse fest.
|
Legen den Wertebereich der linken und rechten y-Achse fest.
|
||||||
Beispiele:<br>
|
Beispiele:<br>
|
||||||
|
|
||||||
<ul>
|
<ul>
|
||||||
set yrange [-0.1:1.1]<br>
|
set yrange [-0.1:1.1]<br>
|
||||||
set y2range [0:]<br>
|
set y2range [0:]<br>
|
||||||
</ul>
|
</ul>
|
||||||
</li>
|
</li>
|
||||||
<li>ytics,y2tics<br>
|
<li>ytics,y2tics<br>
|
||||||
Beschriftung für die Werte der rechten/linken y-Achse. Beispiele:<br>
|
Beschriftung für die Werte der rechten/linken y-Achse.
|
||||||
|
Beispiele:<br>
|
||||||
<ul>
|
<ul>
|
||||||
set ytics ("on" 0, "off" 1)<br>
|
set ytics ("on" 0, "off" 1)<br>
|
||||||
set y2tics<br>
|
set y2tics<br>
|
||||||
@ -1570,49 +1647,52 @@ bitte die Funktion fhem(),
|
|||||||
|
|
||||||
<li>#FileLog Einträge<br>
|
<li>#FileLog Einträge<br>
|
||||||
Jede Line des Plots muss eine dazugehörige #FileLog
|
Jede Line des Plots muss eine dazugehörige #FileLog
|
||||||
Zeile haben. Zur Syntax lesen Sie bitte den Abschnitt "column_spec paragraph"
|
Zeile haben. Zur Syntax lesen Sie bitte den Abschnitt "column_spec
|
||||||
von der <a href="#FileLogget">Filelog get</a> Beschreibung.
|
paragraph" von der <a href="#FileLogget">Filelog get</a>
|
||||||
Beachten sie bitte, das bei SVG-Plots die erste Spalte der Datei unbedingt
|
Beschreibung. Beachten sie bitte, das bei SVG-Plots die erste Spalte der
|
||||||
im FHEM-Zeitstempelformat (YYYY-MM-DD_HH:MM:SS) formatiert sein muss
|
Datei unbedingt im FHEM-Zeitstempelformat (YYYY-MM-DD_HH:MM:SS)
|
||||||
|
formatiert sein muss
|
||||||
</li>
|
</li>
|
||||||
<br>
|
<br>
|
||||||
|
|
||||||
<li>Plot Einträge<br>
|
<li>Plot Einträge<br>
|
||||||
bestehen immer aus einem Plotbefehl und aus durch Kommata getrenne
|
bestehen immer aus einem Plotbefehl und aus durch Kommata getrenne
|
||||||
Argumentblöcke. Jeder Argumentblock repräsentiert eine darzustellende Linie
|
Argumentblöcke. Jeder Argumentblock repräsentiert eine
|
||||||
und hat seine eigenen Paramter.
|
darzustellende Linie und hat seine eigenen Paramter.
|
||||||
Folgende Parameter werden are anerkannt:
|
Folgende Parameter werden are anerkannt:
|
||||||
<ul>
|
<ul>
|
||||||
<li>axes x1y1 / x1y2<br>
|
<li>axes x1y1 / x1y2<br>
|
||||||
weist das Programm an die aktuelle Zeile einer der beiden Achsen (links
|
weist das Programm an die aktuelle Zeile einer der beiden Achsen (links
|
||||||
oder rechts) zuzuweisen.
|
oder rechts) zuzuweisen.
|
||||||
</li>
|
</li>
|
||||||
|
|
||||||
<li>title<br>
|
<li>title<br>
|
||||||
Beschriftung der Linie. Wenn man auf diesen Titel klickt, dann ändert
|
Beschriftung der Linie. Wenn man auf diesen Titel klickt, dann
|
||||||
ein kleines Javascript-Programm den Titel auf die min/max und last-Werte
|
ändert ein kleines Javascript-Programm den Titel auf die min/max
|
||||||
des Plots,
|
und last-Werte des Plots, Weiterhin erlaubt das Programm diese Linie zu
|
||||||
Weiterhin erlaubt das Programm diese Linie zu kopieren oder eine bereits
|
kopieren oder eine bereits kopierte Linie einzufügen (die
|
||||||
kopierte Linie einzufügen (die existierende Skalierung des Plots wird
|
existierende Skalierung des Plots wird dabei nicht verändert, nur
|
||||||
dabei nicht verändert, nur die eingefügte Linie wird skaliert/angepasst.
|
die eingefügte Linie wird skaliert/angepasst. Andere Linien des
|
||||||
Andere Linien des Plots werden zeitweise nicht angezeigt.</li>
|
Plots werden zeitweise nicht angezeigt.</li>
|
||||||
<li>with <linetype><br>
|
<li>with <linetype><br>
|
||||||
spezifiziert die Art der Linie. Folgende Linienarten können verwendet
|
spezifiziert die Art der Linie. Folgende Linienarten können
|
||||||
werden: points,
|
verwendet werden: points, steps, fsteps, histeps and lines. Nicht
|
||||||
steps, fsteps, histeps and lines. Nicht bekannte Linienarten werden als
|
bekannte Linienarten werden als Typ "lines" dargestellt.
|
||||||
Typ "lines" dargestellt.
|
|
||||||
</li>
|
</li>
|
||||||
|
|
||||||
<li>ls <linestyle><br>
|
<li>ls <linestyle><br>
|
||||||
Der Linienstil stellt die erste Linie als l0 dar, die zweite Linie
|
Der Linienstil stellt die erste Linie als l0 dar, die zweite
|
||||||
als l1 und so weiter. Definiert ist dies in der svg_style.css Datei. Darin
|
Linie als l1 und so weiter. Definiert ist dies in der svg_style.css
|
||||||
sind zwei Sets definiert: l0-l8 and l0fill-l6fill. Das zweite Set muss
|
Datei. Darin sind zwei Sets definiert: l0-l8 and l0fill-l6fill. Das
|
||||||
aber explizit angegeben werden. Wenn der Name des Linienstils das Wort "fill"
|
zweite Set muss aber explizit angegeben werden. Wenn der Name des
|
||||||
enthält, dann haben Plots des Linientyps "lines" ein zusätzliches Start- und
|
Linienstils das Wort "fill" enthält, dann haben Plots
|
||||||
Endsegment für eine korrekte Darstellung.<br>
|
des Linientyps "lines" ein zusätzliches Start- und Endsegment
|
||||||
Bitte lesen sie die SVG Spezifikationen, um Details über diese css-Datei
|
für eine korrekte Darstellung.<br> Bitte lesen sie die SVG
|
||||||
zu erfahren.
|
Spezifikationen, um Details über diese css-Datei zu erfahren.
|
||||||
Notiz: Wenn Sie dieses Attribut einsetzen möchten, müssen Sie es für
|
Notiz: Wenn Sie dieses Attribut einsetzen möchten, müssen Sie
|
||||||
alle Linien (Attributblocks) im Plotbefehl spezifizieren.
|
es für alle Linien (Attributblocks) im Plotbefehl spezifizieren.
|
||||||
</li>
|
</li>
|
||||||
|
|
||||||
<li>lw <linewidth><br>
|
<li>lw <linewidth><br>
|
||||||
Setzt die Linienbreite der Linie. Dieses Attribut ist veraltet. Das
|
Setzt die Linienbreite der Linie. Dieses Attribut ist veraltet. Das
|
||||||
entprechende Feature der css-Datei/(Attribut ls) muss verwendet werden.
|
entprechende Feature der css-Datei/(Attribut ls) muss verwendet werden.
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user