FHEM User Interface Painter

Der FHEM User Interface Painter (FUIP) ist ein FHEM-Modul, mit dem man FHEM Tablet UI (FTUI) Seiten graphisch ("klickibunti") erstellen kann. D.h. man kann sich ein UI zusammenklicken, welches die Tablet UI Technik verwendet, aber ohne sich selbst unbedingt mit HTML und CSS herumschlagen zu müssen. Hier ist ein kurzes Video, welches FUIP in Aktion zeigt:

Einführungsvideo

(Das Video zeigt nicht unbedingt den neusten Stand, aber es dürfte klar werden, wofür FUIP gut sein soll.)

Installation und Upgrade in FHEM

FUIP verwendet FTUI. D.h. man sollte zuerst einmal FTUI installieren, falls noch nicht passiert. Wie das geht steht bei FHEM Tablet UI, FUIP ist nicht automatisch Teil von FHEM. Es muss explizit installiert bzw. hinzugefügt werden. Die Installation funktioniert folgendermaßen:

• FUIP benötigt die Perl-Module URI::Escape::XS und JSON::Parse. Oft fehlt mindestens eins dieser Module in einer normalen FHEM-Installation. Unter Debian (inklusive normaler Raspberry-Installationen) sind diese Module in den Paketen liburi-escape-xs-perl und libjson-pp-perl enthalten, sie können also mittels apt-get install liburi-escape-xs-perl libjson-pp-perl (auf Betriebssystemebene als root) installiert werden. Ansonsten können die Module z.B. über Cpan installiert werden, also etwa cpan URI::Escape::XS sowie cpan JSON::Parse.
• Dann das HM485-Repository zum FHEM Update hinzufügen:
  • update add https://raw.githubusercontent.com/kc-GitHub/FHEM-HM485/master/controls_hm485.txt
• Jetzt update force hm485 und shutdown restart. HM485 sollte jetzt installiert sein.
• Es muss jetzt noch sichergestellt werden, dass das Programm HM485d.pl (im Verzeichnis FHEM/lib/HM485/HM485d) für den User fhem ausführbar ist. Das ist normalerweise nicht automatisch der Fall. Es muss im Zweifelsfall per sudo chmod a+x HM485d.pl ausführbar gemacht werden.

Zum Upgrade reicht ein update, wenn man HM485 wie oben beschrieben installiert hat. Ansonsten kann man auch das HM485-Repository nachträglich eintragen wie oben beschrieben. Wenn man von einer manuellen Installation auf die "update add"-Variante wechselt, dann sollte man das erste Mal immer update force hm485 machen. Will man nur den HM485-Teil aktualisieren und nicht alles in FHEM, dann geht das mit update all hm485.

Falls es insbesondere beim Upgrade oder nach einem Upgrade Probleme gibt (welcher Art auch immer), sollten die folgenden Punkte geprüft werden:

• Wird das richtige Repository benutzt? Man kann das mit update list überprüfen. Wenn der Eintrag für hm485 nicht genau so aussieht wie oben beschrieben, dann sollte er per update delete gelöscht werden und dann genau so eingetragen werden wie oben beschrieben. Insbesondere Zwischenversionen wie "dev", "v0800" oder "thorsten" gibt es nur temporär und sollten nur zum Testen verwendet werden.
• Ist XML::Simple installiert? Siehe die Installationanleitung weiter oben für Details.
• FHEM braucht Schreibrechte im Verzeichnis <fhem>/FHEM/lib/HM485/Devices (<fhem> steht meistens für /opt/fhem) und allen Dateien und Unterverzeichnissen. Auf Betriebssystemebene (Linux) kann man das mit ls -ls überprüfen. Meistens kann es mit folgendem Befehl repariert werden: chown -R fhem:dialout /opt/fhem/FHEM/lib/HM485/Devices.
• Wenn das nicht hilft, dann kann man auch vor einem shutdown restart alle pm-Dateien im Devices-Verzeichnis löschen (rm /opt/fhem/FHEM/lib/HM485/Devices/*.pm). Diese Dateien werden beim nächsten FHEM-Start neu generiert.