Gerät

Aus FHEMWiki


Clock - Under Construction.svg An dieser Seite wird momentan noch gearbeitet.


Begriff

Ein Gerät (engl. Device) ist eine elementare Komponente im FHEM-System. Geräte werden in der Regel vom Benutzer per Definition erzeugt oder automatisch per autocreate angelegt. Eine Definition beinhaltet drei wesentliche Parameter.

  • Gerätename, eine eindeutige Bezeichnung, die der Benutzer vergibt.
  • Gerätetyp, mit dieser Angabe wird das Modul festgelegt von dem das Gerät instanziert wird. Das Modul bestimmt die Funktionen des Gerätes. Gerätetypen sind mit den Namen in der Befehlsreferenz identisch, z.B. ist der Name Calendar der Geräteyp und bezieht sich auf das Modul 57_Calendar.pm.
  • typspezifische Angaben, das sind Angaben, die in der Befehlsreferenz zu den einzelnen Gerätetypen beschrieben sind.

Erzeugen eines Gerätes

Ein Gerät wird mit dem Befehl define erzeugt.

define <Gerätename> <Gerätetyp> <typspezifische Angaben>

Funktion eines Gerätes

  • Angaben zur Darstellung im Frontend liefern, z.B. Temperatur, Feuchte, Schaltzustand, Set- u. Get-Befehl oder die Gerätezeile der Raumansicht
  • typenbedingte Aufbereitung von Daten, z.B.
  • typenbedingte Funktionen ausführen, z.B. auf Ereignisse reagieren und verknüpfen, Befehle ausführen, Daten liefern.
  • Schnittstelle zu anderen Geräten bereitstellen und bedienen, z.B. ein Gerät vom Typ SOMFY tauscht Daten mit einem Ein- u. Ausgabegerät (E/A-Gerät) vom Typ SIGNALduino aus.
  • Datenaustauch mit Hardware realisieren, z.B. ein Gerät vom Typ SIGNALduino bedient als E/A-Gerät uber eine USB-Schnittstelle die Hardware SIGNALduino.

Detailansicht im FHEMWEB-Frontend

Die Detailansicht eines Gerätes kann aus der Raumansicht aufgerufen werden, über den Link mit dem Gerätenamen oder dem Alias.

Die Detailansicht dient der Konfiguration und der Darstellung von Gerätedaten.

Geraetedetailansicht.png

Die Detailansicht ist in die nachfolgend beschriebenen Bereiche gegliedert.

A) Gerätezeile (DeviceOverview)

Die Gerätezeile zeigt eine Vorschau der Gerätedarstellung, wie sie in der Raumansicht zusehen ist. Diese Ansicht kann durch Attribute, wie (readingList, webCmd, setList, widgetOverride, devStateIcon, icon) verändert werden, sofern die Attribute vom Gerät unterstützt werden.

B) typspezifischer Bereich

In diesem Bereich legt das Modul fest welche Dinge angezeigt werden. Im Bild ist zu sehen, dass der Event-Monitor in der Detailansicht des DOIF eingeblendet werden kann, siehe auch DevelopmentFHEMWEB#FW_detailFn.

C) Bereich der Set- u. Get-Befehle

In diesem Bereich befinden sich die Knöpfe set und get, sofern ein Modul Set- o. Get-Befehle bereitstellt. Der Bereich stellt eine, durch den Gerätetyp festgelegte Benutzerschnittstelle dar, z.B. kann ein Gerät, dass für eine Funksteckdose angelegt wurde, durch Bedienen des Set-Knopfes die Funksteckdose ein- o. ausgeschalteten.

D) Liste der Internals

E) Liste der Readings

F) Attr-Befehl und Liste der gesetzten Attribute (Attributes)

G) Liste der wahrscheinlich verbundenen Geräte (Probably associated with)

H) zusätzliche Befehle