Fronthem Installation

Dieser Artikel befasst sich mit der Installation von "fronthem". Es stellt ein Interface zur Verfügung, um ein Webfrontends wie z.B. smartVISU an FHEM anzubinden. Die Konfiguration und das Interface selbst sind im Hauptartikel von fronthem beschrieben.

Alle Artikel zur Thematik fronthem/smartVISU sind hier kategorisiert.

---

Vorraussetzungen schaffen

In Abhängigkeit der verwendeten Distribution gibt es mehrere Möglichkeiten, die einzelnen Pakete zu installieren (Forum). Für einige Installationsschritte ist das Paket build-essential, dass über diesen Befehlt installiert werden kann. Sonst können die make's während der folgenden Schritte nicht ausgeführt werden (Forum).

sudo apt-get install build-essential

cpanmin

curl -L https://cpanmin.us | perl - --sudo App::cpanminus

oder

sudo apt-get install cpanminus

WebSocket

sudo cpanm Net::WebSocket::Server

oder (Forum)

sudo cpan install Net::WebSocket::Server

JSON

sudo cpanm JSON

oder

sudo cpan install JSON

oder falls es Probleme mit CPAN und Debian z.B. auf dem RPi gibt, kann man JSON auch über die normale Paketverwaltung installieren (Forum):

sudo apt-get install libjson-perl

Module herunterladen

Mit folgendem Befehl kann man fronthem installieren / updaten (in Eingabezeile von FHEM eingeben):

update force https://raw.githubusercontent.com/herrmannj/fronthem/master/controls_fronthem.txt

Durch die Option force werden bei erneutem Aufruf auch erneut alle Dateien heruntergeladen und das Update so erzwungen.

Update Juni 2025:

Derzeit wird fronthem nicht aktiv weiterentwickelt. Es haben sich jedoch über die Jahre einige Verbesserungen im Forum angesammelt, die entweder den Austausch einzelner Dateien erforderten, oder die Änderung von Codezeilen. Um hier ein funktionierendes Gesamtpaket anzubieten, wurden alle Änderungen behelfsmäßig in ein alternatives Repository eingearbeitet: https://github.com/wvhn/fronthem. Im master branch ist dort eine gut getestete Version, die ohne weitere Modifikation lauffähig ist. Der develop branch enthält weitere Neuerungen vor allerm bei der universellen Zeitschaltuhr und den Plots. Allerdings sind diese Änderungen nicht breit getestet und die Dokumentation ist noch lückenhaft (Forum, Forum, Forum).

Ersteinrichtung innerhalb von FHEM

Die Konfiguration von fronthem in FHEM (Eingabe in der Fhem Web Kommandozeile):

define <Name Webservice> fronthem

define <Name Endgerät> fronthemDevice <IP Endgerät>

Beispiel:

define meinfronthem fronthem

define meiniphone fronthemDevice 192.168.178.25

Näheres zur Einrichtung und Konfiguration innerhalb von FHEM findet sich im Hauptartikel von fronthem.

Troubleshooting

Fehler bei Installation von WebSocket

Zum einen ist für die Installation das Paket build-essential notwendig, dass z.B. über folgenden Befehl installiert werden kann:

sudo apt-get install build-essential

Darüber hinaus muss die Konfiguration des Netzwerk-Interfaces korrekt und vollständig sein (Forum).

Port 2121 belegt

Ist der Port 2121 bereits durch einen anderen Dienst belegt, z.B. ein OWS Server, gibt es beim Versuch den Websocketserver zu starten eine Fehlermeldung (Forum).