Fronthem - Versionsgeschichte

Siggi: /* device connector */ Tippfehler

2023-01-22T10:32:48Z

device connector: Tippfehler

← Nächstältere Version		Version vom 22. Januar 2023, 12:32 Uhr
Zeile 33:		Zeile 33:
	Ein Device-Connector dient dazu, ein Endgerät eines Benutzers (PCs, Tablets, Smartphones usw.) als Client zu konfigurieren und dessen Berechtigungen (read, write) auf der Ebene einzelner Objekte zu steuern. Damit können z. B. die Nachkommen oder Gäste zwar das Licht und die Heizung im eigenen Raum steuern, nicht aber die Programmierung der Heizung ändern oder den Alarm ausschalten.		Ein Device-Connector dient dazu, ein Endgerät eines Benutzers (PCs, Tablets, Smartphones usw.) als Client zu konfigurieren und dessen Berechtigungen (read, write) auf der Ebene einzelner Objekte zu steuern. Damit können z. B. die Nachkommen oder Gäste zwar das Licht und die Heizung im eigenen Raum steuern, nicht aber die Programmierung der Heizung ändern oder den Alarm ausschalten.

	Ein Endgerät wird dabei jeweils als Device vom TYPE <code>~~fromthemdevice~~</code> innerhalb von FHEM definiert. Details zur genauen Einrichtung finden sich im [[#Integration in FHEM\|Verlauf]] dieses Artikels.		Ein Endgerät wird dabei jeweils als Device vom TYPE <code>fronthemdevice</code> innerhalb von FHEM definiert. Details zur genauen Einrichtung finden sich im [[#Integration in FHEM\|Verlauf]] dieses Artikels.

	An einem einzelnen Device-Connector werden die durch den websocket vom externen Frontend mitgeteilten Objekte aufgelistet (GADs) und können dort einerseits mit FHEM Devices verbunden und andererseits in den Berechtigungen des jeweiligen Endgerätes konfiguriert werden.		An einem einzelnen Device-Connector werden die durch den websocket vom externen Frontend mitgeteilten Objekte aufgelistet (GADs) und können dort einerseits mit FHEM Devices verbunden und andererseits in den Berechtigungen des jeweiligen Endgerätes konfiguriert werden.

Krikan: /* eigene Converter */ - Link korrigirert

2017-12-24T23:56:32Z

eigene Converter: - Link korrigirert

← Nächstältere Version		Version vom 25. Dezember 2017, 01:56 Uhr
Zeile 117:		Zeile 117:

	==== eigene Converter ====		==== eigene Converter ====
	Zusätzlich zu den bestehenden Convertern besteht die Möglichkeit, eigene zu definieren. Diese können in der [[99_myUtils.pm]] oder einer neu angelegten 99_fronthemUtils.pm definiert werden. Es ist nicht ratsam, die fhconverter.pm dafür zu verwenden, da bei einem möglichen späteren Update diese Datei überschrieben wird. Wie alle anderen Module, muss sich die Datei im Verzeichnis <code>./fhem/FHEM/</code> befinden ({{Link2Forum\|Topic=30909\|Message=266944\|LinkText=Forum}}).		Zusätzlich zu den bestehenden Convertern besteht die Möglichkeit, eigene zu definieren. Diese können in der [[99 myUtils anlegen\|99_myUtils.pm]] oder einer neu angelegten 99_fronthemUtils.pm definiert werden. Es ist nicht ratsam, die fhconverter.pm dafür zu verwenden, da bei einem möglichen späteren Update diese Datei überschrieben wird. Wie alle anderen Module, muss sich die Datei im Verzeichnis <code>./fhem/FHEM/</code> befinden ({{Link2Forum\|Topic=30909\|Message=266944\|LinkText=Forum}}).

	Eigene Converter müssen nur die gleiche Signatur haben und im gleichen namespace wie die im fhconverter.pm stehen, dann werden sie dynamisch geladen und stehen in fronthem zur Verfügung ({{Link2Forum\|Topic=30909\|Message=236070l\|LinkText=Forum}}).		Eigene Converter müssen nur die gleiche Signatur haben und im gleichen namespace wie die im fhconverter.pm stehen, dann werden sie dynamisch geladen und stehen in fronthem zur Verfügung ({{Link2Forum\|Topic=30909\|Message=236070l\|LinkText=Forum}}).

Ph1959de: weitere kleine Korrekturen

2017-11-13T14:39:22Z

weitere kleine Korrekturen

Ph1959de: Infobox korrigiert / erweitert, ansonsten hauptsächlich Tippfehler korrigiert

2017-11-13T14:34:59Z

Infobox korrigiert / erweitert, ansonsten hauptsächlich Tippfehler korrigiert

Änderungen zeigen

Joshi04: Kapitel: Dateien/Ordner hinzugefügt; Link zum Forumsbereich aktualisiert; Kleinigkeiten

2016-06-26T14:18:27Z

Kapitel: Dateien/Ordner hinzugefügt; Link zum Forumsbereich aktualisiert; Kleinigkeiten

Änderungen zeigen

Joshi04: Groß/Kleinschreibung

2016-06-25T16:32:36Z

Groß/Kleinschreibung

← Nächstältere Version		Version vom 25. Juni 2016, 18:32 Uhr
Zeile 9:		Zeile 9:
	}}		}}

	Dieser Artikel befasst sich mit den FHEM-Modulen und weiteren Dateien, die für die Integration von fronthem in FHEM notwendig sind. Die [[~~Fronthem~~ Installation\|Installation von fronthem]] ist in einem separater Artikel beschrieben.		Dieser Artikel befasst sich mit den FHEM-Modulen und weiteren Dateien, die für die Integration von fronthem in FHEM notwendig sind. Die [[fronthem Installation\|Installation von fronthem]] ist in einem separater Artikel beschrieben.

	Alle Artikel zur Thematik fronthem/smartVISU sind [[:Kategorie:fronthem/smartVISU\|hier]] kategorisiert.		Alle Artikel zur Thematik fronthem/smartVISU sind [[:Kategorie:fronthem/smartVISU\|hier]] kategorisiert.
Zeile 31:		Zeile 31:
	Der Websocket ist eine generische http-Schnittstelle, die von einem externen Frontend aus angesprochen werden kann.		Der Websocket ist eine generische http-Schnittstelle, die von einem externen Frontend aus angesprochen werden kann.

	Der Websocket Server wird durch das fhem-Modul "~~fromthem~~" automatisch gestartet, sobald ein Device vom TYPE <code>fronthem</code> definiert wurde. Der zugehörige Prozess läuft vom fhem Hauptprozess entkoppelt und kann mit ihm kommunizieren.		Der Websocket Server wird durch das fhem-Modul "fronthem" automatisch gestartet, sobald ein Device vom TYPE <code>fronthem</code> definiert wurde. Der zugehörige Prozess läuft vom fhem Hauptprozess entkoppelt und kann mit ihm kommunizieren.

	Der Websocket wird standardmäßig auf Port 2121 angesprochen, wird implizit durch die anderen Bausteine verwendet und benötigt im Prinzip keine weitere Beachtung, außer man möchte das Webinterface auf einem anderen Device neben FHEM laufen lassen.		Der Websocket wird standardmäßig auf Port 2121 angesprochen, wird implizit durch die anderen Bausteine verwendet und benötigt im Prinzip keine weitere Beachtung, außer man möchte das Webinterface auf einem anderen Device neben FHEM laufen lassen.

Joshi04: Link angepasst zur Verschiebung von "Installation fronthem" nach "fronthem Installation"

2016-06-25T16:25:23Z

Link angepasst zur Verschiebung von "Installation fronthem" nach "fronthem Installation"

← Nächstältere Version		Version vom 25. Juni 2016, 18:25 Uhr
Zeile 9:		Zeile 9:
	}}		}}

	Dieser Artikel befasst sich mit den FHEM-Modulen und weiteren Dateien, die für die Integration von fronthem in FHEM notwendig sind. Die [[Installation ~~Fronthem~~\|Installation von fronthem]] ist in einem separater Artikel beschrieben.		Dieser Artikel befasst sich mit den FHEM-Modulen und weiteren Dateien, die für die Integration von fronthem in FHEM notwendig sind. Die [[Fronthem Installation\|Installation von fronthem]] ist in einem separater Artikel beschrieben.

	Alle Artikel zur Thematik fronthem/smartVISU sind [[:Kategorie:fronthem/smartVISU\|hier]] kategorisiert.		Alle Artikel zur Thematik fronthem/smartVISU sind [[:Kategorie:fronthem/smartVISU\|hier]] kategorisiert.

Joshi04: Kategorie fronthem/smartVISU eingeführt; weitere Kleinigkeiten aus dem Forum hinzugefügt

2016-06-24T20:34:46Z

Kategorie fronthem/smartVISU eingeführt; weitere Kleinigkeiten aus dem Forum hinzugefügt

← Nächstältere Version		Version vom 24. Juni 2016, 22:34 Uhr
Zeile 9:		Zeile 9:
	}}		}}

	Dieser Artikel befasst sich mit den FHEM-Modulen und weiteren Dateien, die für die Integration von fronthem in FHEM notwendig sind. ~~Ein weiterer separater Artikel beschreibt die~~ [[Installation Fronthem\|Installation von ~~Fronthem~~]].		Dieser Artikel befasst sich mit den FHEM-Modulen und weiteren Dateien, die für die Integration von fronthem in FHEM notwendig sind. Die [[Installation Fronthem\|Installation von fronthem]] ist in einem separater Artikel beschrieben.

			Alle Artikel zur Thematik fronthem/smartVISU sind [[:Kategorie:fronthem/smartVISU\|hier]] kategorisiert.

			----

	Fronthem verfolgt die Idee, ein externes Web-Frontend (z. B. [[smartVISU]]) an fhem anzukoppeln und den Datenverkehr sowie die Zusammenarbeit von Befehlen und Parametern zwischen FHEM und dem Web-Frontend zu übernehmen.		Fronthem verfolgt die Idee, ein externes Web-Frontend (z. B. [[smartVISU]]) an fhem anzukoppeln und den Datenverkehr sowie die Zusammenarbeit von Befehlen und Parametern zwischen FHEM und dem Web-Frontend zu übernehmen.
Zeile 165:		Zeile 169:

	Wichtig zu berücksichtigen ist die Tatsache, dass die GAD-Liste erst dann aktualisiert wird, wenn einmal die entsprechende Frontend-Seite von einem frontendDevice aufgerufen wurde. Die korrekte Konfiguration des Treiber auf der Config-Seite für das frontendDevice (siehe Installation des Frontends) wird dabei vorausgesetzt. Die Liste wird also erst gefüllt, wenn erstmalig vom Frontend über einen Seitenaufruf die Verbindung zu FHEM initiiert wurde.		Wichtig zu berücksichtigen ist die Tatsache, dass die GAD-Liste erst dann aktualisiert wird, wenn einmal die entsprechende Frontend-Seite von einem frontendDevice aufgerufen wurde. Die korrekte Konfiguration des Treiber auf der Config-Seite für das frontendDevice (siehe Installation des Frontends) wird dabei vorausgesetzt. Die Liste wird also erst gefüllt, wenn erstmalig vom Frontend über einen Seitenaufruf die Verbindung zu FHEM initiiert wurde.

			Auf der anderen Seite weiß fronthem nicht, welche GADs in smartVISU verwendet werden. Jedes GAD das einmal sichtbar war, wird von fronthem gespeichert und aufgelistet, bis man es explizizt in fronthem löscht. ({{Link2Forum\|Topic= 43226\|Message=352115\|LinkText=Forum}})

	==== GAD Edit ====		==== GAD Edit ====
Zeile 252:		Zeile 258:
	Wie oben bereits beschrieben, kann dadurch genau festgelegt werden, welches Endgerät welche Rechte für eine jeweilige Schalt-/Anzeigefunktion hat.		Wie oben bereits beschrieben, kann dadurch genau festgelegt werden, welches Endgerät welche Rechte für eine jeweilige Schalt-/Anzeigefunktion hat.

	Wenn man die Berechtigungen für neue Endgeräte kopieren möchte, liegen diese unter ./fhem/www/fronthem/clients/<fronthemDevice> und lassen sich so einfach für neue Endgeräte übertragen.		Wenn man die Berechtigungen für neue Endgeräte kopieren möchte, liegen diese für jedes Endgerät unter ./fhem/www/fronthem/clients/<fronthemDevice> und lassen sich so einfach für neue Endgeräte übertragen.

	====IP-Identify====		====IP-Identify====
Zeile 273:		Zeile 279:

	==Troubleshooting==		==Troubleshooting==
	=== ~~generelles~~ Vorgehen ===		=== allgemeines Vorgehen ===

	Generelles Vorgehen bei seltsamen Erscheinungen:		Generelles Vorgehen bei seltsamen Erscheinungen:
Zeile 281:		Zeile 287:
	* Konsole im Browser öffnen und nach Errors schauen		* Konsole im Browser öffnen und nach Errors schauen
	* Verbose Level des FHEM-Device <code>fronthem</code> und <code>fronthemDevice</code> auf 5 setzen und im Log nach Errors schauen		* Verbose Level des FHEM-Device <code>fronthem</code> und <code>fronthemDevice</code> auf 5 setzen und im Log nach Errors schauen
	{{Link2Forum\|Topic= 30909\|Message=272083\|LinkText=Forum}}, {{Link2Forum\|Topic= 35960\|Message=285384\|LinkText=Forum}}		* Den Log des Webservers kontrollieren
			* Prüfen, ob der WebSocket läuft
			{{Link2Forum\|Topic= 30909\|Message=272083\|LinkText=Forum}}, {{Link2Forum\|Topic= 35960\|Message=285384\|LinkText=Forum}}, {{Link2Forum\|Topic= 52624\|Message=444004\|LinkText=Forum}}

			=== Verbindung ===

			Erhält an eine "no connection" Warnung in smartVISU sollte man folgendes kontrollieren:
			* Wurde auf der config-Seite von smartVISU auf dem Endgerät der Treiber auf "Fhem" gestellt?
			* Ist auf der config-Seite von smartVISU auf dem Endgerät die richtige Adresse des WebSocket Servers (meistens der Server mit der FHEM-Instanz) und der Port 2121 eingetragen?
			* Wurde für das fronthemDevice die richtige IP-Adresse definiert?
			* Steht "connected" im state des fronthemDevice ?
			{{Link2Forum\|Topic= 30909\|Message=236681\|LinkText=Forum}}

			Darüber hinaus wird Websocket erst ab Android 4.4 einwandfrei unterstützt {{Link2Forum\|Topic= 39587\|Message=318219\|LinkText=Forum}}.

			Ebenfalls das iPad 1G wird nicht mehr unterstützt {{Link2Forum\|Topic= 46737\|Message=384727\|LinkText=Forum}}.

			=== alternativer Treiber zum loggen auf der Konsole ===

			Falls mal ein Widget den Websocket Server zum Absturz bringt, was mittlerweile nicht mehr passieren sollte, wurde im {{Link2Forum\|Topic= 30909\|Message=273617\|LinkText=Forum}} ein Treiber veröffentlich, der das "überlebt" und auf der Konsole weiter loggt, welches Widget es verursacht hat.

			=== Logmeldungen ===

			Da die Module noch inoffiziell sind, hat sich ein wenig debug code ins git geschlichen.

			Folgende Zeile Code muss in den beiden Dateien aus kommentiert werden (# am Anfang der Zeile).

			Log3 ($hash, 1, "in $e");

			: Zeile 325 in 31_fronthemDevice.pm
			: Zeile 154 in 01_fronthem.pm

			{{Link2Forum\|Topic= 36407\|Message=287499\|LinkText=Forum}}

	=== keine Events ===		=== keine Events ===
Zeile 293:		Zeile 331:
	{{Link2Forum\|Topic= 30909\|Message=269984\|LinkText=Forum}}		{{Link2Forum\|Topic= 30909\|Message=269984\|LinkText=Forum}}

	=== ~~Verbindung~~ ===		Darüber hinaus ist bekannt, dass ein manuelles Editieren der fhem.cfg ebenfalls dazu führen kann, dass die Liste leer bleibt.
			{{Link2Forum\|Topic=43796\|Message=357097\|LinkText=Forum}}

			=== alte GADs löschen ===

			Hat man einmal aus versehen einen Demoraum ausgewählt und vergessen den Treiber auf Offline zu stellen, füllt sich der GAD-Editor mit allen GADs aus dem Demoraum. Um diese wieder zu löschen gibt es entweder den Weg über den GAD-Editor (gad-Editor -> gad anklicken -> delete) oder die Möglichkeit direkt die fhserver.fronthem.cfg zu editieren. {{Link2Forum\|Topic=47281\|Message=390051\|LinkText=Forum}}

	~~Erhält an eine "no connection" Warnung in smartVISU sollte man folgendes kontrollieren:~~		Die Datei befindet sich unter ./fhem/www/fronthem/server/<devicename>. {{Link2Forum\|Topic=46214\|Message=379959\|LinkText=Forum}}
	* Wurde auf der config-Seite von smartVISU auf dem Endgerät der Treiber auf "Fhem" gestellt?
	* Ist auf der config-Seite von smartVISU auf dem Endgerät die richtige Adresse des WebSocket Servers (meistens der Server mit der FHEM-Instanz) und der Port 2121 eingetragen?
	* Wurde für das fronthemDevice die richtige IP-Adresse definiert?
	* Steht "connected" im state des fronthemDevice ?
	{{Link2Forum\|Topic= ~~30909~~\|Message=~~236681~~\|LinkText=Forum}}

	=== VPN ===		=== VPN ===

	Beim Zugriff durch einen VPN-Tunnel muss sichergestellt sein, dass der VPN-Tunnel sowohl Zugriff auf Port 8083 (FHEMWEB~~) (Anmerkung: Ist das tatsächlich so?~~) als auch auf Port 2121 (fronthem) zulässt. Darüber hinaus wird einem per VPN angemeldeten Endgerät normalerweise eine andere interne IP-Adresse zugeordnet, als wenn das Endgerät sich im lokalen LAN befände. {{Link2Forum\|Topic= 30909\|Message=281398\|LinkText=Forum}}		Beim Zugriff durch einen VPN-Tunnel muss sichergestellt sein, dass der VPN-Tunnel sowohl Zugriff auf Port 8083 (FHEMWEB) als auch auf Port 2121 (fronthem) zulässt. Darüber hinaus wird einem per VPN angemeldeten Endgerät normalerweise eine andere interne IP-Adresse zugeordnet, als wenn das Endgerät sich im lokalen LAN befände. {{Link2Forum\|Topic= 30909\|Message=281398\|LinkText=Forum}}

	~~=== alternativer Treiber zum loggen~~ auf ~~der Konsole~~ ===		Für ein Script, dass variable fronthemDevices anlegt, sei auf diesen {{Link2Forum\|Topic= 50328\|Message=420580\|LinkText=Forumsbeitrag}} verwiesen.

	~~Falls mal ein Widget den Websocket Server zum Absturz bringt~~, ~~was mittlerweile nicht mehr passieren sollte~~, ~~wurde im~~ {{Link2Forum\|Topic= ~~30909~~\|Message=~~273617~~\|LinkText=~~Forum~~}} ~~ein Treiber veröffentlich, der das "überlebt" und auf der Konsole weiter loggt, welches Widget es verursacht hat~~.		Ein weiterer Artikel, der sich mit dem Thema befasst, ist dieser {{Link2Forum\|Topic= 50019\|Message=417592\|LinkText=Forumsbeitrag}}.

	== Links ==		== Links ==
	{{Link2Forum\|Topic= 27291\|Message=219207\|LinkText=Detaillierte Funktionsbeschreibung}} aus der Entwicklungszeit.		{{Link2Forum\|Topic= 27291\|Message=219207\|LinkText=Detaillierte Funktionsbeschreibung}} aus der Entwicklungszeit.

			{{Link2Forum\|Topic=30909\|Message=257681\|LinkText=Addon-Treiber}} um eine weitere Steuerung Daten in SV zu visualisieren .

	[[Kategorie: ~~FHEM Frontends~~]]		[[Kategorie:fronthem/smartVISU]]

Joshi04 am 22. Juni 2016 um 18:27 Uhr

2016-06-22T18:27:25Z

← Nächstältere Version		Version vom 22. Juni 2016, 20:27 Uhr
Zeile 9:		Zeile 9:
	}}		}}

	Dieser Artikel befasst sich mit den FHEM-Modulen und weiteren Dateien, die für die Integration von fronthem in FHEM notwendig ~~sein~~. Ein weiterer separater Artikel beschreibt die [[Installation Fronthem\|Installation von Fronthem]].		Dieser Artikel befasst sich mit den FHEM-Modulen und weiteren Dateien, die für die Integration von fronthem in FHEM notwendig sind. Ein weiterer separater Artikel beschreibt die [[Installation Fronthem\|Installation von Fronthem]].

	Fronthem verfolgt die Idee, ein externes Web-Frontend (z. B. [[smartVISU]]) an fhem anzukoppeln und den Datenverkehr sowie die Zusammenarbeit von Befehlen und Parametern zwischen FHEM und dem Web-Frontend zu übernehmen.		Fronthem verfolgt die Idee, ein externes Web-Frontend (z. B. [[smartVISU]]) an fhem anzukoppeln und den Datenverkehr sowie die Zusammenarbeit von Befehlen und Parametern zwischen FHEM und dem Web-Frontend zu übernehmen.

Joshi04: Gruundsätzliche Überarbeitung der Artikelserie fronthem/smartVISU

2016-06-22T18:26:12Z

Gruundsätzliche Überarbeitung der Artikelserie fronthem/smartVISU

Änderungen zeigen

← Nächstältere Version		Version vom 13. November 2017, 16:39 Uhr
Zeile 12:		Zeile 12:
	Das Modul [[fronthem]] bildet die Schnittstelle zwischen FHEM und einem smartVISU Frontend.		Das Modul [[fronthem]] bildet die Schnittstelle zwischen FHEM und einem smartVISU Frontend.

	Fronthem verfolgt die Idee, ein externes Web-Frontend (z. B. [[smartVISU]]) an ~~fhem~~ anzukoppeln und den Datenverkehr sowie die Zusammenarbeit von Befehlen und Parametern zwischen FHEM und dem Web-Frontend zu übernehmen. Eine Systemübersicht auf der [[smartVISU]] Seite stellt die Zusammenhänge dar.		Fronthem verfolgt die Idee, ein externes Web-Frontend (z. B. [[smartVISU]]) an FHEM anzukoppeln und den Datenverkehr sowie die Zusammenarbeit von Befehlen und Parametern zwischen FHEM und dem Web-Frontend zu übernehmen. Eine Systemübersicht auf der [[smartVISU]] Seite stellt die Zusammenhänge dar.

	Für die Installation eines passenden Web-Frontends (z.B. smartVISU), sowie dessen [[smartVISU Installation\|Installation]] gibt es jeweils eigenständige Artikel.		Für die Installation eines passenden Web-Frontends (z.B. smartVISU), sowie dessen [[smartVISU Installation\|Installation]] gibt es jeweils eigenständige Artikel.
Zeile 18:		Zeile 18:
	{{Todo\|Redaktionelle Überarbeitung der Detailbeschreibung für Readings Converter RGBCombined. Beschreibung der Converter ReadingsTimestamp, Attribute, Trigger.}}		{{Todo\|Redaktionelle Überarbeitung der Detailbeschreibung für Readings Converter RGBCombined. Beschreibung der Converter ReadingsTimestamp, Attribute, Trigger.}}

			==Bausteine==
	Die Integration von fronthem als Interface innerhalb von FHEM besteht aus vier Bausteinen:		Die Integration von fronthem als Interface innerhalb von FHEM besteht aus vier Bausteinen:

	~~==Bausteine==~~
	=== websocket ===		=== websocket ===
	Der Websocket ist eine generische http-Schnittstelle, die von einem externen Frontend aus angesprochen werden kann.		Der Websocket ist eine generische http-Schnittstelle, die von einem externen Frontend aus angesprochen werden kann.
Zeile 49:		Zeile 49:
	* [[#Direct\|Direct]] für Übertragung ohne Konvertierung		* [[#Direct\|Direct]] für Übertragung ohne Konvertierung
	* [[#NumDirect\|NumDirect]] für Übertragung von Zahlenwerten in einem begrenzten Werteraum zwischen Min und Max		* [[#NumDirect\|NumDirect]] für Übertragung von Zahlenwerten in einem begrenzten Werteraum zwischen Min und Max
	* [[#NumDisplay\|NumDisplay]] für Zahlenwerte aus ~~fhem~~ Readings, nur lesend		* [[#NumDisplay\|NumDisplay]] für Zahlenwerte aus FHEM Readings, nur lesend
	* [[#OnOff\|OnOff]] für Schalter, Übersetzung von On in 1 und Off in 0		* [[#OnOff\|OnOff]] für Schalter, Übersetzung von On in 1 und Off in 0
	* [[#RGBCombined\|RGBCombined]] für Übertragung von RGB-Werten so das sie FHEM akzeptiert		* [[#RGBCombined\|RGBCombined]] für Übertragung von RGB-Werten so das sie FHEM akzeptiert
Zeile 99:		Zeile 99:
	Dieser Converter dient zur Steuerung von RGB Leuchtmitteln über Farbauswahlfelder (z.B. Farbkreis). Eine Besonderheit ist hier, dass smartVISU die 3 RGB Werte separat verarbeitet, d.h., von FHEM wird ein RGB-Wert in HEX in 3 Werte, jeweils für R, G und B, aufgeteilt und an das Frontend übergeben. In umgekehrter Richtung wird die Auswahl einer Farbe im Frontend mit den 3 Werten für R, G und B an den Converter übergeben, kombiniert und an FHEM weitergegeben.		Dieser Converter dient zur Steuerung von RGB Leuchtmitteln über Farbauswahlfelder (z.B. Farbkreis). Eine Besonderheit ist hier, dass smartVISU die 3 RGB Werte separat verarbeitet, d.h., von FHEM wird ein RGB-Wert in HEX in 3 Werte, jeweils für R, G und B, aufgeteilt und an das Frontend übergeben. In umgekehrter Richtung wird die Auswahl einer Farbe im Frontend mit den 3 Werten für R, G und B an den Converter übergeben, kombiniert und an FHEM weitergegeben.

	Entsprechend arbeitet er bidirektional und wandelt 3 Frontend Items in ein FHEM-Objekt um. Damit die Kombination der Werte funktioniert, muss dieser Converter gleichlautend für alle 3 RGB Kanäle des Frontends definiert werden.		Entsprechend arbeitet er bidirektional und wandelt 3 Frontend Items in ein FHEM Objekt um. Damit die Kombination der Werte funktioniert, muss dieser Converter gleichlautend für alle 3 RGB Kanäle des Frontends definiert werden.

	reading: Name eines reading mit HEX RGB Wert des Leuchtmittels		reading: Name eines reading mit HEX RGB Wert des Leuchtmittels
Zeile 147:		Zeile 147:

	==== GAD Liste ====		==== GAD Liste ====
	Auf der Detailseite werden im oberen Teil die GADs aufgelistet, die von smartVisu "angefragt" wurden. In vier Spalten werden von links der GAD-Name (wie auf der smartVISU-Seite definiert), das damit verbundene FHEM-Device, für das frontemDevice gesetzte Lese-Rechte und Schreib-Rechte angezeigt. Im oberen Teil des Fensters lässt sich eine Zeichenkette eingeben, nach der die Liste gefiltert wird (zumindest in Dark-Style hat die Schrift der eingegebenen Zeichenkette die gleiche Farbe wie der Hintergrund).		Auf der Detailseite werden im oberen Teil die GADs aufgelistet, die von smartVisu "angefragt" wurden. In vier Spalten werden von links der GAD-Name (wie auf der smartVISU-Seite definiert), das damit verbundene FHEM Device, für das frontemDevice gesetzte Lese-Rechte und Schreib-Rechte angezeigt. Im oberen Teil des Fensters lässt sich eine Zeichenkette eingeben, nach der die Liste gefiltert wird (zumindest in Dark-Style hat die Schrift der eingegebenen Zeichenkette die gleiche Farbe wie der Hintergrund).

	Die Verknüpfung zwischen GAD und FHEM-Device gilt global und muss nur einmal für ein beliebiges fronthemDevice eingerichtet werden. Lese- und Schreibrechte können pro fronthemDevice konfiguriert werden.		Die Verknüpfung zwischen GAD und FHEM Device gilt global und muss nur einmal für ein beliebiges fronthemDevice eingerichtet werden. Lese- und Schreibrechte können pro fronthemDevice konfiguriert werden.

	Wichtig zu berücksichtigen ist die Tatsache, dass die GAD-Liste erst dann aktualisiert wird, wenn einmal die entsprechende Frontend-Seite von einem frontendDevice aufgerufen wurde. Die korrekte Konfiguration des Treibers auf der Config-Seite für das frontendDevice (siehe Installation des Frontends) wird dabei vorausgesetzt. Die Liste wird also erst gefüllt, wenn erstmalig vom Frontend über einen Seitenaufruf die Verbindung zu FHEM initiiert wurde.		Wichtig zu berücksichtigen ist die Tatsache, dass die GAD-Liste erst dann aktualisiert wird, wenn einmal die entsprechende Frontend-Seite von einem frontendDevice aufgerufen wurde. Die korrekte Konfiguration des Treibers auf der Config-Seite für das frontendDevice (siehe Installation des Frontends) wird dabei vorausgesetzt. Die Liste wird also erst gefüllt, wenn erstmalig vom Frontend über einen Seitenaufruf die Verbindung zu FHEM initiiert wurde.
Zeile 175:		Zeile 175:

	===== device =====		===== device =====
	Hier wird der Name des FHEM Devices eingetragen, an das die Befehle geschickt werden, bzw. dessen Readings angezeigt werden sollen. Die vorhandenen Devices in ~~fhem~~ werden als Liste unter dem Eingabefeld angezeigt, sobald man mit der Eingabe beginnt.		Hier wird der Name des FHEM Devices eingetragen, an das die Befehle geschickt werden, bzw. dessen Readings angezeigt werden sollen. Die vorhandenen Devices in FHEM werden als Liste unter dem Eingabefeld angezeigt, sobald man mit der Eingabe beginnt.

	Wie überall innerhalb von FHEM ist die Groß-/Kleinschreibung zu beachten.		Wie überall innerhalb von FHEM ist die Groß-/Kleinschreibung zu beachten.
Zeile 231:		Zeile 231:
	Für jedes Endgerät (smartphone, PC, Tablet, etc.), mit dem man auf das Frontend zugreifen möchte, muss ein entsprechendes fronthemDevice definiert werden. Wie bereits beschrieben, kann dadurch genau festgelegt werden, welches Endgerät welche Rechte für eine jeweilige Schalt-/Anzeigefunktion hat.		Für jedes Endgerät (smartphone, PC, Tablet, etc.), mit dem man auf das Frontend zugreifen möchte, muss ein entsprechendes fronthemDevice definiert werden. Wie bereits beschrieben, kann dadurch genau festgelegt werden, welches Endgerät welche Rechte für eine jeweilige Schalt-/Anzeigefunktion hat.

	Wenn man die Berechtigungen für neue Endgeräte kopieren möchte, liegen diese für jedes Endgerät unter ./fhem/www/fronthem/clients/<fronthemDevice> und lassen sich so einfach für neue Endgeräte übertragen.		Wenn man die Berechtigungen für neue Endgeräte kopieren möchte, liegen diese für jedes Endgerät unter <code>./fhem/www/fronthem/clients/<fronthemDevice></code> und lassen sich so einfach für neue Endgeräte übertragen.

	====IP-Identify====		====IP-Identify====
Zeile 257:		Zeile 257:
	* Konsole im Browser öffnen und nach Fehlermeldungen schauen		* Konsole im Browser öffnen und nach Fehlermeldungen schauen
	* In der Datei fronthem.err im Verzeichnis /opt/fhem nach Fehlermeldungen schauen {{Link2Forum\|Topic=36858\|Message=291272\|LinkText=(Forum)}}		* In der Datei fronthem.err im Verzeichnis /opt/fhem nach Fehlermeldungen schauen {{Link2Forum\|Topic=36858\|Message=291272\|LinkText=(Forum)}}
	* Verbose Level des FHEM-Device <code>fronthem</code> und <code>fronthemDevice</code> auf 5 setzen und im Log nach Errors schauen		* Verbose Level des FHEM Device <code>fronthem</code> und <code>fronthemDevice</code> auf 5 setzen und im Log nach Errors schauen
	* Den Log des Webservers kontrollieren		* Den Log des Webservers kontrollieren
	* Prüfen, ob der WebSocket läuft ({{Link2Forum\|Topic= 30909\|Message=272083\|LinkText=(Forum)}}, {{Link2Forum\|Topic= 35960\|Message=285384\|LinkText=(Forum)}}, {{Link2Forum\|Topic=52624\|Message=444004\|LinkText=Forum)}})		* Prüfen, ob der WebSocket läuft ({{Link2Forum\|Topic= 30909\|Message=272083\|LinkText=(Forum)}}, {{Link2Forum\|Topic= 35960\|Message=285384\|LinkText=(Forum)}}, {{Link2Forum\|Topic=52624\|Message=444004\|LinkText=Forum)}})
Zeile 264:		Zeile 264:
	Erhält man eine "no connection" Warnung in smartVISU sollte man folgendes kontrollieren:		Erhält man eine "no connection" Warnung in smartVISU sollte man folgendes kontrollieren:
	* Wurde auf der config-Seite von smartVISU auf dem Endgerät der Treiber auf "Fhem" gestellt?		* Wurde auf der config-Seite von smartVISU auf dem Endgerät der Treiber auf "Fhem" gestellt?
	* Ist auf der config-Seite von smartVISU auf dem Endgerät die richtige Adresse des WebSocket Servers (meistens der Server mit der FHEM-Instanz) und der Port 2121 eingetragen?		* Ist auf der config-Seite von smartVISU auf dem Endgerät die richtige Adresse des WebSocket Servers (meistens der Server mit der FHEM Instanz) und der Port 2121 eingetragen?
	* Wurde für das fronthemDevice die richtige IP-Adresse definiert?		* Wurde für das fronthemDevice die richtige IP-Adresse definiert?
	* Steht "connected" im state des fronthemDevice {{Link2Forum\|Topic= 30909\|Message=236681\|LinkText=(Forum)}}?		* Steht "connected" im state des fronthemDevice {{Link2Forum\|Topic= 30909\|Message=236681\|LinkText=(Forum)}}?
Zeile 314:		Zeile 314:

	==== Konfigurationsdateien ====		==== Konfigurationsdateien ====
	Speicherort für Verbindung zwischen GADs und FHEM-Devices:		Speicherort für Verbindung zwischen GADs und FHEM Devices:
	:<code>/opt/fhem/www/fronthem/server/fronthem/fhservr.<device>.cfg</code>		:<code>/opt/fhem/www/fronthem/server/fronthem/fhservr.<device>.cfg</code>