|
|
Zeile 7: |
Zeile 7: |
| |ModOwner=setstate ({{Link2FU|7023|Forum}}) | | |ModOwner=setstate ({{Link2FU|7023|Forum}}) |
| }} | | }} |
| FTUI3 = [[FHEM Tablet UI v3]] ist ein funktionsreiches Frontend-Framework zum Steuern und Überwachen von in FHEM integrierten Geräten. Es basiert auf HTML/CSS/JavaScript und stellt somit keine zusätzlichen Anforderungen an den FHEM-Server. Es ist die Nachfolgeversion von FHEM Tablet UI v2 aber nicht abwärtskompatibel. Ein Umstieg auf FTUI3 hat eine Neu-Programmierung der Oberfläche zur Folge. | | FTUI3 = [[FHEM Tablet UI v3]] ist ein funktionsreiches Frontend-Framework zum Steuern und Überwachen von in FHEM integrierten Geräten. Es basiert auf HTML/CSS/JavaScript und stellt somit keine zusätzlichen Anforderungen an den FHEM-Server. Es ist die Nachfolgeversion von FHEM Tablet UI V2 aber nicht abwärtskompatibel. Ein Umstieg auf FTUI3 hat eine Neu-Programmierung der Oberfläche zur Folge. |
|
| |
|
| Mit Hilfe zahlreicher Komponenten, die sehr leicht mit HTML Code konfiguriert werden können, ist es möglich, innerhalb kurzer Zeit ein den eigenen Wünschen entsprechendes User-Interface aufzubauen. | | Mit Hilfe zahlreicher Komponenten, die sehr leicht mit HTML Code konfiguriert werden können, ist es möglich, innerhalb kurzer Zeit ein den eigenen Wünschen entsprechendes User-Interface aufzubauen. |
|
| |
| == Installation ==
| |
| Die Installation von FHEM Tablet UI v3 (FTUI3) erzeugt keinen großen Aufwand und besteht im Großen und Ganzen aus zwei Schritten:
| |
| *Dateien aus dem GitHub-Repository herunterladen
| |
| *Eine Beispieldatei anlegen
| |
|
| |
| {{Hinweis|Diese Anleitung geht davon aus, dass FHEM unter Debian nach der Anleitung [https://debian.fhem.de Stable build using apt] installiert wurde.
| |
| Ist dies nicht der Fall, muss der Pfad '''/opt/fhem''' dementsprechend angepasst werden.}}
| |
|
| |
|
| |
| '''1.''' Zuerst müssen alle Dateien von FHEM Tablet UI in das FHEM-Verzeichnis '''/opt/fhem/www/ftui''' kopiert werden. Das geht mit folgendem '''update'''-Befehl über die FHEM-Befehlszeile.
| |
| :<code>update all https://raw.githubusercontent.com/knowthelist/ftui/master/controls_ftui.txt</code>
| |
|
| |
| :[[Datei:FTUI3_Installation_01.png|thumb|none|Schritt 1: Dateien kopieren]]
| |
|
| |
|
| |
| <nowiki>{{FTUI3 kann in weiterer Folge unter der URL </nowiki>'''<nowiki>http(s)://<fhem-server>:8083/fhem/ftui/index.html</nowiki>''' aufgerufen werden.
| |
|
| |
| '''2.''' Damit FHEM Tablet UI mit FHEM kommunizieren kann, ist noch die '''longpoll'''-Einstellung im [[FHEMWEB]] Device festzulegen.
| |
|
| |
| :<code>attr WEB longpoll websocket</code>
| |
| :bzw. bei Problemen mit ''websocket''
| |
| :<code>attr WEB longpoll 1</code>
| |
|
| |
| :[[Datei:FTUI3_Installation_03.png|thumb|none|Schritt 3: longpoll einstellen]]
| |
|
| |
|
| |
| '''3.''' Weil FTUI noch nichts anzuzeigen hat, wird die Datei '''/opt/fhem/www/ftui/index-example.html''' nach '''/opt/fhem/www/ftui/index.html''' kopiert.
| |
| :<code>sudo cp -a /opt/fhem/www/ftui/index-example.html /opt/fhem/www/ftui/index.html</code>
| |
|
| |
| :[[Datei:FTUI3_Installation_04.png|thumb|none|Schritt 4: index.html erstellen]]
| |
|
| |
|
| |
| '''4.''' Abschließend muss FHEM noch '''neu gestartet''' werden (''shutdown restart'') da das Attribut '''longpoll''' geändert wurde.
| |
|
| |
|
| |
| Somit ist FHEM Tablet UI bereit zur Verwendung und kann durch Aufruf der URL '''<nowiki>http://<fhem-server>:8083/fhem/ftui/</nowiki>''' oder den Link im FHEM-Menü geöffnet werden
| |
|
| |
| == Update ==
| |
| Ein Update von FTUI kann ebenfalls über die FHEM-Kommandozeile erfolgen.
| |
|
| |
| '''1.''' Prüfen der Änderungen seit dem letzten Download/Update durch Eingabe von:
| |
| :<code><nowiki>update check https://raw.githubusercontent.com/knowthelist/ftui/master/controls_ftui.txt</nowiki></code>
| |
|
| |
|
| |
| '''2.''' Update der geänderten Dateien durch Eingabe von:
| |
| :<code><nowiki>update all https://raw.githubusercontent.com/knowthelist/ftui/master/controls_ftui.txt</nowiki></code>
| |
|
| |
|
| |
| Eine weitere Option ist das Hinzufügen des FTUI-Git-Repositories zum allgemeinem Update-Vorgang von FHEM. Dabei wird dann bei einem FHEM-Update auch gleich FHEM Tablet UI aktualisiert, bzw. die Änderungen angezeigt.
| |
| :<code><nowiki>update add https://raw.githubusercontent.com/knowthelist/ftui/master/controls_ftui.txt</nowiki></code>
| |
|
| |
| Beachte: Das Ergebnis des o.g. Befehls wird in FHEM/controls.txt eingetragen, siehe auch [[Update#update_add]]
| |
|
| |
|
| == Dokumentation == | | == Dokumentation == |
FHEM Tablet UI V3
|
Zweck / Funktion
|
Oberfläche für FHEM v3
|
Allgemein
|
Typ
|
Inoffiziell
|
Details
|
Dokumentation
|
Thema
|
Support (Forum) |
TabletUI
|
Modulname |
n.a.
|
Ersteller |
setstate (Forum )
|
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!
|
FTUI3 = FHEM Tablet UI v3 ist ein funktionsreiches Frontend-Framework zum Steuern und Überwachen von in FHEM integrierten Geräten. Es basiert auf HTML/CSS/JavaScript und stellt somit keine zusätzlichen Anforderungen an den FHEM-Server. Es ist die Nachfolgeversion von FHEM Tablet UI V2 aber nicht abwärtskompatibel. Ein Umstieg auf FTUI3 hat eine Neu-Programmierung der Oberfläche zur Folge.
Mit Hilfe zahlreicher Komponenten, die sehr leicht mit HTML Code konfiguriert werden können, ist es möglich, innerhalb kurzer Zeit ein den eigenen Wünschen entsprechendes User-Interface aufzubauen.
Dokumentation
https://github.com/knowthelist/ftui/
Best practices
FTUI3 Best Practices (aktuell in Arbeit)