list

Aus FHEMWiki
Version vom 16. September 2015, 14:00 Uhr von Ph1959de (Diskussion | Beiträge) (Erste Version der Seite)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)


list
Zweck / Funktion
Befehl zur Auflistung von Gerätedefinitionen
Allgemein
Typ Befehl
Details
Dokumentation EN / DE
Support (Forum) Sonstiges
Modulname fhem.pl ("Built-in")
Ersteller rudolfkoenig (Forum / Wiki)
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Der Befehl list dient dazu, Informationen über Geräte (Devices) anzuzeigen. Dabei können entweder Details zu einem einzelnen Gerät ausgegeben werden, oder eine Liste von Geräten (Gerätenamen) mit bestimmten gemeinsamen Attributen.

Der Befehl kann direkt über das Webfrontend eingegeben werden.

Beispiele

Alle Geräte eines bestimmten Typs

Mit dem Befehl

list TYPE=FS20

wird eine Liste (die Namen) aller Geräte des Typs FS20 ausgegeben. Die aufgeführten Namen sind als Link formatiert und führen auf die Detail-Anzeige des betreffenden Geräts.

Alle Geräte ohne TYPE

Manche Fehlersituationen in Fhem werden verursacht durch Geräte, bei denen kein Internal mit dem Namen TYPE festgelegt ist (was eigentlich eine ungültige Definition ist). Diese Geräte-Definitionen lassen sich mit dem Befehl

{ join("\n", grep { !defined($defs{$_}{TYPE}) } keys %defs) }

identifizieren. Mithilfe dieser Information lässt sich dann z.B. ein solches Gerät löschen.

Ein derartiges Szenario ist unter anderem in diesem Forenthema beschrieben.

Alle Geräte in einem Raum

Ausgabebeispiel eines list Befehls

Mit dem Befehl

list room=TV

werden die Namen aller Geräte aufgeführt, die ein Attribut room mit dem Wert TV haben. Durch einen Klick auf den Gerätenamen wird die Detailansicht des Gerätes aufgerufen.