mirror of
https://github.com/fhem/fhem-mirror.git
synced 2025-03-05 18:16:44 +00:00
FHEMWEB: german doc.
git-svn-id: https://svn.fhem.de/fhem/trunk@4873 2b470e98-0d58-463d-a4d8-8e2adae1ed80
This commit is contained in:
rudolfkoenig
parent
d01d3a898b
commit
494e4a3d09
@ -2384,9 +2384,8 @@ FW_ActivateInform()
|
|||||||
<a name="FHEMWEB"></a>
|
<a name="FHEMWEB"></a>
|
||||||
<h3>FHEMWEB</h3>
|
<h3>FHEMWEB</h3>
|
||||||
<ul>
|
<ul>
|
||||||
FHEMWEB is the builtin web-frontend (webpgm2). It implements a simple web
|
FHEMWEB is the builtin web-frontend, it also implements a simple web
|
||||||
server (optionally with Basic-Auth and HTTPS), so no additional program is
|
server (optionally with Basic-Auth and HTTPS).
|
||||||
needed.
|
|
||||||
<br> <br>
|
<br> <br>
|
||||||
|
|
||||||
<a name="FHEMWEBdefine"></a>
|
<a name="FHEMWEBdefine"></a>
|
||||||
@ -2398,10 +2397,7 @@ FW_ActivateInform()
|
|||||||
then requests from all interfaces (not only localhost / 127.0.0.1) are
|
then requests from all interfaces (not only localhost / 127.0.0.1) are
|
||||||
serviced.<br>
|
serviced.<br>
|
||||||
To enable listening on IPV6 see the comments <a href="#telnet">here</a>.
|
To enable listening on IPV6 see the comments <a href="#telnet">here</a>.
|
||||||
<br><br>
|
<br>
|
||||||
Feature: http://host:port/fhem/icons/<devicename> will return
|
|
||||||
the icon associated with the current status of <devicename>.
|
|
||||||
|
|
||||||
</ul>
|
</ul>
|
||||||
<br>
|
<br>
|
||||||
|
|
||||||
@ -2409,11 +2405,11 @@ FW_ActivateInform()
|
|||||||
<b>Set</b>
|
<b>Set</b>
|
||||||
<ul>
|
<ul>
|
||||||
<li>rereadicons<br>
|
<li>rereadicons<br>
|
||||||
Rereads the icons in the icon path and updates the mapping from logical
|
reads the names of the icons from the icon path. Use after adding or
|
||||||
icons to physical files. Use after adding, deleting or changing icons.
|
deleting icons.
|
||||||
</li>
|
</li>
|
||||||
<li>clearSvgCache<br>
|
<li>clearSvgCache<br>
|
||||||
Delete all files found in the www/SVGcache directory, which is used to
|
delete all files found in the www/SVGcache directory, which is used to
|
||||||
cache SVG data, if the SVGcache attribute is set.
|
cache SVG data, if the SVGcache attribute is set.
|
||||||
</li>
|
</li>
|
||||||
</ul>
|
</ul>
|
||||||
@ -2457,30 +2453,18 @@ FW_ActivateInform()
|
|||||||
<li>plotmode<br>
|
<li>plotmode<br>
|
||||||
Specifies how to generate the plots:
|
Specifies how to generate the plots:
|
||||||
<ul>
|
<ul>
|
||||||
<li>gnuplot<br>
|
|
||||||
Call the gnuplot script with each logfile. The filename
|
|
||||||
specification of the <a href="#FileLog">FileLog</a> device will
|
|
||||||
determine what is in the plot. The data is converted into an
|
|
||||||
image on the backend with gnuplot.</li>
|
|
||||||
<li>gnuplot-scroll<br>
|
|
||||||
Fhemweb will offer zoom and scroll buttons in order to navigate
|
|
||||||
in the current logfile, i.e. you can select just a part of the
|
|
||||||
data to be displayed. The more data is contained in a single
|
|
||||||
logfile, the easier you can navigate. The recommendation is to
|
|
||||||
store the data for a whole year in one logfile. The data is
|
|
||||||
converted into an image on the backend with gnuplot.</li>
|
|
||||||
<li>SVG<br>
|
<li>SVG<br>
|
||||||
The same scrolling as with gnuplot scroll, but the data is sent
|
The plots are created with the <a href="#SVG">SVG</a> module.
|
||||||
as an SVG script to the frontend, which will compute
|
This is the default.</li>
|
||||||
the image: no need for gnuplot on the backend.
|
|
||||||
This is the default. Note: SVG is supported on the Android
|
<li>gnuplot<br>
|
||||||
platform by Opera/Firefox and the Internet Explorer before 9
|
The plots are created with the gnuplot program. Note: this mode
|
||||||
needs a plugin.
|
ist only available due to historic reasons.</li>
|
||||||
</li>
|
|
||||||
|
<li>gnuplot-scroll<br>
|
||||||
|
Like the gnuplot-mode, but scrolling to historical values is alos
|
||||||
|
possible, just like with SVG.</li>
|
||||||
</ul>
|
</ul>
|
||||||
See also the attribute fixedrange.
|
|
||||||
Note: for gnuplot & gnuplot-scroll mode the gnuplot output is
|
|
||||||
redirected to the file gnuplot.err in the /tmp directory
|
|
||||||
</li><br>
|
</li><br>
|
||||||
|
|
||||||
<a name="plotsize"></a>
|
<a name="plotsize"></a>
|
||||||
@ -2493,10 +2477,11 @@ FW_ActivateInform()
|
|||||||
|
|
||||||
<a name="nrAxis"></a>
|
<a name="nrAxis"></a>
|
||||||
<li>nrAxis<br>
|
<li>nrAxis<br>
|
||||||
the number of axis for which space should be reserved on the left and right sides of a plot
|
the number of axis for which space should be reserved on the left and
|
||||||
and optionaly how many axes should realy be used on each side, separated by comma:
|
right sides of a plot and optionaly how many axes should realy be used
|
||||||
left,right[,useLeft,useRight]. You can set individual numbers by setting the nrAxis of
|
on each side, separated by comma: left,right[,useLeft,useRight]. You
|
||||||
the SVG. Default is 1,1.
|
can set individual numbers by setting the nrAxis of the SVG. Default is
|
||||||
|
1,1.
|
||||||
</li><br>
|
</li><br>
|
||||||
|
|
||||||
<a name="SVGcache"></a>
|
<a name="SVGcache"></a>
|
||||||
@ -2724,7 +2709,7 @@ FW_ActivateInform()
|
|||||||
Set the icon for a device in the room overview. There is an
|
Set the icon for a device in the room overview. There is an
|
||||||
icon-chooser in FHEMWEB to ease this task. Setting icons for the room
|
icon-chooser in FHEMWEB to ease this task. Setting icons for the room
|
||||||
itself is indirect: there must exist an icon with the name
|
itself is indirect: there must exist an icon with the name
|
||||||
ico<ROOMNAME>.png in the modpath directory.
|
ico<ROOMNAME>.png in the iconPath.
|
||||||
</li>
|
</li>
|
||||||
<br>
|
<br>
|
||||||
|
|
||||||
@ -2736,7 +2721,7 @@ FW_ActivateInform()
|
|||||||
Everything, or to set one for rooms with / in the name (e.g.
|
Everything, or to set one for rooms with / in the name (e.g.
|
||||||
Anlagen/EDV). The first part is treated as regexp, so space is
|
Anlagen/EDV). The first part is treated as regexp, so space is
|
||||||
represented by a dot. Example:<br>
|
represented by a dot. Example:<br>
|
||||||
attr WEB roomIcons Everything: Anlagen.EDV:icoEverything
|
attr WEB roomIcons Anlagen.EDV:icoEverything
|
||||||
</li>
|
</li>
|
||||||
<br>
|
<br>
|
||||||
|
|
||||||
@ -2859,7 +2844,484 @@ FW_ActivateInform()
|
|||||||
</ul>
|
</ul>
|
||||||
</ul>
|
</ul>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
=end html
|
=end html
|
||||||
|
|
||||||
|
=begin html_DE
|
||||||
|
|
||||||
|
<a name="FHEMWEB"></a>
|
||||||
|
<h3>FHEMWEB</h3>
|
||||||
|
<ul>
|
||||||
|
FHEMWEB ist das default WEB-Frontend, es implementiert auch einen einfachen
|
||||||
|
Webserver (optional mit Basic-Auth und HTTPS).
|
||||||
|
<br> <br>
|
||||||
|
|
||||||
|
<a name="FHEMWEBdefine"></a>
|
||||||
|
<b>Define</b>
|
||||||
|
<ul>
|
||||||
|
<code>define <name> FHEMWEB <tcp-portnr> [global]</code>
|
||||||
|
<br><br>
|
||||||
|
Aktiviert das Webfrontend auf dem Port <tcp-portnr>. Mit dem
|
||||||
|
Parameter global werden Anfragen von allen Netzwerkschnittstellen
|
||||||
|
akzeptiert (nicht nur vom localhost / 127.0.0.1) . <br>
|
||||||
|
|
||||||
|
Informationen für den Betrieb mit IPv6 finden Sie <a
|
||||||
|
href="#telnet">hier</a>.<br>
|
||||||
|
</ul>
|
||||||
|
<br>
|
||||||
|
|
||||||
|
<a name="FHEMWEBset"></a>
|
||||||
|
<b>Set</b>
|
||||||
|
<ul>
|
||||||
|
<li>rereadicons<br>
|
||||||
|
Damit wird die Liste der Icons neu eingelesen, für den Fall, dass
|
||||||
|
Sie Icons löschen oder hinzufügen.
|
||||||
|
</li>
|
||||||
|
<li>clearSvgCache<br>
|
||||||
|
Im Verzeichnis www/SVGcache werden SVG Daten zwischengespeichert, wenn
|
||||||
|
das Attribut SVGcache gesetzt ist. Mit diesem Befehl leeren Sie diesen
|
||||||
|
Zwischenspeicher.
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
<br>
|
||||||
|
|
||||||
|
<a name="FHEMWEBget"></a>
|
||||||
|
<b>Get</b>
|
||||||
|
<ul>
|
||||||
|
<li>icon <logical icon><br>
|
||||||
|
Liefert den absoluten Pfad des (logischen) Icons zurück. Beispiel:
|
||||||
|
<ul>
|
||||||
|
<code>get myFHEMWEB icon FS20.on<br>
|
||||||
|
/data/Homeautomation/fhem/FHEM/FS20.on.png
|
||||||
|
</code>
|
||||||
|
</ul></li>
|
||||||
|
<li>pathlist<br>
|
||||||
|
Zeigt diejenigen Verzeichnisse an, in welchen die verschiedenen Dateien
|
||||||
|
für FHEMWEB liegen.
|
||||||
|
</li>
|
||||||
|
<br><br>
|
||||||
|
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<a name="FHEMWEBattr"></a>
|
||||||
|
<b>Attributes</b>
|
||||||
|
<ul>
|
||||||
|
<a name="webname"></a>
|
||||||
|
<li>webname<br>
|
||||||
|
Der Pfad nach http://hostname:port/ . Standard ist fhem,
|
||||||
|
so ist die Standard HTTP Adresse http://localhost:8083/fhem
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="refresh"></a>
|
||||||
|
<li>refresh<br>
|
||||||
|
Damit erzeugen Sie auf den ausgegebenen Webseiten einen automatischen
|
||||||
|
Refresh, z.B. nach 5 Sekunden.
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="plotmode"></a>
|
||||||
|
<li>plotmode<br>
|
||||||
|
Spezifiziert, wie Plots erzeugt werden sollen:
|
||||||
|
<ul>
|
||||||
|
<li>SVG<br>
|
||||||
|
Die Plots werden mit Hilfe des <a href="#SVG">SVG</a> Moduls als SVG
|
||||||
|
Grafik gerendert. Das ist die Standardeinstellung.</li>
|
||||||
|
|
||||||
|
<li>gnuplot<br>
|
||||||
|
Die Plots werden mit Hilfe des gnuplot Programmes erzeugt. Diese
|
||||||
|
Option ist aus historischen Gründen vorhanden.
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>gnuplot-scroll<br>
|
||||||
|
Wie gnuplot, der einfache Zugriff auf historische Daten ist aber
|
||||||
|
genauso möglich wie mit dem SVG Modul.</li>
|
||||||
|
|
||||||
|
</ul>
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="plotsize"></a>
|
||||||
|
<li>plotsize<br>
|
||||||
|
gibt die Standardbildgröße aller erzeugten Plots an als
|
||||||
|
Breite,Höhe an. Um einem individuellen Plot die Größe zu
|
||||||
|
ändern muss dieses Attribut bei der entsprechenden SVG Instanz
|
||||||
|
gesetzt werden. Default sind 800,160 für Desktop und 480,160
|
||||||
|
für Smallscreen
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="nrAxis"></a>
|
||||||
|
<li>nrAxis<br>
|
||||||
|
(bei mehrfach-Y-Achsen im SVG-Plot) Die Darstellung der Y Achsen
|
||||||
|
benötigt Platz. Hierdurch geben Sie an wie viele Achsen Sie
|
||||||
|
links,rechts [useLeft,useRight] benötigen. Default ist 1,1 (also 1
|
||||||
|
Achse links, 1 Achse rechts).
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="SVGcache"></a>
|
||||||
|
<li>SVGcache<br>
|
||||||
|
Plots die sich nicht mehr ändern, werden im SVGCache Verzeichnis
|
||||||
|
(www/SVGcache) gespeichert, um die erneute, rechenintensive
|
||||||
|
Berechnung der Grafiken zu vermeiden. Default ist 0, d.h. aus.<br>
|
||||||
|
Siehe den clearSvgCache Befehl um diese Daten zu löschen.
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="endPlotToday"></a>
|
||||||
|
<li>endPlotToday<br>
|
||||||
|
Wird dieses FHEMWEB Attribut gesetzt, so enden Wochen- bzw. Monatsplots
|
||||||
|
am aktuellen Tag, sonst wird die aktuelle Woche/Monat angezeigt.
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="endPlotNow"></a>
|
||||||
|
<li>endPlotNow<br>
|
||||||
|
Wenn Sie dieses FHEMWEB Attribut auf 1 setzen, werden Tages und
|
||||||
|
Stunden-Plots zur aktuellen Zeit beendet. (Ähnlich wie
|
||||||
|
endPlotToday, nur eben minütlich).
|
||||||
|
Ansonsten wird der gesamte Tag oder eine 6 Stunden Periode (0, 6, 12,
|
||||||
|
18 Stunde) gezeigt. Dieses Attribut wird nicht verwendet, wenn das SVG
|
||||||
|
Attribut startDate benutzt wird.<br>
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="plotfork"></a>
|
||||||
|
<li>plotfork<br>
|
||||||
|
Normalerweise wird die Ploterstellung im Hauptprozess ausgeführt,
|
||||||
|
FHEM wird wärend dieser Zeit nicht auf andere Ereignisse
|
||||||
|
reagieren. Auf Rechnern mit sehr wenig Speicher (z.Bsp. FRITZ!Box 7170)
|
||||||
|
kann das zum automatischen Abschuss des FHEM Prozesses durch das OS
|
||||||
|
führen.
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="basicAuth"></a>
|
||||||
|
<li>basicAuth, basicAuthMsg<br>
|
||||||
|
Fragt username/password zur Autentifizierung ab. Es gibt mehrere
|
||||||
|
Varianten:
|
||||||
|
<ul>
|
||||||
|
<li>falls das Argument <b>nicht</b> in {} eingeschlossen ist, dann wird
|
||||||
|
es als base64 kodiertes benutzername:passwort interpretiert.
|
||||||
|
Um sowas zu erzeugen kann man entweder einen der zahlreichen
|
||||||
|
Webdienste verwenden, oder das base64 Programm. Beispiel:
|
||||||
|
<ul><code>
|
||||||
|
$ echo -n fhemuser:secret | base64<br>
|
||||||
|
ZmhlbXVzZXI6c2VjcmV0<br>
|
||||||
|
fhem.cfg:<br>
|
||||||
|
attr WEB basicAuth ZmhlbXVzZXI6c2VjcmV0
|
||||||
|
</code></ul>
|
||||||
|
</li>
|
||||||
|
<li>Werden die Argumente in {} angegeben, wird es als perl-Ausdruck
|
||||||
|
ausgewertet, die Variablen $user and $password werden auf die
|
||||||
|
eingegebenen Werte gesetzt. Falls der Rückgabewert wahr ist,
|
||||||
|
wird die Anmeldung akzeptiert.
|
||||||
|
|
||||||
|
Beispiel:<br>
|
||||||
|
<code>
|
||||||
|
attr WEB basicAuth { "$user:$password" eq "admin:secret" }<br>
|
||||||
|
</code>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="HTTPS"></a>
|
||||||
|
<li>HTTPS<br>
|
||||||
|
Ermöglicht HTTPS Verbindungen. Es werden die Perl Module
|
||||||
|
IO::Socket::SSL benötigt, installierbar mit cpan -i
|
||||||
|
IO::Socket::SSL oder apt-get install libio-socket-ssl-perl; (OSX und
|
||||||
|
die FritzBox-7390 haben dieses Modul schon installiert.)<br>
|
||||||
|
|
||||||
|
Ein lokales Zertifikat muss im Verzeichis certs erzeugt werden.
|
||||||
|
Dieses Verzeichnis <b>muss</b> im <a href="#modpath">modpath</a>
|
||||||
|
angegeben werden, also auf der gleichen Ebene wie das FHEM Verzeichnis.
|
||||||
|
Beispiel:
|
||||||
|
<ul>
|
||||||
|
mkdir certs<br>
|
||||||
|
cd certs<br>
|
||||||
|
openssl req -new -x509 -nodes -out server-cert.pem -days 3650 -keyout server-key.pem
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<br>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<a name="allowedCommands"></a>
|
||||||
|
<li>allowedCommands<br>
|
||||||
|
Eine Komma getrennte Liste der erlaubten Befehle. Bei einer leeren
|
||||||
|
Liste (, dh. nur ein Komma) wird dieser FHEMWEB-Instanz "read-only".
|
||||||
|
<br> Falls es auf <code>get,set</code> gesetzt ist, dann sind in dieser
|
||||||
|
FHEMWEB Instanz keine Konfigurationsänderungen möglich, nur
|
||||||
|
"normale" Bedienung der Schalter/etc.<br>
|
||||||
|
|
||||||
|
Dieses Attribut sollte zusammen mit dem hiddenroom/hiddengroup
|
||||||
|
Attributen verwendet werden. <br>
|
||||||
|
|
||||||
|
<b>Achtung:</b> allowedCommands sollte wie hier beschrieben
|
||||||
|
funktionieren, allerdings können wir keine Garantie geben,
|
||||||
|
daß man sie nicht überlisten, und Schaden anrichten kann.
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<li><a href="#allowfrom">allowfrom</a>
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="stylesheetPrefix"></a>
|
||||||
|
<li>stylesheetPrefix<br>
|
||||||
|
Präfix für die Dateien style.css, svg_style.css und
|
||||||
|
svg_defs.svg. Wenn die Datei mit dem Präfix fehlt, wird die Default
|
||||||
|
Datei (ohne Präfix) verwendet. Diese Dateien müssen im FHEM
|
||||||
|
Ordner liegen und können direkt mit "Select style" im FHEMWEB
|
||||||
|
Menüeintrag ausgewählt werden. Beispiel:
|
||||||
|
<ul>
|
||||||
|
attr WEB stylesheetPrefix dark<br>
|
||||||
|
<br>
|
||||||
|
Referenzdateien:<br>
|
||||||
|
<ul>
|
||||||
|
darksvg_defs.svg<br>
|
||||||
|
darksvg_style.css<br>
|
||||||
|
darkstyle.css<br>
|
||||||
|
</ul>
|
||||||
|
<br>
|
||||||
|
</ul>
|
||||||
|
<b>Anmerkung:</b>Wenn der Parametername smallscreen oder touchpad
|
||||||
|
enthält, wird FHEMWEB das Layout/den Zugriff für entsprechende
|
||||||
|
Geräte (Smartphones oder Touchpads) optimieren<br>
|
||||||
|
|
||||||
|
Standardmäßig werden 3 FHEMWEB Instanzen aktiviert: Port 8083
|
||||||
|
für Desktop Browser, Port 8084 für Smallscreen, und 8085
|
||||||
|
für Touchpad.<br>
|
||||||
|
|
||||||
|
Wenn touchpad oder smallscreen benutzt werden, wird WebApp support
|
||||||
|
aktiviert: Nachdem Sie eine Seite am iPhone oder iPad mit Safari
|
||||||
|
angesehen haben, können Sie einen Link auf den Homescreen anlegen um
|
||||||
|
die Seite im Fullscreen Modus zu sehen. Links werden in diesem Modus
|
||||||
|
anders gerendert, um ein "Zurückfallen" in den "normalen" Browser zu
|
||||||
|
verhindern.
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="iconPath"></a>
|
||||||
|
<li>iconPath<br>
|
||||||
|
Durch Doppelpunkt getrennte Aufzählung der Verzeichnisse, in
|
||||||
|
welchen nach Icons gesucht wird. Die Verzeichnisse müssen unter
|
||||||
|
fhem/www/images angelegt sein. Standardeinstellung ist:
|
||||||
|
$styleSheetPrefix:default:fhemSVG:openautomation<br>
|
||||||
|
Setzen Sie den Wert auf fhemSVG:openautomation um nur SVG Bilder zu
|
||||||
|
benutzen.
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="hiddenroom"></a>
|
||||||
|
<li>hiddenroom<br>
|
||||||
|
Eine Komma getrennte Liste, um Räume zu verstecken, d.h. nicht
|
||||||
|
anzuzeigen. Besondere Werte sind input, detail und save. In diesem
|
||||||
|
Fall werden diverse Eingabefelder ausgeblendent. Durch direktes Aufrufen
|
||||||
|
der URL sind diese Räume weiterhin erreichbar!<br>
|
||||||
|
Ebenso können Einträge in den Logfile/Commandref/etc Block
|
||||||
|
versteckt werden. </li><br>
|
||||||
|
|
||||||
|
<a name="hiddengroup"></a>
|
||||||
|
<li>hiddengroup<br>
|
||||||
|
Wie hiddenroom (siehe oben), jedoch auf Gerätegruppen bezogen.
|
||||||
|
<br>
|
||||||
|
Beispiel: attr WEBtablet hiddengroup FileLog,dummy,at,notify
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="menuEntries"></a>
|
||||||
|
<li>menuEntries<br>
|
||||||
|
Komma getrennte Liste; diese Links werden im linken Menü angezeigt.
|
||||||
|
Beispiel:<br>
|
||||||
|
attr WEB menuEntries fhem.de,http://fhem.de,culfw.de,http://culfw.de<br>
|
||||||
|
attr WEB menuEntries AlarmOn,http://fhemhost:8083/fhem?cmd=set%20alarm%20on<br>
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="longpoll"></a>
|
||||||
|
<li>longpoll<br>
|
||||||
|
Dies betrifft die Aktualisierung der Gerätestati in der
|
||||||
|
Weboberfläche. Ist longpoll aktiviert, werden
|
||||||
|
Statusänderungen sofort im Browser dargestellt. ohne die Seite
|
||||||
|
manuell neu laden zu müssen. Standard ist aktiviert.
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
|
||||||
|
<a name="longpollSVG"></a>
|
||||||
|
<li>longpollSVG<br>
|
||||||
|
Lädt SVG Instanzen erneut, falls ein Ereignis dessen Inhalt
|
||||||
|
ändert. Funktioniert nur, falls der dazugehörige #FileLog
|
||||||
|
Definition in der .gplot Datei folgenden Form hat: deviceName.Event
|
||||||
|
bzw. deviceName.*. Wenn man den <a href="#weblinkEditor">Plot
|
||||||
|
Editor</a> benutzt, ist das übrigens immer der Fall. Die SVG Datei
|
||||||
|
wird bei <b>jedem</b> auslösenden Event dieses Gerätes neu
|
||||||
|
geladen. Standard ist aus.
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="redirectCmds"></a>
|
||||||
|
<li>redirectCmds<br>
|
||||||
|
Damit wird das URL Eingabefeld des Browser nach einem Befehl geleert.
|
||||||
|
Standard ist eingeschaltet (1), ausschalten kann man es durch
|
||||||
|
setzen des Attributs auf 0, z.Bsp. um den Syntax der Kommunikation mit
|
||||||
|
FHEMWEB zu untersuchen.
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="fwcompress"></a>
|
||||||
|
<li>fwcompress<br>
|
||||||
|
Aktiviert die HTML Datenkompression (Standard ist 1, also ja, 0 stellt
|
||||||
|
die Kompression aus).
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="reverseLogs"></a>
|
||||||
|
<li>reverseLogs<br>
|
||||||
|
Damit wird das Logfile umsortiert, die neuesten Einträge stehen
|
||||||
|
oben. Der Vorteil ist, dass man nicht runterscrollen muss um den
|
||||||
|
neuesten Eintrag zu sehen, der Nachteil dass FHEM damit deutlich mehr
|
||||||
|
Hauptspeicher benötigt, etwa 6 mal so viel, wie das Logfile auf
|
||||||
|
dem Datenträger groß ist. Das kann auf Systemen mit wenig
|
||||||
|
Speicher (FRITZ!Box) zum Terminieren des FHEM Prozesses durch das
|
||||||
|
Betriebssystem führen.
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="CORS"></a>
|
||||||
|
<li>CORS<br>
|
||||||
|
Wenn auf 1 gestellt, wird FHEMWEB einen "Cross origin resource sharing"
|
||||||
|
Header bereitstellen, näheres siehe Wikipedia.
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="icon"></a>
|
||||||
|
<li>icon<br>
|
||||||
|
Damit definiert man ein Icon für die einzelnen Geräte in der
|
||||||
|
Raumübersicht. Es gibt einen passenden Link in der Detailansicht
|
||||||
|
um das zu vereinfachen. Um ein Bild für die Räume selbst zu
|
||||||
|
definieren muss ein Icon mit dem Namen ico<Raumname>.png im
|
||||||
|
iconPath existieren (oder man verwendet roomIcons, s.u.)
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="roomIcons"></a>
|
||||||
|
<li>roomIcons<br>
|
||||||
|
Leerzeichen getrennte Liste von room:icon Zuordnungen
|
||||||
|
Der erste Teil wird als regexp interpretiert, daher muss ein
|
||||||
|
Leerzeichen als Punkt geschrieben werden. Beispiel:<br>
|
||||||
|
attr WEB roomIcons Anlagen.EDV:icoEverything
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="sortRooms"></a>
|
||||||
|
<li>sortRooms<br>
|
||||||
|
Durch Leerzeichen getrennte Liste von Räumen, um deren Reihenfolge
|
||||||
|
zu definieren. Beispiel:<br>
|
||||||
|
attr WEB sortRooms DG OG EG Keller
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="sortby"></a>
|
||||||
|
<li>sortby<br>
|
||||||
|
Der Wert dieses Attributs wird zum sortieren von Geräten in
|
||||||
|
Räumen verwendet, sonst wäre es der Alias oder, wenn keiner
|
||||||
|
da ist, der Gerätename selbst.
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="devStateIcon"></a>
|
||||||
|
<li>devStateIcon<br>
|
||||||
|
Erste Variante:<br>
|
||||||
|
<ul>
|
||||||
|
Leerzeichen getrennte Auflistung von regexp:icon-name:cmd
|
||||||
|
Dreierpärchen, icon-name und cmd dürfen leer sein.<br>
|
||||||
|
|
||||||
|
Wenn der Zustand des Gerätes mit der regexp übereinstimmt,
|
||||||
|
wird als icon-name das entsprechende Status Icon angezeigt, und (falls
|
||||||
|
definiert), löst ein Klick auf das Icon das entsprechende cmd aus.
|
||||||
|
Wenn fhem icon-name nicht finden kann, wird der Status als Text
|
||||||
|
angezeigt.
|
||||||
|
Beispiel:<br>
|
||||||
|
<ul>
|
||||||
|
attr lamp devStateIcon on:closed off:open<br>
|
||||||
|
attr lamp devStateIcon on::A0 off::AI<br>
|
||||||
|
attr lamp devStateIcon .*:noIcon<br>
|
||||||
|
</ul>
|
||||||
|
Anmerkung: Wenn das Icon ein SVG Bild ist, kann das @colorname Suffix
|
||||||
|
verwendet werden um das Icon einzufärben. Z.B.:<br>
|
||||||
|
<ul>
|
||||||
|
attr Fax devStateIcon on:control_building_empty@red off:control_building_filled:278727
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
</ul>
|
||||||
|
Zweite Variante:<br>
|
||||||
|
<ul>
|
||||||
|
Perl regexp eingeschlossen in {}. Wenn der Code undef
|
||||||
|
zurückliefert, wird das Standard Icon verwendet; wird ein String
|
||||||
|
in <> zurück geliefert, wird dieser als HTML String interpretiert.
|
||||||
|
Andernfalls wird der String als devStateIcon gemäß der
|
||||||
|
ersten Variante interpretiert, siehe oben. Beispiel:<br>
|
||||||
|
|
||||||
|
{'<div style="width:32px;height:32px;background-color:green"></div>'}
|
||||||
|
</ul>
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="devStateStyle"></a>
|
||||||
|
<li>devStateStyle<br>
|
||||||
|
Für ein best. Gerät einen best. HTML-Style benutzen.
|
||||||
|
Beispiel:<br>
|
||||||
|
<ul>
|
||||||
|
attr sensor devStateStyle style="text-align:left;;font-weight:bold;;"<br>
|
||||||
|
</ul>
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="webCmd"></a>
|
||||||
|
<li>webCmd<br>
|
||||||
|
Durch Doppelpunkte getrennte Auflistung von Befehlen, die für ein
|
||||||
|
bestimmtes Gerät gelten sollen. Funktioniert nicht mit
|
||||||
|
smallscreen, ein Ersatz dafür ist der devStateIcon Befehl.<br>
|
||||||
|
Beispiel:
|
||||||
|
<ul>
|
||||||
|
attr lamp webCmd on:off:on-for-timer 10<br>
|
||||||
|
</ul>
|
||||||
|
<br>
|
||||||
|
|
||||||
|
Der erste angegebene Befehl wird in der "set device ?" list
|
||||||
|
nachgeschlagen (Siehe das <a href="#setList">setList</a> Attrib
|
||||||
|
für Dummy Geräte). Wenn <b>dort</b> bekannte Modifier sind,
|
||||||
|
wird ein anderes Widget angezeigt:
|
||||||
|
<ul>
|
||||||
|
<li>Ist der Modifier ":noArg", wird kein weiteres Eingabefeld
|
||||||
|
angezeigt.</li>
|
||||||
|
|
||||||
|
<li>Ist der Modifier ":time", wird ein in Javaskript geschreibenes
|
||||||
|
Zeitauswahlmenü angezeigt.</li>
|
||||||
|
|
||||||
|
<li>Ist der Modifier ":textField", wird ein Eingabefeld
|
||||||
|
angezeigt.</li>
|
||||||
|
|
||||||
|
<li>Ist der Modifier in der Form
|
||||||
|
":slider,<min>,<step>,<max>", so wird ein in
|
||||||
|
JavaScript programmierter Slider angezeigt</li>
|
||||||
|
|
||||||
|
<li>In allen anderen Fällen erscheint ein Dropdown mit allen
|
||||||
|
Modifier Werten.</li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
Wenn der Befehl state ist, wird der Wert als Kommando interpretiert.<br>
|
||||||
|
Beispiele für modifier:
|
||||||
|
<ul>
|
||||||
|
define d1 dummy<br>
|
||||||
|
attr d1 webCmd state<br>
|
||||||
|
attr d1 setList state:on,off<br>
|
||||||
|
define d2 dummy<br>
|
||||||
|
attr d2 webCmd state<br>
|
||||||
|
attr d2 setList state:slider,0,1,10<br>
|
||||||
|
define d3 dummy<br>
|
||||||
|
attr d3 webCmd state<br>
|
||||||
|
attr d3 setList state:time<br>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
Anmerkung: dies ist ein Attribut für das anzuzeigende Gerät,
|
||||||
|
nicht für die FHEMWEBInstanz.
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
<a name="column"></a>
|
||||||
|
<li>column<br>
|
||||||
|
Damit werden mehrere Spalten für einen Raum angezeigt, indem
|
||||||
|
sie verschiedene Gruppen Spalten zuordnen. Beispiel:<br>
|
||||||
|
<ul><code>
|
||||||
|
attr WEB column LivingRoom:FS20,notify|FHZ,notify DiningRoom:FS20|FHZ
|
||||||
|
</code></ul>
|
||||||
|
|
||||||
|
In diesem Beispiel werden im Raum LivingRoom die FS20 sowie die notify
|
||||||
|
Gruppe in der ersten Spalte, die FHZ und das notify in der zweiten
|
||||||
|
Spalte angezeigt.<br>
|
||||||
|
|
||||||
|
Anmerkung: einige Elemente, wie SVG Plots und readingsGroup können
|
||||||
|
nur Teil einer Spalte sein wenn sie in <a href="#group">group</a>
|
||||||
|
stehen.
|
||||||
|
</li><br>
|
||||||
|
|
||||||
|
</ul>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
=end html_DE
|
||||||
|
|
||||||
=cut
|
=cut
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user