Adapter installieren / verwalten

Adapter

Über sogenannte Adapter kommuniziert ioBroker mit unterschiedlichsten Systemen, aus dem Bereich Smart Home z.B. mit HomeMatic, KNX, FS20 und EnOcean, aus dem Bereich Home Entertainment mit Sonos-Systemen, Dreamboxen, diversen AV-Receivern und SmartTVs, mit unterschiedlichsten Webservices und diverser Software wie z.B. MySQL oder Graphite.


Erzeugen von Instanzen

Um die Adapter nutzen zu können, muss eine Instanz installiert und konfiguriert werden.

Dazu klickt man in der WebUI des Administrators in dem Reiter Adapter in der Zeile des gewünschten Adapters auf das (+) ganz rechts.

Adapter Übersicht
Adapter Übersicht

 

 

Anschließend wird eine Instanz des Adapters erzeugt und in der Spalte installiert erscheint in eckigen Klammern die Anzahl der erzeugten und der aktivierten Instanzen (z.B. [2/1]) Zusätzlich wird bei der Zahl der aktivierten Instanzen auch noch durch die Farbe grün signalisiert, dass alles in Ordnung läuft.

Weiterhin erscheint die installierte Instanz jetzt in dem Reiter Instanzen.

Von den meisten Adaptern können beliebig viele Instanzen erzeugt werden. Sollte dies bei einem Adapter nicht möglich sein, kommt beim Versuch eine weitere Instanz anzulegen eine entsprechende Fehlermeldung.


Konfiguration der erzeugten Instanz

Um die soeben erzeugte Instanz zu konfigurieren muss auf den Reiter Instanzen gewechselt werden. Dort klickt man auf das Konfigurations-Icon oder den Namen der Instanz.

 

Instanzen Übersicht
Instanzen Übersicht

Ein adapterspezifisches Konfigurationsmenü öffnet sich. Die dort notwendigen Konfirurationen werden auf der Seite des entsprechenden Adapters beschrieben. Diese ist über das Menü auf der linken Seite erreichbar.


Aktivieren einer Instanz

Die konfigurierte Instanz des Adapters muss jetzt noch aktiviert werden, damit sie in ioBroker zur Verfügung steht. Dazu klickt man in der Zeile der entsprechenden Instanz auf das rote Play-Icon. Zum Stoppen wird analog das grüne Pause-Icon geklickt.

Anschließend können einige Felder in dieser Zeile aktiviert werden, um deren Inhalt zu ändern:

Verbindung

Ganz links in jeder Zeile steht eine Anzeige über den Verbindungsstatus. Grün bedeutet verbunden. Eine Mouse-Over-Funktion gibt ebenfalls Informationen.

 

Titel

Hier kann für die Instanz ein eindeutiger Name eingetragen werden, um bei der Installation mehrerer Instanzen eines Adapters diese voneinander unterscheiden zu können

 

Server

Auf Multihost Systemen kann der Server gewählt werden

 

Zeitplanung

Einige Adapter werden über eine Zeitplanung aktiviert. Sie führen eine Funktion aus und trennen sich dann wieder vom Server, bis zum nächsten Termin. Die Planung wird in Cron-Zeit vorgenommen.


Adapter- / Instanzwebseite öffnen

Einige Adapter (allen voran VIS) lassen sich über eine eigene Webseite bedienen. Diese lässt sich seit admin 1.0.1 auch mit dem Klick auf den fünften Button öffnen.

Admin Adapter Webseite
Zum Öffnen der Adapter-Webseite den fünften Button (hier in blau) klicken

 


Experten-Modus

Der Modus lässt sich über den Knopf links oben einschalten. Es erscheinen zwei weitere Spalten für Experten-Einstellungen.

In der Spalte Log Stufe kann noch eingegeben werden wie hoch der loglevel dieser Instanz in dem ioBroker-log sein soll (debug, info, warn, error).

Die Spalte RAM-Level erlaubt die Begrenzung des Speicherbedarfs für diesen Adapter.


Installation einer älteren Version

Sollte es mit einer Version Probleme geben, kann man eine ältere Version installieren mit

cd /opt/iobroker

iobroker stop

npm install iobroker.adaptername@0.1.2 --production

iobroker upload adaptername

iobroker start

Bitte adaptername und die Versionsnummer entsprechend anpassen