FHEM Command Beispiele: Unterschied zwischen den Versionen

Aus FHEMWiki
K (Kategorie geändert; Ergänzungen zum Befehl rereadcfg)
K (Verlinkung auf separaten Artikel)
 
(15 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Randnotiz|RNTyp=Fehl|RNText=<BR>Dieses Seite dient (aus historischen Gründen) als reine Weiterleitung auf die verlinkten separaten Wiki-Seiten.<BR><BR>Bitte diesen Artikel nicht mehr erweitern, sondern die separaten Wiki-Seiten in [[:Kategorie:FHEM Befehl]] bearbeiten beziehungsweise dort fehlende Befehls-Seiten neu anlegen.}}
== Allgemeines ==
== Allgemeines ==
Dies soll kein Ersatz für die [[FHEM Command Reference]] sein. Es geht hier vorwiegend um voll ausgeschriebene Befehle zum besseren Verständnis. Die ''Command Reference'' listet alle Befehle, Optionen und Möglichkeiten auf, aber manchmal übersieht man in der Vielzahl an Informationen eine Kleinigkeit und schon funktioniert es nicht. Es werden nicht alle Optionen erläutert.
Dies soll kein Ersatz für die [[FHEM Command Reference]] sein. Es geht hier vorwiegend um voll ausgeschriebene Befehle zum besseren Verständnis. Die ''Command Reference'' listet alle Befehle, Optionen und Möglichkeiten auf, aber manchmal übersieht man in der Vielzahl an Informationen eine Kleinigkeit und schon funktioniert es nicht. Es werden nicht alle Optionen erläutert.


Sofern es im Wiki schon Beiträge gibt, die einzelne Befehle ähnlich diesem Beitrag abhandeln, erfolgt ein Verweis auf diese; alle existierenden Beiträge zu Fhem-Befehlen sind zudem in der Kategorie [[:Kategorie:FhemBefehl|FhemBefehl]] aufgelistet.
Sofern es im Wiki schon Beiträge gibt, die einzelne Befehle ähnlich diesem Beitrag abhandeln, erfolgt ein Verweis auf diese; alle existierenden Beiträge zu FHEM-Befehlen sind zudem in der Kategorie [[:Kategorie:FHEM Befehl|FHEM Befehl]] aufgelistet.


=== at ===
=== at ===
''at'' kann man vergleichen mit den "Geplanten Tasks" (Windows) oder "cron" (Linux). Abhängig von der Uhrzeit (immer um 04:00 Uhr) bzw. abgelaufenen Zeitspannen (alle 5 Minuten) werden weitere Befehle ausgelöst.
''at'' kann man vergleichen mit den "Geplanten Tasks" (Windows) oder "cron" (Linux). Abhängig von der Uhrzeit (immer um 04:00 Uhr) bzw. abgelaufenen Zeitspannen (alle 5 Minuten) werden weitere Befehle ausgelöst.
* [[AT zu einem absoluten Datum ausführen]]
Dieses Hilfsmodul ist auf einer [[At|eigenen Seite]] beschrieben.
* [[Sunset Sunrise]]  


=== attr ===
=== attr ===
Mit ''attr'' weist man einem FHEM-Gerät bestimmte '''Attr'''ibute (Merkmale / Eigenschaften) zu. Weiterhin setzt man damit z.B. auch allgemein gültige (''globale'') Eigenschaften der FHEM-Installation (''latitude'', ''longitude'', ''verbose'').
Mit ''attr'' weist man einem FHEM-Gerät bestimmte [[Attribut|'''Attr'''ibute]] (Merkmale / Eigenschaften) zu. Weiterhin setzt man damit z.B. auch allgemein gültige (''globale'') Eigenschaften der FHEM-Installation (''latitude'', ''longitude'', ''verbose''). Dieser Befehl ist auf einer [[attr|eigenen Seite]] beschrieben.


==== attr global latitude 5X.XYZ ====
==== attr global latitude 5X.XYZ ====
Wert für die geographische Breite (früher Breitengrad) setzen. Erforderlich vor Nutzung der Sonnenauf- / Sonnenuntergangsfunktionen (sunrise/sunset usw.)
Wert für die geographische Breite (früher Breitengrad) setzen. Erforderlich vor Nutzung der Sonnenauf- / Sonnenuntergangsfunktionen (sunrise/sunset usw.)


* [[Sunset Sunrise]]  
* [[SUNRISE_EL]]  


==== attr global longitude 6.XYZ ====
==== attr global longitude 6.XYZ ====
Wert für die geographischen Länge (früher Längengrad) setzen. Erforderlich vor Nutzung der Sonnenauf- / Sonnenuntergangsfunktionen (sunrise/sunset usw.)
Wert für die geographischen Länge (früher Längengrad) setzen. Erforderlich vor Nutzung der Sonnenauf- / Sonnenuntergangsfunktionen (sunrise/sunset usw.)


* [[Sunset Sunrise]]  
* [[SUNRISE_EL]]  


==== attr global verbose X ====
==== attr global verbose X ====
Mit dem Wert "X" legt man die Detailtiefe der protokollierten Informationen fest.
Mit dem Wert "X" legt man die Detailtiefe der protokollierten Informationen fest. Dieses Attribut ist auf einer [[verbose|eigenen Seite]] beschrieben.
 
Hat X den Wert
 
* 0 wird nur der Start und das Beenden des FHEM-Servers protokolliert
* 1 werden zusätzlich Fehlermeldungen und unbekannte Pakete ausgegeben.
* 2 erfolgt eine Ausgabe der wichtigen Ereignisse (events) und Alarmmeldungen.
* 3 werden ausgesendete Befehle geloggt.
* 4 wird protokolliert, was von den verschiedenen Geräte empfangen wurde.
* 5 wird alles ausgegeben ("debugging", Fehlersuche)
 
Ein größerer Wert führt also zu einer höheren Detailtiefe.
 
Für den '''Normalgebrauch''' wird Level 3 empfohlen.


==== attr &lt;Geräte-Name&gt; ignore X ====
==== attr &lt;Geräte-Name&gt; ignore X ====
Zeile 44: Zeile 32:


==== attr &lt;Geräte-Name&gt; room &lt;Raum1&gt;[,Raum2] ====
==== attr &lt;Geräte-Name&gt; room &lt;Raum1&gt;[,Raum2] ====
Über dieses (optionale) Attribut weist man ein FHEM-Gerät einem Raum oder mehreren Räumen zu, der in der linken Spalte der FHEM-Weboberfläche erscheint. Alle diesem Raum zugewiesenen Geräte bzw. FHEM-Einträge tauchen nach einem Klick dieses Raumes dann auf der entsprechenden Raumseite auf.
Über dieses (optionale) Attribut weist man ein FHEM-Gerät einem Raum oder mehreren Räumen zu, der in der linken Spalte der FHEM-Weboberfläche erscheint. Alle diesem Raum zugewiesenen Geräte bzw. FHEM-Einträge tauchen nach einem Klick auf den Namen dieses Raumes dann auf der entsprechenden Raumseite auf.


Mit der erstmaligen Verwendung eines Raumnamens (also neuer Name) wird automatisch dieser Raum erzeugt und in die Raumliste eingefügt.
Mit der erstmaligen Verwendung eines Raumnamens (also neuer Name) wird automatisch dieser Raum erzeugt und in die Raumliste eingefügt.


'''Hinweis:''' Ein evtl. zweiter Raumname ist mit Komma vom ersten Raumnamen zu trennen. Nach dem Komma darf kein Leerzeichen stehen, sonst würde
'''Hinweis:''' Ein evtl. zweiter Raumname ist mit Komma vom ersten Raumnamen zu trennen. Nach dem Komma darf kein Leerzeichen stehen, sonst würde
 
:<code>attr MeinGerät room Keller, Zentrale</code>
<pre> attr MeinGerät room Keller, Zentrale
</pre>


einen Raum " Zentrale" erstellen (also mit einem führenden Leerzeichen, das in der FHEM-Raumliste aber nicht sichtbar ist und die Fehlersuche erschwert).
einen Raum " Zentrale" erstellen (also mit einem führenden Leerzeichen, das in der FHEM-Raumliste aber nicht sichtbar ist und die Fehlersuche erschwert).


Richtig lautet die o.a. Anweisung also
Richtig lautet die o.a. Anweisung also
<pre>
:<code>attr MeinGerät room Keller,Zentrale</code>
attr MeinGerät room Keller,Zentrale
Wenn ein Device einem Raum "..., Zentrale" und ein anderes einem Raum "...,Zentrale" zugewiesen ist, würden in der Raumliste dann zwei Räume mit dem Namen ''Zentrale'' erscheinen.
</pre>
Wenn Sie ein Device einem Raum "..., Zentrale" und ein anderes einem Raum "...,Zentrale" zuweisen, würden in der Raumliste dann 2 Räume mit dem Namen ''Zentrale'' erscheinen.


=== backup ===
=== backup ===
*  [[Backup]]  
Sicherung der FHEM-Installation. Dieser Befehl ist auf einer [[backup|eigenen Seite]] beschrieben.


=== include ===
=== include ===
Die Nutzung von include wird nur noch "Experten" empfohlen. Der Sinn wird zunehmend (auch von Experten) angezweifelt. Siehe auch [[Konfiguration]].
[[Datei:Info_red.png|25px]]Die Nutzung von include wird nur "Experten" empfohlen. Siehe auch [[Konfiguration]].[[Datei:Info_red.png|25px]]


Wer es nicht lassen kann:<br/>
Es können Teile der ''fhem.cfg'' in separate Dateien auslagert werden. Mit dem Befehl ''include'' müssen diese "Auslagerungsdateien" dann wieder in FHEM eingebunden werden.
Man kann - z.B. aus Gründen der Übersichtlichkeit, Struktur, Ordnung - Teile der ''fhem.cfg'' in separate Dateien auslagern. Mittels des Befehls ''include'' können diese "Auslagerungsdateien" dann wieder in FHEM eingebunden werden.


<ins>Beispiel:</ins> ''include /opt/fhem/FHEM/homematic.cfg''
Dieser Befehl ist auf einer [[Include|eigenen Seite]] beschrieben.
 
Ein <ins>Vorteil</ins> - wenn man diese Dateien nicht im selben Ordner wie die ''fhem.cfg''-Datei (hier wäre das ''/opt/fhem/''), sondern in ''/opt/fhem/FHEM/'' speichert - ist, dass diese Dateien dann innerhalb der FHEM-Weboberfläche über den Menüpunkt ''Edit files'' erreichbar (editierbar) sind. Sie stehen dann im Bereich der ''Own modules and helper files''. Ansonsten muss man auf diese Dateien per remote-Sitzung oder einem anderen Programm (SSH / FTP) zugreifen.
 
'''Hinweis:''' Diese separaten Dateien können per ''rereadcfg &lt;Pfad&gt;/homematic.cfg'' '''einzeln''' wieder eingelesen werden.
Die includes sollten unter der Hardwarekonfiguration (CUL/FHZ/...) in die fhem.cfg hinzugefügt werden, ansonsten bleiben die Aktoren ohne Funktion!


=== list ===
=== list ===
Mittels ''list'' können Sie sich z.B. die Eigenschaften / Auswirkungen eines ''at''-Befehls oder eines Gerätes ausgeben lassen.
Mittels ''list'' können Sie sich z.B. die Eigenschaften / Auswirkungen eines ''at''-Befehls oder eines Gerätes ausgeben lassen. Dieser Befehl ist auf einer [[List|eigenen Seite]] beschrieben.
 
* [[Sunset Sunrise]]  
<pre>
  list .*  DEF    # Auflistung der Definitionen aller Geräte
  list wz.* DEF    # Auflistung der Definitionen der Geräte, die mit wz beginnen.
</pre>
 
=== notify ===
* [[Batterieüberwachung]]
* [[Funktionsbeschreibung zu notify]]


=== reload ===
=== reload ===
Eine einzelne Moduldatei soll neu eingelesen werden. Dadurch werden - ohne Neustart - vorgenommene Änderungen in dieser Moduldatei verfügbar.
Eine einzelne Moduldatei soll neu eingelesen werden. Dadurch werden - ohne Neustart - vorgenommene Änderungen in dieser Moduldatei verfügbar. Dieser Befehl ist auf einer [[reload|eigenen Seite]] beschrieben.
 
<ins>Beispiel:</ins> ''reload 99_myUtils''
 
=== [http://fhem.de/commandref.html#rereadcfg rereadcfg] ===
Dieser Befehl, abgesetzt z.B. über das Befehls-Eingabefeld der Fhem-Oberfläche, veranlasst ein Neueinlesen der aktuellen oder einer alternativen [[Konfiguration]]. Im letzteren Fall muss der Name der neu einzulesenden Konfiguration explizit angegeben werden.
 
Es können '''nicht''' einzelne ''include'' Dateien auf diesem Weg neu eingelesen werden. Das "reread" bezieht sich immer auf eine komplette Konfiguration, also der Basisdatei (Standard: fhem.cfg) einschließlich aller eventuell darüber hinaus referenzierten ''include'' Dateien (siehe auch diesen {{Link2Forum|Topic=8686|Message=45609}})!
 
=== twilight ===
*  [[Twilight Anwendungsbeispiel]]
 
=== update ... ===
FHEM ab Version 5.3
 
Syntax:
<pre>
update [development|stable] [&lt;file&gt;|check|fhem|full] [force]
</pre>
 
Seit dem 19.08.2014 wird ein neues Update-Modul ({{Link2Forum|Topic=26311}}) von Fhem verteilt. Die Syntax lautet:
<pre>
update [<fileName>|all|check|force] [http://.../controlfile]
</pre>
 
'''Hinweise:'''
* bis 18.08.2014: Fhem führt (so voreingestellt) ein Backup der bisherigen Installations- '''und''' Konfigurationsdateien vor einem Update durch.
* ab 19.08.2014: Fhem sichert "nur" die Modul(Installations-)dateien standardmäßig. Backup muss separat eingeschaltet werden. Details: {{Link2Forum|Topic=26311}}
* Lesen Sie aufmerksam die nach dem Update auf dem Monitor erscheinenden Meldungen.
* Nach einem Update ist immer ein ''shutdown restart'' erforderlich.
 
==== update ====
Die ganze Fhem-Installation wird auf die neueste Version gebracht.
 
==== update check ====
Es wird angezeigt, was alles neu ist. Es wird nicht installiert.
 
==== update development ====
-- In Fhem ab Stand 19.08.2014 nicht mehr enthalten --<br/>
Sie führen ein Update auf die in der Entwicklung befindliche FHEM-Version durch. Dies kann dazu führen, dass einiges nicht (mehr) so läuft, wie Sie es gewohnt sind. Für ein bisher stabiles und produktiv eingesetztes FHEM-System sollte daher besser nur der Befehl ''update stable'' genutzt werden. Dazu sollte man aber eins wissen: Es gibt faktisch keinen Unterschied zwischen '''stable''' und '''development''', da nur eine Version gepflegt wird.
 
==== update force ====
Das Update wird erzwungen (falls es beim regulären ''update'' Probleme geben sollte).


==== update &lt;Dateiname&gt; ====
=== rereadcfg ===
Mit z.B. ''update 02_HTTPSRV.pm'' installiert man nur eine neue Version der Datei ''02_HTTPSRV.pm''. Alle anderen FHEM-Dateien werden nicht angetastet.
Dieser Befehl, abgesetzt z.B. über das Befehls-Eingabefeld der FHEM-Oberfläche, veranlasst ein Neueinlesen der aktuellen oder einer alternativen [[Konfiguration]]. Dieser Befehl ist auf einer [[rereadcfg|eigenen Seite]] beschrieben.


=== update ===
Aktualisierung der FHEM-Installation. Dieser Befehl ist auf einer [[Update|eigenen Seite]] beschrieben.


[[Kategorie:FhemBefehl]]
[[Kategorie:FHEM Befehl]]

Aktuelle Version vom 3. Mai 2019, 14:26 Uhr

X mark.svg
Dieses Seite dient (aus historischen Gründen) als reine Weiterleitung auf die verlinkten separaten Wiki-Seiten.

Bitte diesen Artikel nicht mehr erweitern, sondern die separaten Wiki-Seiten in Kategorie:FHEM Befehl bearbeiten beziehungsweise dort fehlende Befehls-Seiten neu anlegen.


Allgemeines

Dies soll kein Ersatz für die FHEM Command Reference sein. Es geht hier vorwiegend um voll ausgeschriebene Befehle zum besseren Verständnis. Die Command Reference listet alle Befehle, Optionen und Möglichkeiten auf, aber manchmal übersieht man in der Vielzahl an Informationen eine Kleinigkeit und schon funktioniert es nicht. Es werden nicht alle Optionen erläutert.

Sofern es im Wiki schon Beiträge gibt, die einzelne Befehle ähnlich diesem Beitrag abhandeln, erfolgt ein Verweis auf diese; alle existierenden Beiträge zu FHEM-Befehlen sind zudem in der Kategorie FHEM Befehl aufgelistet.

at

at kann man vergleichen mit den "Geplanten Tasks" (Windows) oder "cron" (Linux). Abhängig von der Uhrzeit (immer um 04:00 Uhr) bzw. abgelaufenen Zeitspannen (alle 5 Minuten) werden weitere Befehle ausgelöst. Dieses Hilfsmodul ist auf einer eigenen Seite beschrieben.

attr

Mit attr weist man einem FHEM-Gerät bestimmte Attribute (Merkmale / Eigenschaften) zu. Weiterhin setzt man damit z.B. auch allgemein gültige (globale) Eigenschaften der FHEM-Installation (latitude, longitude, verbose). Dieser Befehl ist auf einer eigenen Seite beschrieben.

attr global latitude 5X.XYZ

Wert für die geographische Breite (früher Breitengrad) setzen. Erforderlich vor Nutzung der Sonnenauf- / Sonnenuntergangsfunktionen (sunrise/sunset usw.)

attr global longitude 6.XYZ

Wert für die geographischen Länge (früher Längengrad) setzen. Erforderlich vor Nutzung der Sonnenauf- / Sonnenuntergangsfunktionen (sunrise/sunset usw.)

attr global verbose X

Mit dem Wert "X" legt man die Detailtiefe der protokollierten Informationen fest. Dieses Attribut ist auf einer eigenen Seite beschrieben.

attr <Geräte-Name> ignore X

Ausblenden von fremden Geräten aus der FHEM-Konfiguration.

attr <Geräte-Name> room <Raum1>[,Raum2]

Über dieses (optionale) Attribut weist man ein FHEM-Gerät einem Raum oder mehreren Räumen zu, der in der linken Spalte der FHEM-Weboberfläche erscheint. Alle diesem Raum zugewiesenen Geräte bzw. FHEM-Einträge tauchen nach einem Klick auf den Namen dieses Raumes dann auf der entsprechenden Raumseite auf.

Mit der erstmaligen Verwendung eines Raumnamens (also neuer Name) wird automatisch dieser Raum erzeugt und in die Raumliste eingefügt.

Hinweis: Ein evtl. zweiter Raumname ist mit Komma vom ersten Raumnamen zu trennen. Nach dem Komma darf kein Leerzeichen stehen, sonst würde

attr MeinGerät room Keller, Zentrale

einen Raum " Zentrale" erstellen (also mit einem führenden Leerzeichen, das in der FHEM-Raumliste aber nicht sichtbar ist und die Fehlersuche erschwert).

Richtig lautet die o.a. Anweisung also

attr MeinGerät room Keller,Zentrale

Wenn ein Device einem Raum "..., Zentrale" und ein anderes einem Raum "...,Zentrale" zugewiesen ist, würden in der Raumliste dann zwei Räume mit dem Namen Zentrale erscheinen.

backup

Sicherung der FHEM-Installation. Dieser Befehl ist auf einer eigenen Seite beschrieben.

include

Info red.pngDie Nutzung von include wird nur "Experten" empfohlen. Siehe auch Konfiguration.Info red.png

Es können Teile der fhem.cfg in separate Dateien auslagert werden. Mit dem Befehl include müssen diese "Auslagerungsdateien" dann wieder in FHEM eingebunden werden.

Dieser Befehl ist auf einer eigenen Seite beschrieben.

list

Mittels list können Sie sich z.B. die Eigenschaften / Auswirkungen eines at-Befehls oder eines Gerätes ausgeben lassen. Dieser Befehl ist auf einer eigenen Seite beschrieben.

reload

Eine einzelne Moduldatei soll neu eingelesen werden. Dadurch werden - ohne Neustart - vorgenommene Änderungen in dieser Moduldatei verfügbar. Dieser Befehl ist auf einer eigenen Seite beschrieben.

rereadcfg

Dieser Befehl, abgesetzt z.B. über das Befehls-Eingabefeld der FHEM-Oberfläche, veranlasst ein Neueinlesen der aktuellen oder einer alternativen Konfiguration. Dieser Befehl ist auf einer eigenen Seite beschrieben.

update

Aktualisierung der FHEM-Installation. Dieser Befehl ist auf einer eigenen Seite beschrieben.

Abgerufen von „http://wiki.fhem.de/w/index.php?title=FHEM_Command_Beispiele&oldid=30375“