list
| 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. Wenn mehrere Geräte aufgelistet werden lässt sich zu jedem zusätzlich der Wert eines Internal, Reading oder Attribut mit ausgeben.
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 mit einem bestimmten Attribut
Im Zusammenhang mit Verhaltensänderungen eines Attributs (wie z.B. bei userReadings geschehen), kann es sinnvoll sein, alle Devices aufzulisten, bei denen dieses Attribut verwendet wurde.
- alle Devices, bei denen das Attribut userReadings (auf einen beliebigen Wert gesetzt) ist
list userReadings=[a-zA-Z].*oderlist userReadings=\w.*
Alle Geräte in einem Raum
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.
Attributwert zu mehreren Geräten
Mit dem Befehl
list TYPE=CUL_HM serialNr
werden die Seriennummern aller Homematic Geräte aufgelistet.