FHEMWiki - Letzte Änderungen [de]

FritzSmart

Ph1959de — Tue, 21 Jul 2026 17:27:53 GMT

Abgrenzung zum alten Modul FRITZBOX genauer erläutert.

Neue Seite

{{Hinweis|Im März 2026 wurde das Modul 72_FRITZBOX.pm durch 72_FritzSmart.pm abgelöst. Das Modul 72_FRITZBOX.pm steht weiterhin zur Verfügung, wird allerdings nicht gepflegt / weiterentwickelt (FRITZBOX Modulversionen ab März 2026 zeigen in den "Internals" die erforderlichen Informationen zum Umstieg auf das neue Modul an).
<br>Diese Seite (FritzSmart) entstand aus der Übernahme der Informationen der alten (FRITZBOX) Seite, ist aber technisch auf einem relativ alten Stand und muss überarbeitet und ergänzt werden.}}
{{Infobox Modul
|ModPurpose=Steuerung von Fritz (AVM) Komponenten FHEM
|ModType=d
|ModForumArea=FRITZ!Box
|ModTechName=72_FritzSmart.pm
|ModOwner=Jörg/JoWiemann ({{Link2FU|94|Forum}} / [[Benutzer Diskussion:JoWiemann|Wiki]])}}
[[FritzSmart]] ermöglicht die Steuerung einer [[AVM Fritz!Box]], von AVM FRITZ!WLAN Repeatern oder FritzSmart Geräten durch FHEM. An Fritzboxen können sowohl Geräte abgefragt werden, auf denen FHEM selbst läuft (lokaler Modus), als auch entfernte (externe) Geräte.

== Voraussetzungen ==
=== Remote-Zugang ===
<br clear=all>
{{Randnotiz|RNTyp=y|RNText=Im März 2026 wurde das Modul 72_FRITZBOX.pm durch 72_FritzSmart.pm abgelöst. Das Modul 72_FRITZBOX.pm steht weiterhin zur Verfügung, wird allerdings nicht gepflegt / weiterentwickelt.}}
Für den Remote-Zugang müssen die Module JSON:XS, LWP und SOAP::Lite und das Perl Modul XML::Simple installiert sein; auf einem [[Raspberry Pi]] oder unter Ubuntu z. B. mit dem Befehl
:<code>sudo apt-get install libjson-perl libwww-perl libsoap-lite-perl libjson-xs-perl libxml-simple-perl</code>

Teilweise ist derzeit zusätzlich die Installation der telnet Libraries erforderlich, auch wenn der Telnet-Zugang nicht genutzt werden soll. Siehe dazu den nachfolgenden Abschnitt.

== Installation ==
=== Erste Schritte ===
Zur Erstinstallation reicht ein einfaches <code>define FritzBox FritzSmart < ip oder Hostname> </code>, dieses Modul funktioniert lokal (FHEM auf Fritzbox) sowie per Fernzugriff (FHEM auf einem anderen Server im Netz, siehe nächsten Schritt).

==== TR-064: Modul FritzSmart für Zugriff auf einem externen Server einrichten ====
Für den Fernzugriff über TR-064 auf eine oder mehrere Fritzboxen und/oder einen FRITZ!WLAN Repeater sind die folgenden Schritte nötig (für jedes Gerät):

Fritzbox definieren:
:<code>define FritzBox FritzSmart < IP oder Hostname ></code>

192.168.168.168 dabei natürlich durch die passende IP ersetzen... Alternativ kann statt der IP auch der Hostname eingegeben werden.

Wenn ('''und nur wenn''') das Login auf der Benutzeroberfläche der FritzBox mit User und Passwort (und nicht nur per Passwort) geschieht, den User konfigurieren:
:<code>attr FritzBox boxUser ''Benutzername'' </code>
In der Fritzbox muss dann auch "Anmeldung mit FRITZ!Box-Benutzernamen und Kennwort" ausgewählt sein.

Passwort konfigurieren:
:<code>set FritzBox password ''Passwort''</code> - legt das zugehörige Passwort fest (nur einmal --> gehört nicht in die cfg-Datei

== Anwendung ==
=== Define ===
Siehe {{Link2CmdRef|Lang=de|Anker=FritzSmartdefine}}

=== Attribute ===
Siehe {{Link2CmdRef|Lang=de|Anker=FritzSmartattr}}

=== TR-064 ===
Die offizielle Programmier-Schnittstelle der Fritz!Box läuft über das Protokoll TR-064. In der Web-Oberfläche der FritzBox muss die TR064 Schnittstelle explizit freigeschaltet sein. Ist dies nicht der Fall, werden entsprechende Informationen und Funktionen des Moduls deaktiviert. Der aktuelle Status wird im Device im Bereich Internals durch das Reading TR064 dargestellt.

Mit dem Befehl
:<code>get <device> tr064Command <service> <control> <action> [[parameterName1 parameterValue1] ...]</code>
freischalten und damit auf diese Schnittstelle zugreifen.

AVM hat die Schnittstellenbeschreibung unter [http://avm.de/service/schnittstellen/] veröffentlicht. Diese wird jedoch nur sehr sporadisch gepflegt.

Ein besserer Einstiegspunkt befindet sich auf der Box unter http://fritz.box:49000/tr64desc.xml.
Die möglichen TR-064-Aktionen kann man auch über den Befehl
:<code>get <device> tr064ServiceList</code>
auslesen.

Folgende Services und Controls existieren (für den get-Befehl ''tr064Command'' werden nur die fett formatierten Wörter benötigt)

{| class="wikitable"
|-
!serviceType!!controlURL!!XML!!Dokument bei AVM
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''DeviceInfo:1'''||/upnp/control/'''deviceinfo'''||[http://fritz.box:49000/deviceinfoSCPD.xml deviceinfoSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/deviceinfoSCPD.pdf deviceinfoSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''DeviceConfig:1'''||/upnp/control/'''deviceconfig'''||[http://fritz.box:49000/deviceconfigSCPD.xml deviceconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/deviceconfigSCPD.pdf deviceconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''Layer3Forwarding:1'''||/upnp/control/'''layer3forwarding'''||[http://fritz.box:49000//layer3forwardingSCPD.xml layer3forwardingSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/layer3forwardingSCPD.pdf layer3forwardingSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''LANConfigSecurity:1'''||/upnp/control/'''lanconfigsecurity'''||[http://fritz.box:49000//lanconfigsecuritySCPD.xml lanconfigsecuritySCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/lanconfigsecuritySCPD.pdf lanconfigsecuritySCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''ManagementServer:1'''||/upnp/control/'''mgmsrv'''||[http://fritz.box:49000//mgmsrvSCPD.xml mgmsrvSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/mgmsrvSCPD.pdf mgmsrvSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''Time:1'''||/upnp/control/'''time'''||[http://fritz.box:49000//timeSCPD.xml timeSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/timeSCPD.pdf timeSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''UserInterface:1'''||/upnp/control/'''userif'''||[http://fritz.box:49000//userifSCPD.xml userifSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/userifSCPD.pdf userifSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_VoIP:1'''||/upnp/control/'''x_voip'''||[http://fritz.box:49000//x_voipSCPD.xml x_voipSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_voipSCPD.pdf x_voipSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_Storage:1'''||/upnp/control/'''x_storage'''||[http://fritz.box:49000//x_storageSCPD.xml x_storageSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_storageSCPD.pdf x_storageSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_OnTel:1'''||/upnp/control/'''x_contact'''||[http://fritz.box:49000//x_contactSCPD.xml x_contactSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_contactSCPD.pdf x_contactSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_WebDAVClient:1'''||/upnp/control/'''x_webdav'''||[http://fritz.box:49000//x_webdavSCPD.xml x_webdavSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_webdavSCPD.pdf x_webdavSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_UPnP:1'''||/upnp/control/'''x_upnp'''||[http://fritz.box:49000//x_upnpSCPD.xml x_upnpSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_upnp.pdf x_upnp.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_RemoteAccess:1'''||/upnp/control/'''x_remote'''||[http://fritz.box:49000/x_remoteSCPD.xml x_remoteSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_remoteSCPD.pdf x_remoteSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_MyFritz:1'''||/upnp/control/'''x_myfritz'''||[http://fritz.box:49000/x_myfritzSCPD.xml x_myfritzSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_myfritzSCPD.pdf x_myfritzSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_TAM:1'''||/upnp/control/'''x_tam'''||[http://fritz.box:49000/x_tamSCPD.xml x_tamSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_tam.pdf x_tam.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_AppSetup:1'''||/upnp/control/'''x_appsetup'''||[http://fritz.box:49000/x_homeautoSCPD.xml x_homeautoSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_appsetupSCPD.pdf x_appsetupSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''X_AVM-DE_Homeauto:1'''||/upnp/control/'''x_homeauto'''||[http://fritz.box:49000/x_homeautoSCPD.xml x_homeautoSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/x_homeautoSCPD.pdf x_homeautoSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WLANConfiguration:1'''||/upnp/control/'''wlanconfig1'''||[http://fritz.box:49000/wlanconfigSCPD.xml wlanconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wlanconfigSCPD.pdf wlanconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WLANConfiguration:2'''||/upnp/control/'''wlanconfig2'''||[http://fritz.box:49000/wlanconfigSCPD.xml wlanconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wlanconfigSCPD.pdf wlanconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WLANConfiguration:3'''||/upnp/control/'''wlanconfig3'''||[http://fritz.box:49000/wlanconfigSCPD.xml wlanconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wlanconfigSCPD.pdf wlanconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''Hosts:1'''||/upnp/control/'''hosts'''||[http://fritz.box:49000/hostsSCPD.xml hostsSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/hostsSCPD.pdf hostsSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''LANEthernetInterfaceConfig:1'''||/upnp/control/'''lanethernetifcfg'''||[http://fritz.box:49000/lanifconfigSCPD.xml lanifconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/lanifconfigSCPD.pdf lanifconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''LANHostConfigManagement:1'''||/upnp/control/'''lanhostconfigmgm'''||[http://fritz.box:49000/lanhostconfigmgmSCPD.xml lanhostconfigmgmSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/lanhostconfigmgmSCPD.pdf lanhostconfigmgmSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WANCommonInterfaceConfig:1'''||/upnp/control/'''wancommonifconfig1'''||[http://fritz.box:49000/wancommonifconfigSCPD.xml wancommonifconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wancommonifconfigSCPD.pdf wancommonifconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WANDSLInterfaceConfig:1'''||/upnp/control/'''wandslifconfig1'''||[http://fritz.box:49000/wandslifconfigSCPD.xml wandslifconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wandslifconfigSCPD.pdf wandslifconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WANDSLLinkConfig:1'''||/upnp/control/'''wandsllinkconfig1'''||[http://fritz.box:49000/wandsllinkconfigSCPD.xml wandsllinkconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wandsllinkconfigSCPD.pdf wandsllinkconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WANEthernetLinkConfig:1'''||/upnp/control/'''wanethlinkconfig1'''||[http://fritz.box:49000/wanethlinkconfigSCPD.xml wanethlinkconfigSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wanethlinkconfigSCPD.pdf wanethlinkconfigSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WANPPPConnection:1'''||/upnp/control/'''wanpppconn1'''||[http://fritz.box:49000/wanpppconnSCPD.xml wanpppconnSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wanpppconnSCPD.pdf wanpppconnSCPD.pdf]
|-
|<nowiki>urn:dslforum-org:service:</nowiki>'''WANIPConnection:1'''||/upnp/control/'''wanipconnection1'''||[http://fritz.box:49000/wanipconnSCPD.xml wanipconnSCPD.xml]||[http://avm.de/fileadmin/user_upload/Global/Service/Schnittstellen/wanipconnSCPD.pdf wanipconnSCPD.pdf]
|-
|}

=== Status-Symbol ===
<code>attr <device> devStateIcon .*on.*off:WLAN_on_gWLAN_off .*on.*on.*:WLAN_on_gWLAN_on WLAN..off.*:WLAN_off</code>

Im Verzeichnis www/images/default müssen die passenden Dateien "WLAN_on_gWLAN_off.png", "WLAN_on_gWLAN_on.png" und "WLAN_off.png" liegen. Wenn die PNGs fehlen, können sie {{Link2Forum|Topic=29725|Message=318113|LinkText=hier}} heruntergeladen werden.

== Anwendungsbeispiele ==
[[Datei:Screenshot_FritzBox1.png|mini|300px|rechts|FRITZBOX Gerät auf der FHEM Oberfläche]]
Sollte alles geklappt haben, seht ihr nun unter "Unsortiert" den im nebenstehenden Screenshot gezeigten Eintrag für das "Gerät" (hier mit dem Icon "it_router").

=== TR-064 Beispiele ===
*Box Reboot: <code>get <device> tr064Command DeviceConfig:1 deviceconfig Reboot</code>
*Internet Reconnect: <code>get <device> tr064Command WANIPConnection:1 wanipconnection1 ForceTermination</code>
*Daten eines Smart-Home-Gerätes auslesen: <code>get <device> tr064Command X_AVM-DE_Homeauto:1 x_homeauto GetGenericDeviceInfos NewIndex 0</code>

=== Klingel- und Sprachausgabe per TR-064 ===
Das geht derzeit nicht, da entsprechende Kommandos per TR-064 nicht verfügbar sind. Da Telnet sukzessive abgestellt wird, sollten sich Interessenten per Feature-Request an AVM wenden, wie {{Link2Forum|Topic=38586|LinkText=hier}} beschrieben.

Eine Alternative um Telefone klingeln zu lassen, ist die Nutzung des [[SIP-Client]]s.

=== Anwesenheitserkennung per regelmäßiger Abfrage über das PRESENCE Modul ===
Fritzboxen und die FRITZ!WLAN Repeater speichern den Status angemeldeter Geräte. Dieser Status lässt sich mittels des FritzSmart Moduls über Readings abfragen, die das Format mac_AA_AA_AA_AA_AA_AA haben und die MAC-Adressen der jeweils angemeldeten Geräte (AA:AA:AA:AA:AA:AA) enthalten. Das Reading existiert, wenn das Gerät angemeldet ist. Wenn das Gerät abgemeldet ist, existiert es nicht mehr. Es gibt auch noch den Zwischenstatus "inactive", der anscheinend gesetzt wird, bevor das Reading gelöscht wird.

Mit Hilfe des [[PRESENCE]] Moduls (vgl. [[Anwesenheitserkennung]]) kann man auf diese Weise den Anwesenheitsstatus abfragen. Anregungen dazu gibt es im zugehörigen {{Link2Forum|Topic=39433|LinkText=Forenthread}} zur Anwesenheitserkennung und in [http://heinz-otto.blogspot.de/2015/07/die-zeiten-andern-sich.html diesem Blogpost]. Auf dieser Basis könnte eine einfache Implementierung zum Beispiel so aussehen:

Funktion in [[99_myUtils anlegen|99_myUtils]]:
'''(Bitte beim Speichern darauf achten, dass nicht der Name 99_Utils gewählt wird.)'''

<syntaxhighlight lang="perl">sub checkFritzMACpresent($$) {
# Benötigt: Name der zu testenden Fritzbox ($d),
# zu suchende MAC ($m),
# Rückgabe: 1 = Gerät gefunden
# 0 = Gerät nicht gefunden
my ($d,$m) = @_;
$m =~ s/:/_/g;
$m = "mac_".uc($m);
return (ReadingsVal($d,$m,"inactive") ne "inactive") ? 1 : 0;
}</syntaxhighlight>

Nutzung dieser Funktion mit dem PRESENCE Modul definieren:
:<code>define <Name> PRESENCE function {checkFritzMACpresent("Fritzbox","AA:BB:CC:DD:EE:FF")} 60 60</code>
wobei
*<Name> ein beliebig zu wählender Name für die PRESENCE-Funktion ist,
*Fritzbox der Name ist, mit dem ihr die abzufragende Fritzbox als FritzSmart definiert habt,
*AA:BB:CC:DD:EE:FF die MAC-Adresse des gesuchten Geräts ist.
* "60 60" sagt, dass der Anwesenheitsstatus im 60-Sekunden-Takt abgefragt wird. Das macht natürlich nur Sinn, wenn ihr mit <code>attr Fritzbox INTERVAL 60</code> den Abfrageinterval bei der Fritzbox auch entsprechend hochgesetzt habt. Der Standard ist 300.
* "Log 1" führt immer zum Loggen. Das ist zum Einrichten praktisch, ohne dass man gleich für das ganze Modul oder ganz FHEM <code>attr <device> verbose 5</code> setzen muss. Wenn es läuft, können die "Log 1"-Zeilen gelöscht, auskommentiert (# an den Zeilenanfang) oder in "Log 5" geändert werden.

=== Anwesenheitserkennung über mehrere Fritzboxen oder AVM Repeater und Fritzbox ===
Existiert ein AVM Repeater im Netzwerk, kann der als eigenständiges Gerät mit FritzSmart definiert werden. WLAN Geräte an der Fritzbox werden in der Instanz der Fritzbox gelistet und WLAN Geräte am Repeater in der Repeater Instanz. Um trotzdem die Anwesenheit im Netzwerk einfach zu erkennen, muss die Subroutine in 99_myUtils.pm abgewandelt werden. (Siehe auch [https://forum.fhem.de/index.php/topic,39433.msg1075247.html#msg1075247 Forum Beitrag])

Existiert eine zweite Fritzbox im Accesspointmodus, werden die WLAN Geräte im Netzwerk alle in der Hauptfritzbox an einem LAN Anschluss gelistet. D.h. man sieht an der Hauptfritzbox nicht, dass sie im WLAN sind. Eine zweite Instanz mit dem FritzSmart Modul muss wegen der Anwesenheitserkennung nicht gemacht werden. Die folgende Routine kann aber universell eingesetzt werden, unabhängig von der Anzahl der FritzSmart Instanzen. Wer mitloggen will, kann das analog zur obigen Routine einbauen

<syntaxhighlight lang="perl">sub checkAllFritzMACpresent($) {
# Benötigt: nur die zu suchende MAC ($MAC),
# Es werden alle Instanzen vom Type FritzSmart abgefragt
#
# Rückgabe: 1 = Gerät gefunden
# 0 = Gerät nicht gefunden
my ($MAC) = @_;
# Wird in keiner Instanz die MAC Adresse gefunden bleibt der Status 0
my $Status = 0;
$MAC =~ tr/:/_/;
$MAC = "mac_".uc($MAC);
my @FBS = devspec2array("TYPE=FritzSmart");
foreach( @FBS ) {
my $StatusFritz = ReadingsVal($_, $MAC, "weg");
if ($StatusFritz eq "weg") {
# Dieser Zweig testet ob das Reading vorhanden ist
} elsif ($StatusFritz eq "inactive") {
# Dieser Zweig testet ob im Reading inactive steht
} elsif ($StatusFritz =~ /(.*)s, 0/) {
# Dieser Zweig testet auf "<geraetename> (WLAN, 0 / 0 Mbit/s, 0)"
} else { $Status = 1}
}
return $Status
}</syntaxhighlight>

Da hiermit nach allen Instanzen mit dem TYPE=FritzSmart durchsucht wird, braucht der Name der Fritzbox nicht angegeben werden.

:<code>define <Name> PRESENCE function {checkAllFritzMACpresent("AA:BB:CC:DD:EE:FF")} 60 60</code>

Weitere Hinweise zu komplexeren Abfragen mehrere Boxen auf einmal etc. findet ihr auch im diesem {{Link2Forum|Topic=39433|LinkText=Forenthread}}.

=== Anwesenheitserkennung per Notify ===
Der von Fritzboxen und Fritz!WLAN Repeatern gespeicherte Status zum Status angemeldeter Geräte lässt sich (statt per PRESENCE, s.o.) auch per [[notify]] anfragen:

<syntaxhighlight lang="perl">define n_PRESENCE_mac_AA_BB_CC_DD_EE_FF notify Fritzbox:mac_AA_BB_CC_DD_EE_FF:.* {
my $s = "absent";
$s = "present" if (ReadingsVal($NAME,"mac_AA_BB_CC_DD_EE_FF","inactive") ne "inactive");
fhem("set anwesend_smartphone $s");
}</syntaxhighlight>

Hinweise:
* <code>fhem("set anwesend_smartphone $s");</code> ist nur ein Beispiel, das einen Dummy auf den Status "absent" bzw. "present" setzt. Man kann hier natürlich auch gleich entsprechende Aktionen durchführen. Wer das Beispiel übernehmen möchte, sollte den Dummy vorher definieren (<code>define anwesend_smartphone dummy</code>).
* mac_AA_BB_CC_DD_EE_FF ist die MAC-Adresse des gesuchten Geräts.
* "Fritzbox" ist der Name, unter dem die Fritzbox als FritzSmart-Modul definiert wurde.
* Das Notify funktioniert, weil Geräte, wenn sie sich abgemeldet haben, erst den Status "inactive" erhalten. Ist das Gerät ganz abgemeldet, verschwindet das mac_.*-Reading. Dabei löst das Notify nicht mehr aus. Da das mac-.*-Reading aber vorher auf "inactive" stand, wurde die Abwesend-Aktion schon ausgeführt.
* Damit der Notify nicht andauernd losgeht, sollte man mittels <code>attr Fritzbox [[event-on-change-reading]] mac_AA_BB_CC_DD_EE_FF</code> Events nur auslösen, wenn sich der Status des Gerätes ändert. Will man mehrere Geräte abfragen, sollte man <code>attr Fritzbox event-on-change-reading mac_AA_BB_CC_DD_EE_FF,mac_GG_HH_II_JJ_KK_LL</code> setzen, damit bei der Änderung jedes Readings ein Event ausgelöst wird.

Ein alternativer Ansatz mit einem [[DOIF]]:
<syntaxhighlight lang="perl">
define di_PRESENCE_handy DOIF (\
[Fritzbox:mac_AA_BB_CC_DD_EE_FF,"inactive"] eq "inactive"\
)\
( msg Tschuess )\
DOELSE\
( msg Hallo )

attr di_PRESENCE_handy cmdState absent|present
</syntaxhighlight>Für das DOIF gelten im Wesentlichen dieselben Hinweise wie für das notify oben und auch die im nächsten Abschnitt beschriebenen Vor- und Nachteile. Man bekommt allerdings dank dem <code>attr cmdState</code> auch gleichzeitig noch ein Device mit dem passenden Status "frei Haus", kann sich also das oben beschriebene dummy-Device sparen und auch das <code>event-on-change-reading</code> sollte nicht nötig sein.

=== Vergleich Anwesenheitserkennung PRESENCE/Notify ===
Die Anwesenheitserkennung per regelmäßiger PRESENCE-Abfrage hat den Vorteil, dass sie im Turnus der regelmäßigen Abfragen immer einen aktuellen Status produziert. Sie hat dafür den Nachteil, dass die PRESENCE-Funktionen regelmäßig abgearbeitet werden müssen, auch wenn sich gar nichts ändert. Außerdem aktualisiert sich der Status nicht sofort, sondern erst bei der nächsten regelmäßigen Abfrage. Durch häufiges Abfragen kann dieser Nachteil verringert werden (bei entsprechend höherer Systemlast).

Die Anwesenheitserkennung per Notify hat den Vorteil, dass ein sich ändernder Status sofort abgebildet wird. Ändert sich kein Status, werden keine Routinen ausgeführt, was die Systemlast gering hält. Der Nachteil ist, dass - z.B. nach einem Systemstart - die entsprechende Aktion erst bei einer Änderung des Status ausgeführt wird. D.h. ist das zu testende Gerät anwesend, wird dann FHEM beendet, das Gerät entfernt und FHEM wieder gestartet, ist der Status in FHEM immer noch "anwesend". Da das Reading für das Gerät nicht existiert, wird darauf auch erst wieder ein Notify ausgeführt, wenn sich der Status des Geräts wieder ändert, d.h. es wieder ankommt. Bis dahin ist der Status im System falsch.
Der Nachteil des Notify kann verringert werden, wenn man statt <code>attr Fritzbox event-on-change-reading mac_AA_BB_CC_DD_EE_FF</code> ein <code>attr Fritzbox [[event-on-update-reading]] mac_AA_BB_CC_DD_EE_FF</code> setzt. Das erhöht allerdings die Systemlast und funktioniert auch nur für den Status "anwesend". Bei "abwesend" ist kein Reading vorhanden, so dass auch event-on-update-reading nicht ausgeführt wird.
Eine weitere Möglichkeit, den Nachteil der Notify-Methode auszugleichen, ist, die Statusabfrage beim Systemstart einmal manuell auszuführen, durch ein notify auf "GLOBAL:initialized":
<syntaxhighlight lang="perl">global:INITIALIZED {
my $s = "absent";
$s = "present" if (ReadingsVal("Fritzbox","mac_AA_BB_CC_DD_EE_FF","inactive") ne "inactive");
fhem("set anwesend_smartphone $s");
}</syntaxhighlight>
Das hilft allerdings nur beim Systemstart. Nicht, wenn FHEM aufgrund irgendwelcher Hänger eine Aktualisierung des Status verpasst hat.

=== userReadings per ''get tr064Command'' oder ''get luaQuery'' ===
Um dem Gerätewert <userReadingName> den Wert von <VariabelName> aus der Rückgabe des get-Befehls ''tr064Command'' oder ''luaQuery'' zuzuordnen
<pre>
attr <device> userReadings <userReadingName> {my $resp=fhem("get <device> tr064Command <service> <control> <action> [[<argName1> <argValue1>] ...]",1);;$resp =~/\'<VariabelName>\' => '(.*)'/;;return $1;;}
</pre>
{{Randnotiz|RNTyp=r|RNText='''VORSICHT''': man sollte einen genaueren Trigger für diese userReadings setzen, sonst wird bei jeder Aktualierung von jedem Reading das get Kommando ausgeführt, was ganz schnell ein (für fhem blockierende) Dauerlaufer werden kann.}}

Beispielsweise
<pre>attr Fritzbox userReadings urMobilteil_1 {my $resp=fhem("get Fritzbox tr064Command X_AVM-DE_OnTel:1 x_contact GetDECTHandsetInfo NewDectID 1",1);;$resp =~/'NewHandsetName' => '(.*)'/;;return $1;;},
urDownstreamDSLRate {my $resp=fhem("get Fritzbox tr064Command WANDSLInterfaceConfig:1 wandslifconfig1 GetInfo",1);;$resp =~/'NewDownstreamCurrRate' => '(.*)'/;;return $1;;},
urUpstreamDSLRate {my $resp=fhem("get Fritzbox tr064Command WANDSLInterfaceConfig:1 wandslifconfig1 GetInfo",1);;$resp =~/'NewUpstreamCurrRate' => '(.*)'/;;return $1;;}</pre>
oder bei einzelnen Werte über ''get luaQuery''<pre>attr Fritzbox userReadings sip1_connect {my $resp=fhem("get Fritzbox luaQuery sip:settings/sip1/connect",1);;$resp =~/([0-9])$/;;return $1;;}</pre>

=== Klingelton-Einstellung und Abspielen von Sprachnachrichten bei Fritz!OS-Versionen >6.24 ===
Wenn die Fritzbox weder die Telnet- noch die webcmd-Schnittstelle hat, kann der Klingelton der Fritz!Fons nicht mehr verstellt und auch keine Sprachnachricht über ein Fritz!Fon ausgegeben werden.

Es gibt eine Behelfslösung über das Attribut ''useGuiHack''. Dadurch wird eine Eingabe in die WebGUI der Fritzbox simuliert.

'''ACHTUNG''': Vor allem nach einem Update der FritzBox kann es durch dieses Attribut zu ungewolltem Verstellen von Werten in der Fritzbox kommen.

Bei Verwendung der ring-Parameter "play:" und "say:" wird die abzuspielende URL in die M3U-Datei, die unter dem Internal ''M3U_LOCAL'' steht, eingetragen.

Standardmäßig wird versucht, diese Datei im image-Verzeichnis von FHEM abzulegen. Diese kann dann vom Fritz!Fon über [[FHEMWEB]] abgespielt werden (IP-Freigaben beachten). Direkt nach dem ersten Anlegen der m3u-Datei kennt [[FHEMWEB]] diese noch nicht, daher bitte entweder ''set <webdevice> rereadicons'' ausführen oder FHEM neu starten.

Aufgrund der Beschränkungen von [[FHEMWEB]] oder auch bei Authentifizierungsanforderungen ist es empfehlenswert, die Datei über das Attribute ''m3uFileLocal'' selber vorzugeben. Am besten auf einem Webserver, der auf dem FHEM-Server läuft und dessen Seiten-Verzeichnis durch FHEM beschreibbar ist. Beispiel:
:<code>attr Fritzbox m3uFileLocal /var/www/mp3/Fritzbox.m3u</code>

In dem Radioeintrag ''FHEM'' muss dann '''auf der FritzBox''', die '''Web'''-Adresse der entsprechenden Datei eingetragen werden. Dieser Sender sollte zu Testzwecken dann auch einmal am Fritz!Fon von Hand gestartet werden.

Das Modul versucht, beim Start die einzutragende Radio-URL im image-Verzeichnis selber zu ermitteln (IP-Freigabe beachten). Gelingt dies, so steht diese im Internal ''M3U_URL''.

=== Ring auf mehreren Telefonen gleichzeitig ===
Damit mehrere Telefone per ring gleichzeitig klingeln, muss in der Fritzbox eine Rufgruppe definiert werden.
Sollte eine Türsprechanlage schon in Benutzung sein, kann die eventuell hierfür bereits eingerichtete Gruppe verwendet werden.

Das Anlegen der Gruppe kann wie in folgender AVM Anleitung beschrieben erledigt werden. [https://avm.de/service/fritzbox/fritzbox-7390/wissensdatenbank/publication/show/1148_Interne-Rufgruppe-in-FRITZ-Box-einrichten-Gruppenruf/ AVM Interne Rufgruppe anlegen]

Es muss eine Kurzwahl bei der Gruppe zwingend hinterlegt sein. Danach kann mit folgendem Beispielcode gearbeitet werden:
:<code>set FritzBox ring 791 15 show:Türklingel</code>

Name des Devices, Rufgruppen Nummer, Länge und gezeigter Text auf das Gewünschte anpassen.

== Bekannte Probleme / Fehlersuche ==
=== Fehler nach Firmware Update ===
Typischer Fehler ist hier "Error: 403 Forbidden".
Nach einem Firmwareupdate der Fritzbox am besten auch FHEM neu starten.

=== Modul bleibt im Status "Check APIs" hängen===
Im Log steht die Meldung: "Error: Timeout when reading Fritz!Box data.".

Mögliche Ursache: Nutzung des FHEM-Befehls [[rereadcfg]]. Dieser verträgt sich nicht mit dem Modul "blocking.pm", das für parallel laufende FHEM-Prozesse genutzt wird.

Abhilfe schafft ein Neustart <code>shutdown restart</code> oder das Einfügen eines zusätzlichen, lokalen Telnet-Ports z.B. durch <code>define tPortLocal telnet 7073</code>

=== Nachtschaltung Doppel-WLAN ===
Beim Abschalten des WLAN über das Modul wird (über TR064) zuerst das 2.4 GHz und dann das 5 GHz WLAN ausgeschaltet. Bei der gleichzeitigen Nutzung der WLAN-Nachtschaltung (Anschalten über das Fritz!OS) wird dann jedoch nur noch das 5 GHz WLAN wieder angeschaltet. Die Box interpretiert den TR064-Befehl anscheinend als ein komplettes Abwählen des 2.4 GHz WLAN.

Abhilfe schafft hier nur ein notify auf das 5 GHz WLAN mit einem nachträglichem Anschalten des 2.4 GHz WLAN.

Alternativ kann das Ausschalten des WLANs nicht direkt über TR064-Kommandos, sondern über einen indirekten Weg erfolgen: über TR064 ein set call abzusetzen und hier den Tastencode zum Ausschalten des WLANs einzugeben, bei einer FritzBox 7490 wäre dies z. B. #96*0*.
Schaltet man über diese Methode das WLAN aus, kann es über die Nachtschaltung wieder automatisch auf beiden Frequenzen angeschaltet werden.

=== Kabelboxen ===
Bei Fritz!Boxen für den Kabelanschluss (z.B. Kabel Deutschland) scheint neben Telnet auch die TR064-API nicht zu funktionieren. Vermutlich wurde die API von AVM auf Betreiberwunsch deaktiviert, da man sonst Dinge ändern kann, die das gesamte Kabelnetz stören können.

Zumindest für Unitymedia und einer FRITZ!Box 6490 Cable (lgi) mit FRITZ!OS:06.50 funktioniert TR064.

Eine Rufumleitung bei Abwesenheit (Modul PRESENCE) funktioniert mit einer vorher eingerichten Telefonnummer wie folgt:
<code>define Rufumleitung DOIF ([Anwesenheit.dum:state] eq "off") (set FritzBox6490 diversity 1 on) DOELSEIF ([Anwesenheit.dum:state] eq "on") (set FritzBox6490 diversity 1 off)</code>

=== Wenn's nicht klingelt ===
Das Klingeln erfolgt über die Wählhilfe. Eventuell muss über die Weboberfläche der Fritz!Box ein anderer Port eingestellt werden. Der aktuelle steht in "box_stdDialPort".

=== TR064-Transport-Error: 500 Can't connect to ...:49443 (certificate verify failed) ===
Eventuell hilft es, die Perl Module Net::HTTPS, Net::SSL und IO::Socket::SSL zu aktualisieren.

=== "Error: Old SID not valid anymore." nach Erlauben von IPv6 auf der Fritzbox ===
Ohne hier den genauen Grund zu kennen - es hilft die Angabe der IPv4-Adresse: also statt <code>define FritzBox FRITZBOX</code> dann <code>define FritzBox FRITZBOX <IP></code> (z.B. <code>define FritzBox FRITZBOX 192.168.10.1</code>), so dass das Modul nicht über IPv6 geht.

=== "Didn't get a session ID" ===
Bei gleichzeitiger Nutzung anderer Module für die Fritzbox (z.B. {{Link2CmdRef|Anker=FBAHAHTTP|Lang=en|Label=FBAHAHTTP}}) muss der Zugang über Benutzername und Password erfolgen.
:<code>attr <DEVICE> boxUser <USER></code>
Da das FRITZBOX-Modul eine inoffizielle Schnittstelle benutzt, muss dann auch der normale Zugang zur Box auf "Benutzername und Password" eingestellt sein.

In der Firmware 6.92 wird der Zugang über die Menüs "System"->"Fritz!Box-Benutzer"->"Anmeldung im Heimnetz" eingestellt.

Oft wird aber auch ein falsches oder gar kein Passwort gesetzt.

:<code>set <DEVICE> password <PASSWORD></code>

=== TR064-Error 401:invalid action ===
Eventuell ist auf der Fritzbox ein Benutzer gesetzt und im Modul nicht korrekt angegeben bzw. mit falschen Rechten versehen (attribut boxUser).

=== Smart-Home-Devices sind nicht in FHEM sichtbar ===
das Attribut 'enableSmartHome' muss gesetzt sein; zur Nutzung der Devices in FHEM eventuell noch das Modul FBAHAHTTP einrichten

Auch ZigBee-Devices werden dann als FBDECT-Devices gemappt.

== Links ==
* {{Link2Forum|Topic=29725|LinkText=Forenthread}} zu diesem Modul
* Neuer Support Thread im Forum, {{Link2Forum|Topic=70064|LinkText=ab April 2017}}

[[Kategorie:FritzBox]]
[[Kategorie:Akustische Ausgabe]]

FRITZBOX

Ph1959de — Tue, 21 Jul 2026 17:27:50 GMT

Weiterleitung auf Nachfolgemodul eingerichtet und entsprechende Hinweise eingefügt.

← Nächstältere Version		Version vom 21. Juli 2026, 19:27 Uhr
Zeile 1:		Zeile 1:
			#WEITERLEITUNG [[FritzSmart]]
			{{Hinweis\|Im März 2026 wurde das Modul 72_FRITZBOX.pm durch 72_FritzSmart.pm abgelöst. Das Modul 72_FRITZBOX.pm steht weiterhin zur Verfügung, wird allerdings nicht gepflegt / weiterentwickelt.
			FRITZBOX Modulversionen ab März 2026 zeigen in den "Internals" die erforderlichen Informationen zum Umstieg auf das neue Modul an.
			Diese Seite wird nicht mehr aktiv gepflegt, stellt aber die Weiterleitung auf die aktuellen Informationen sicher.}}
	{{Infobox Modul		{{Infobox Modul
	\|ModPurpose=Steuerung einer Fritz!Box über FHEM		\|ModPurpose=Steuerung einer Fritz!Box über FHEM
Zeile 5:		Zeile 9:
	\|ModTechName=72_FritzSmart.pm		\|ModTechName=72_FritzSmart.pm
	\|ModOwner=Jörg/JoWiemann ({{Link2FU\|94\|Forum}} / [[Benutzer Diskussion:JoWiemann\|Wiki]])}}		\|ModOwner=Jörg/JoWiemann ({{Link2FU\|94\|Forum}} / [[Benutzer Diskussion:JoWiemann\|Wiki]])}}
	Das Modul ~~(''~~FRITZBOX ~~alt)'' '''FritzSmart'''~~ ermöglicht die Steuerung einer [[AVM Fritz!Box]], von AVM FRITZ!WLAN Repeatern oder FritzSmart Geräten durch FHEM. An ~~Fritzboxen~~ können sowohl Geräte abgefragt werden, auf denen FHEM selbst läuft (lokaler Modus), als auch entfernte (externe) Geräte.		Das Modul [[FRITZBOX]] ermöglicht die Steuerung einer [[AVM Fritz!Box]], von AVM FRITZ!WLAN Repeatern oder FritzSmart Geräten durch FHEM. An FritzBoxen können sowohl Geräte abgefragt werden, auf denen FHEM selbst läuft (lokaler Modus), als auch entfernte (externe) Geräte.

	~~{{Randnotiz\|RNTyp=r\|RNText=Ab FRITZ!OS 6.25 wird das zwingend benötigte Telnet nicht mehr unterstützt, es müssen also die TR-064 Funktionen genutzt werden.}}~~
	~~{{Randnotiz\|RNTyp=y\|RNText='''Fork seit Januar 2021'''</br>~~
	Im Januar 2021 wurde von einem anderen Autor ({{Link2FU\|94\|JoWiemann}}) ein Fork begonnen, der Korrekturen und Weiterentwicklungen enthält. Beschreibungen und Modulversionen sind in {{Link2Forum\|Topic=118150\|LinkText=diesem Forenbeitrag}} zu finden.

	~~Seit Januar 2023 sind beide Versionen wieder im Modul 72_FRITZBOX.pm zusammengeführt.~~

	~~Im März 2026 wurde das Modul 72_FRITZBOX.pm durch 72_FritzSmart.pm abgelöst. Das Modul 72_FRITZBOX.pm steht weiterhin zur Verfügung, wird allerdings nicht gepflegt/weiter entwicklet.}}~~

	== Voraussetzungen ==		== Voraussetzungen ==
Zeile 21:		Zeile 17:

	Teilweise ist derzeit zusätzlich die Installation der telnet Libraries erforderlich, auch wenn der Telnet-Zugang nicht genutzt werden soll. Siehe dazu den nachfolgenden Abschnitt.		Teilweise ist derzeit zusätzlich die Installation der telnet Libraries erforderlich, auch wenn der Telnet-Zugang nicht genutzt werden soll. Siehe dazu den nachfolgenden Abschnitt.
			=== Telnet (wird vom Modul nicht mehr unterstützt) ===
	=== Telnet (wird vom Modul nicht mehr ~~unterstütz~~) ===		<br clear=all>{{Randnotiz\|RNTyp=r\|RNText=Ab FRITZ!OS 6.25 wird das zwingend benötigte Telnet nicht mehr unterstützt, es müssen also die TR-064 Funktionen genutzt werden.}}
			<br clear=all>
	== Installation ==		== Installation ==
	=== Erste Schritte ===		=== Erste Schritte ===
	Zur Erstinstallation reicht ein einfaches <code>define FritzBox FritzSmart < ip oder Hostname> </code>, dieses Modul funktioniert lokal (FHEM auf Fritzbox) sowie per Fernzugriff (FHEM auf einem anderen Server im Netz, siehe nächsten Schritt).		Zur Erstinstallation reicht ein einfaches <code>define FritzBox FritzSmart < ip oder Hostname> </code>, dieses Modul funktioniert lokal (FHEM auf Fritzbox) sowie per Fernzugriff (FHEM auf einem anderen Server im Netz, siehe nächsten Schritt).
			{{Randnotiz\|RNTyp=y\|RNText='''Fork seit Januar 2021'''</br>
			Im Januar 2021 wurde von einem anderen Autor ({{Link2FU\|94\|JoWiemann}}) ein Fork begonnen, der Korrekturen und Weiterentwicklungen enthält. Beschreibungen und Modulversionen sind in {{Link2Forum\|Topic=118150\|LinkText=diesem Forenbeitrag}} zu finden.

			Seit Januar 2023 sind beide Versionen wieder im Modul 72_FRITZBOX.pm zusammengeführt.

			Im März 2026 wurde das Modul 72_FRITZBOX.pm durch 72_FritzSmart.pm abgelöst. Das Modul 72_FRITZBOX.pm steht weiterhin zur Verfügung, wird allerdings nicht gepflegt/weiter entwicklet.}}

	==== TR-064: Modul FritzSmart für Zugriff auf einem externen Server einrichten ====		==== TR-064: Modul FritzSmart für Zugriff auf einem externen Server einrichten ====

Diskussion:UserReadings

Alkazaa — Tue, 21 Jul 2026 10:00:46 GMT

Hinweis bei 'integral'

@@ Zeile 51: / Zeile 51: @@
 Konkretes Beispiel: Bei einem Abtastintervall dt und drei aufeinander folgenden Messwerten a,a,b ist der Beitrag zum Integral dt*(a+a)/2 beim trigger auf das zweite a und dt*(a + b)/2 beim Trigger auf das b, insgesamt also dt*(3a+b)/2. Fehlt der trigger auf das zweite a, kommt beim trigger auf das b als gesamter Beitrag 2*dt*(a+b)/2 = dt*(2a+2b)/2.
-Die Diskussion im Forumsthread {{Link2Forum|Topic=26300|LinkText=Integralfunktion bei UserReadings}} (dieser {{Link2Forum|Topic=26300|Message=1246090|LinkText=Beitrag}}) ist bezüglich dieses Punktes eher irreführend.
+Man sieht den Effekt z.B. in einer Simulation mit den folgenden zwei Test-Devices:
 --[[Benutzer:Alkazaa|Alkazaa]] ([[Benutzer Diskussion:Alkazaa|Diskussion]]) 07:43, 20. Jul. 2026 (CEST)

UserReadings

Alkazaa — Tue, 21 Jul 2026 09:42:32 GMT

Integralfunktion - integral

← Nächstältere Version		Version vom 21. Juli 2026, 11:42 Uhr
Zeile 41:		Zeile 41:

	==== Integralfunktion - integral ====		==== Integralfunktion - integral ====
	Die Verwendung der Integralfunktion bei ''userReadings'' ist ausführlich im Forenbeitrag {{Link2Forum\|Topic=26300\|Message=193084\|LinkText=Integralfunktion bei UserReadings}} erklärt.		Die Verwendung der Integralfunktion bei ''userReadings'' ist ausführlich im Forenbeitrag {{Link2Forum\|Topic=26300\|Message=193084\|LinkText=Integralfunktion bei UserReadings}} erklärt. (Hinweis: Beim Bilden der Summe kann die Benutzung von event-on-change-reading zu falschen Ergebnissen führen.)

	==== Trigger ====		==== Trigger ====

Diskussion:UserReadings

Alkazaa — Mon, 20 Jul 2026 08:19:17 GMT

Hinweis bei 'integral'

← Nächstältere Version		Version vom 20. Juli 2026, 10:19 Uhr
(Eine dazwischenliegende Version desselben Benutzers wird nicht angezeigt)
Zeile 42:		Zeile 42:

	Grüße, [[Benutzer:Stephan\|Stephan]] ([[Benutzer Diskussion:Stephan\|Diskussion]]) 06:33, 29. Dez. 2017 (CET)		Grüße, [[Benutzer:Stephan\|Stephan]] ([[Benutzer Diskussion:Stephan\|Diskussion]]) 06:33, 29. Dez. 2017 (CET)

			<HR>
			== Hinweis bei 'integral' ==
			Der Passus ''(Hinweis: Beim Bilden der Summe kann die Benutzung von event-on-change-reading zu falschen Ergebnissen führen.)'' in der Sektion "Trigger" sollte auch bei "Integralfunktion - integral" stehen.

			Der Fehler ist in der Praxis sehr klein, da rauschbehaftete Messwerte praktisch immer ein event-on-change auslösen. Mir fiel er bei einer Datenquelle auf, die ich (aus anderen Gründen) künstlich in der Auflösung begrenzt hatte.

			Konkretes Beispiel: Bei einem Abtastintervall dt und drei aufeinander folgenden Messwerten a,a,b ist der Beitrag zum Integral dt(a+a)/2 beim trigger auf das zweite a und dt(a + b)/2 beim Trigger auf das b, insgesamt also dt(3a+b)/2. Fehlt der trigger auf das zweite a, kommt beim trigger auf das b als gesamter Beitrag 2dt(a+b)/2 = dt(2a+2b)/2.

			Die Diskussion im Forumsthread {{Link2Forum\|Topic=26300\|LinkText=Integralfunktion bei UserReadings}} (dieser {{Link2Forum\|Topic=26300\|Message=1246090\|LinkText=Beitrag}}) ist bezüglich dieses Punktes eher irreführend.

			--[[Benutzer:Alkazaa\|Alkazaa]] ([[Benutzer Diskussion:Alkazaa\|Diskussion]]) 07:43, 20. Jul. 2026 (CEST)

Micropelt iTRV Kleinstellantrieb

Cwagner — Mon, 06 Jul 2026 17:01:42 GMT

Komplettierung der Attribude rund um den summerMode

← Nächstältere Version		Version vom 6. Juli 2026, 19:01 Uhr
Zeile 155:		Zeile 155:
	\|destinationID\|\|unicast\|\|\|\|		\|destinationID\|\|unicast\|\|\|\|
	\|-		\|-
	\|eep\|\|A5-20-01\|\|\|\|MVA-002 bis MVA-004; beim MVA-005 A5-20-06		\|eep\|\|A5-20-01\|\|\|\|MVA-002 bis MVA-004; beim MVA-005: '''A5-20-06'''
	\|-		\|-
	\|manufID\|\|049\|\|\|\|		\|manufID\|\|049\|\|\|\|
Zeile 188:		Zeile 188:
	\|subType\|\|hvac.01\|\|\|\|bei MVA-002 bis MVA-004: hvac.01; ab MVA-005: hvac.06		\|subType\|\|hvac.01\|\|\|\|bei MVA-002 bis MVA-004: hvac.01; ab MVA-005: hvac.06
	\|-		\|-
	\|summerMode\|\|off\|\|\|\|		\|summerMode\|\|off\|\|on off auto\|\|über dieses Attribut kann das Gerät in einen stromsparenden Sommerbetrieb versetzt werden; siehe auch die folgenden beiden Attribute, die den Wechsel automatisieren, wenn "'''auto'''" gewählt ist
			\|-
			\|summerModeTempRefDev
			\|
			\|<device>[:<reading name>]
			\|wenn kein Readingname angegeben ist, wird temperature angenommen
			in Verbindung mit summerMode '''auto''' und dem nachfolgenden Attribut ist damit eine automatische Umschaltung in den stromsparenden Sommermode zu realisieren.
			\|-
			\|summerModeTempTreshold
			\|
			\|5...30
			\|°C. Der Modulautor weist darauf hin, dass am besten ein gemittelter Wert genommen werden sollten, damit nicht ständig hin- und hergeschaltet wird.
			Um "vorausschauend" zu heizen, kann auch die Tagesmitteltemperatur vom DVD (Tm) eventuell auch über die nächsten n Tage (fernere Tage auch geringer gewichtet) gemittelt verwendet werden.
	\|-		\|-
	\|teachMethod\|\|4BS\|\|\|\|		\|teachMethod\|\|4BS\|\|\|\|

FHEMWEB/Gauge

Schwatter — Sun, 05 Jul 2026 06:41:22 GMT

← Nächstältere Version		Version vom 5. Juli 2026, 08:41 Uhr
Zeile 20:		Zeile 20:

	=== 1️⃣ Widget im Device einrichten ===		=== 1️⃣ Widget im Device einrichten ===
	Die Einrichtung erfolgt über das Attribut `widgetOverride`.		Die Einrichtung erfolgt über das Attribut `webCmd` und `widgetOverride`.
			<syntaxhighlight lang="Perl">
	:<~~code~~>attr <devicename> widgetOverride cmd<X>:gauge,<Reading>,<Einheit>,<Min>,<Max>,<Farbe/Modus>,<Skalierung></~~code~~>		attr <devicename> webCmd cmd<X>
			attr <devicename> widgetOverride cmd<X>:gauge,<Reading>,<Einheit>,<Min>,<Max>,<Farbe/Modus>,<Skalierung>
			</syntaxhighlight>

	=== 2️⃣ Parameter ===		=== 2️⃣ Parameter ===
Zeile 50:		Zeile 52:

	=== 1️⃣ Widget im Device einrichten ===		=== 1️⃣ Widget im Device einrichten ===
	:<~~code~~>attr <devicename> widgetOverride cmd<X>:multigauge,<Ring1>,<Ring2>,<Ring3>,<Label>,<Skalierung></~~code~~>		Die Einrichtung erfolgt über das Attribut `webCmd` und `widgetOverride`.
			<syntaxhighlight lang="Perl">
			attr <devicename> webCmd cmd<X>
			attr <devicename> widgetOverride cmd<X>:multigauge,<Ring1>,<Ring2>,<Ring3>,<Label>,<Skalierung>
			</syntaxhighlight>

	=== 2️⃣ Parameter ===		=== 2️⃣ Parameter ===

FHEMWEB/MiniChart

Schwatter — Sun, 05 Jul 2026 06:28:32 GMT

← Nächstältere Version		Version vom 5. Juli 2026, 08:28 Uhr
Zeile 3:		Zeile 3:
	Das MiniChart-Widget visualisiert Messwertverläufe als kompaktes Liniendiagramm oder Balkendiagramm für die Darstellung im [[FHEMWEB]] ([[PGM2]]) Frontend.		Das MiniChart-Widget visualisiert Messwertverläufe als kompaktes Liniendiagramm oder Balkendiagramm für die Darstellung im [[FHEMWEB]] ([[PGM2]]) Frontend.
	Zusätzlich zeigt es drei aktuelle Werte, die aus Label, Reading und Einheit bestehen. Zum Einrichten sind drei Schritte notwendig.		Zusätzlich zeigt es drei aktuelle Werte, die aus Label, Reading und Einheit bestehen. Zum Einrichten sind drei Schritte notwendig.







	=== Hilfe ===		=== Hilfe ===
	* Forenthread zum {{Link2Forum\|Topic=141857\|LinkText=MiniChart Widget}}		* Forenthread zum {{Link2Forum\|Topic=141857\|LinkText=MiniChart Widget}}



	== 1️⃣ 99_myUtils.pm – Hilfsfunktion zum Speichern von historischen Werten ==		== 1️⃣ 99_myUtils.pm – Hilfsfunktion zum Speichern von historischen Werten ==

FHEMWEB/Gauge

Schwatter — Sun, 05 Jul 2026 06:27:06 GMT

← Nächstältere Version		Version vom 5. Juli 2026, 08:27 Uhr
(2 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 3:		Zeile 3:

	Die '''Gauge-Widgets''' visualisieren einen einzelnen oder mehrere numerische Werte als bogenförmige Instrumente im [[FHEMWEB]] ([[PGM2]]) Frontend. Die Farbe der Fortschrittsbögen passt sich dabei dynamisch an (Hue-Farbverlauf) oder bleibt statisch. Zudem werden Alarm-Grenzwerte unterstützt, die bei Unter- oder Überschreitung einen visuellen Pulse-Effekt auslösen.		Die '''Gauge-Widgets''' visualisieren einen einzelnen oder mehrere numerische Werte als bogenförmige Instrumente im [[FHEMWEB]] ([[PGM2]]) Frontend. Die Farbe der Fortschrittsbögen passt sich dabei dynamisch an (Hue-Farbverlauf) oder bleibt statisch. Zudem werden Alarm-Grenzwerte unterstützt, die bei Unter- oder Überschreitung einen visuellen Pulse-Effekt auslösen.





	=== Hilfe ===		=== Hilfe ===
	* Forenthread zum {{Link2Forum\|Topic=145001\|LinkText= Gauge-Widgets}}		* Forenthread zum {{Link2Forum\|Topic=145001\|LinkText= Gauge-Widgets}}





	== gauge – Bogen-Widget für Einzelwerte ==		== gauge – Bogen-Widget für Einzelwerte ==

	Das '''gauge'''-Widget visualisiert einen einzelnen numerischen Wert als bogenförmiges Instrument~~. Die Farbe des Fortschrittsbogens passt sich dynamisch an (Hue-Farbverlauf) oder bleibt statisch. Zudem werden Alarm-Grenzwerte unterstützt, die bei Überschreitung einen Pulse-Effekt auslösen~~.		Das '''gauge'''-Widget visualisiert einen einzelnen numerischen Wert als bogenförmiges Instrument.

	=== 1️⃣ Widget im Device einrichten ===		=== 1️⃣ Widget im Device einrichten ===
Zeile 36:		Zeile 44:
	</syntaxhighlight>		</syntaxhighlight>

	~~---~~

	== multigauge – Mehrfach-Bogen-Widget ==		== multigauge – Mehrfach-Bogen-Widget ==
Zeile 45:		Zeile 52:
	:<code>attr <devicename> widgetOverride cmd<X>:multigauge,<Ring1>,<Ring2>,<Ring3>,<Label>,<Skalierung></code>		:<code>attr <devicename> widgetOverride cmd<X>:multigauge,<Ring1>,<Ring2>,<Ring3>,<Label>,<Skalierung></code>

	=== 2️⃣ Parameter~~-Syntax der Ringe~~ ===		=== 2️⃣ Parameter ===
	~~Jeder~~ Bogen ~~folgt dem Schema~~: <code>Reading:Einheit:Farbe:Min-Max-AlarmMin-AlarmMax</code>		{\| class="wikitable"
			! Parameter !! Beschreibung
			\|-
			\| <code>Ring 1-3</code> \|\| Definition pro Bogen: <code>Reading:Einheit:Farbe:Min-Max-AlarmMin-AlarmMax</code>
			\|-
			\| <code>Farbe</code> \|\| Farbwert (z.B. #ff0000) ODER Hue-Modus: <code>hue-start-ende</code> (z.B. <code>hue-240-0</code>).
			\|-
			\| <code>Limits</code> \|\| Min-Max-AlarmMin-AlarmMax (Werte mit <code>none</code> deaktivierbar).
			\|-
			\| <code>Label</code> \|\| Beschriftung für das gesamte Widget.
			\|-
			\| <code>Skalierung</code> \|\| Optional: Skalierungsfaktor (Standard: 1.0).
			\|}

	* '''Reading''': Name des FHEM-Readings.		=== 3️⃣ Beispiel ===
	* '''Einheit''': Text (z.B. °C, %).
	* '''Farbe''': Hex-Code oder HUE-Bereich <code>hue-START-ENDE</code> (z.B. <code>hue-240-0</code>).
	* '''Limits''': Min-Max-AlarmMin-AlarmMax (Werte mit <code>none</code> deaktivierbar).

	~~=== 3️⃣ Beispiel ===~~		Alle Ringe aktiviert
	<syntaxhighlight lang="Perl">		<syntaxhighlight lang="Perl">
	attr <device> widgetOverride cmd:multigauge,humidity:%:hue-0-240:0-100-29-61,temperature:°C:hue-240-0:0-35-none-none,ppm:ppm:hue-120-0:0-5000-none-1401,Keller,1.1		attr <device> widgetOverride cmd:multigauge,humidity:%:hue-0-240:0-100-29-61,temperature:°C:hue-240-0:0-35-none-none,ppm:ppm:hue-120-0:0-5000-none-1401,Keller,1.1
	</syntaxhighlight>		</syntaxhighlight>

	=~~= Hinweise ==~~		Ein Ring aktiviert
	* Nicht benötigte Alarme im `multigauge~~` auf `~~none~~` setzen.~~		<syntaxhighlight lang="Perl">
	* Nach dem Update der JS-~~Dateien bitte den Browser~~-~~Cache leeren (z.B~~. ~~<code>Strg + F5~~</~~code~~>).		attr <device> widgetOverride cmd:multigauge,none,temperature:°C:hue-240-0:0-35-none-none,none,Balkon,1.0
			</syntaxhighlight>


	== Links ==		== Links ==

KNXIO

Erwin111 — Sun, 05 Jul 2026 04:28:48 GMT

Matrix - Modes<->Produkte

← Nächstältere Version		Version vom 5. Juli 2026, 06:28 Uhr
(Eine dazwischenliegende Version desselben Benutzers wird nicht angezeigt)
Zeile 107:		Zeile 107:
	\|M H		\|M H
	\|kein support im secure Mode - H untested		\|kein support im secure Mode - H untested
			\|-
			\|Busware TUL (ESP32-C3) und
			TUL32 (ESP32-C6) mit ip4knx Firmware
			\|H M
			\|<code>bis zu 10 Tunnel. Für WLAN Unicast-Tunneling (Mode H) empfohlen statt Multicast (Mode M).</code>
			Details siehe [https://github.com/tostmann/ip4knx/blob/main/README.md ip4knx readme]

			Kein knxd nötig!
	\|-		\|-
	\|		\|

FHEMWEB/Gauge

Schwatter — Sat, 04 Jul 2026 20:01:23 GMT

← Nächstältere Version		Version vom 4. Juli 2026, 22:01 Uhr
Zeile 11:		Zeile 11:
	Das '''gauge'''-Widget visualisiert einen einzelnen numerischen Wert als bogenförmiges Instrument. Die Farbe des Fortschrittsbogens passt sich dynamisch an (Hue-Farbverlauf) oder bleibt statisch. Zudem werden Alarm-Grenzwerte unterstützt, die bei Überschreitung einen Pulse-Effekt auslösen.		Das '''gauge'''-Widget visualisiert einen einzelnen numerischen Wert als bogenförmiges Instrument. Die Farbe des Fortschrittsbogens passt sich dynamisch an (Hue-Farbverlauf) oder bleibt statisch. Zudem werden Alarm-Grenzwerte unterstützt, die bei Überschreitung einen Pulse-Effekt auslösen.

	=== 1️⃣ ~~Widget-Datei aus contrib laden ===~~		=== 1️⃣ Widget im Device einrichten ===
	~~<syntaxhighlight lang="Perl">~~
	~~{ Svn_GetFile('contrib/fhemweb_gauge.js', 'www/pgm2/fhemweb_gauge.js') }~~
	~~</syntaxhighlight>~~

	~~=== 2️⃣~~ Widget im Device einrichten ===
	Die Einrichtung erfolgt über das Attribut `widgetOverride`.		Die Einrichtung erfolgt über das Attribut `widgetOverride`.

	:<code>attr <devicename> widgetOverride cmd<X>:gauge,<Reading>,<Einheit>,<Min>,<Max>,<Farbe/Modus>,<Skalierung></code>		:<code>attr <devicename> widgetOverride cmd<X>:gauge,<Reading>,<Einheit>,<Min>,<Max>,<Farbe/Modus>,<Skalierung></code>

	=== Parameter ===		=== 2️⃣ Parameter ===
	{\| class="wikitable"		{\| class="wikitable"
	! Parameter !! Beschreibung		! Parameter !! Beschreibung
Zeile 36:		Zeile 31:
	\|}		\|}

	=== Beispiel ===		=== 3️⃣ Beispiel ===
	<syntaxhighlight lang="Perl">		<syntaxhighlight lang="Perl">
	attr <device> widgetOverride cmd1:gauge,kWh,kWh,0,10000,hue:0:120:3000:none,1.3		attr <device> widgetOverride cmd1:gauge,kWh,kWh,0,10000,hue:0:120:3000:none,1.3
Zeile 47:		Zeile 42:
	Das '''multigauge'''-Widget erlaubt die Anzeige von bis zu drei Werten in konzentrischen Bögen. Jedes Reading ist individuell konfigurierbar (Einheit, Farbverlauf, Alarmgrenzen).		Das '''multigauge'''-Widget erlaubt die Anzeige von bis zu drei Werten in konzentrischen Bögen. Jedes Reading ist individuell konfigurierbar (Einheit, Farbverlauf, Alarmgrenzen).

	=== 1️⃣ ~~Widget-Datei aus contrib laden ===~~		=== 1️⃣ Widget im Device einrichten ===
	~~<syntaxhighlight lang="Perl">~~
	~~{ Svn_GetFile('contrib/fhemweb_multigauge.js', 'www/pgm2/fhemweb_multigauge.js') }~~
	~~</syntaxhighlight>~~

	~~=== 2️⃣~~ Widget im Device einrichten ===
	:<code>attr <devicename> widgetOverride cmd<X>:multigauge,<Ring1>,<Ring2>,<Ring3>,<Label>,<Skalierung></code>		:<code>attr <devicename> widgetOverride cmd<X>:multigauge,<Ring1>,<Ring2>,<Ring3>,<Label>,<Skalierung></code>

	=== Parameter-Syntax der Ringe ===		=== 2️⃣ Parameter-Syntax der Ringe ===
	Jeder Bogen folgt dem Schema: <code>Reading:Einheit:Farbe:Min-Max-AlarmMin-AlarmMax</code>		Jeder Bogen folgt dem Schema: <code>Reading:Einheit:Farbe:Min-Max-AlarmMin-AlarmMax</code>

Zeile 63:		Zeile 53:
	* '''Limits''': Min-Max-AlarmMin-AlarmMax (Werte mit <code>none</code> deaktivierbar).		* '''Limits''': Min-Max-AlarmMin-AlarmMax (Werte mit <code>none</code> deaktivierbar).

	=== Beispiel ===		=== 3️⃣ Beispiel ===
	<syntaxhighlight lang="Perl">		<syntaxhighlight lang="Perl">
	attr <device> widgetOverride cmd:multigauge,humidity:%:hue-0-240:0-100-29-61,temperature:°C:hue-240-0:0-35-none-none,ppm:ppm:hue-120-0:0-5000-none-1401,Keller,1.1		attr <device> widgetOverride cmd:multigauge,humidity:%:hue-0-240:0-100-29-61,temperature:°C:hue-240-0:0-35-none-none,ppm:ppm:hue-120-0:0-5000-none-1401,Keller,1.1

FHEMWEB/ControlMiniDash

Schwatter — Sat, 04 Jul 2026 08:56:28 GMT

Links

← Nächstältere Version		Version vom 4. Juli 2026, 10:56 Uhr
(Eine dazwischenliegende Version desselben Benutzers wird nicht angezeigt)
(kein Unterschied)

FHEMWEB/iconAnimated

Schwatter — Sat, 04 Jul 2026 08:53:07 GMT

← Nächstältere Version		Version vom 4. Juli 2026, 10:53 Uhr
Zeile 6:		Zeile 6:

	Neben inline eingebetteten SVGs werden auch '''FHEM-Icons direkt unterstützt''' (Attribut <code>icon</code>).		Neben inline eingebetteten SVGs werden auch '''FHEM-Icons direkt unterstützt''' (Attribut <code>icon</code>).

			=== Wichtig: Wenn das Widget z. B. mit einem Minichart oder Gauge kombiniert wird, muss es sowohl in cmd als auch in widgetOverride immer als Letztes definiert werden. Andernfalls entstehen Inkompatibilitäten. ===

	=== Hilfe ===		=== Hilfe ===

FHEMWEB/Gauge

Schwatter — Sat, 04 Jul 2026 08:40:17 GMT

← Nächstältere Version		Version vom 4. Juli 2026, 10:40 Uhr
Zeile 4:		Zeile 4:
	Die '''Gauge-Widgets''' visualisieren einen einzelnen oder mehrere numerische Werte als bogenförmige Instrumente im [[FHEMWEB]] ([[PGM2]]) Frontend. Die Farbe der Fortschrittsbögen passt sich dabei dynamisch an (Hue-Farbverlauf) oder bleibt statisch. Zudem werden Alarm-Grenzwerte unterstützt, die bei Unter- oder Überschreitung einen visuellen Pulse-Effekt auslösen.		Die '''Gauge-Widgets''' visualisieren einen einzelnen oder mehrere numerische Werte als bogenförmige Instrumente im [[FHEMWEB]] ([[PGM2]]) Frontend. Die Farbe der Fortschrittsbögen passt sich dabei dynamisch an (Hue-Farbverlauf) oder bleibt statisch. Zudem werden Alarm-Grenzwerte unterstützt, die bei Unter- oder Überschreitung einen visuellen Pulse-Effekt auslösen.

	---		=== Hilfe ===
			* Forenthread zum {{Link2Forum\|Topic=145001\|LinkText= Gauge-Widgets}}

	== gauge – Bogen-Widget für Einzelwerte ==		== gauge – Bogen-Widget für Einzelwerte ==

FHEMWEB/Widgets

Schwatter — Sat, 04 Jul 2026 08:32:58 GMT

← Nächstältere Version		Version vom 4. Juli 2026, 10:32 Uhr
Zeile 155:		Zeile 155:
	<br clear=all>[[Datei:AnimatedSVG.gif\|mini\|rechts]]		<br clear=all>[[Datei:AnimatedSVG.gif\|mini\|rechts]]
	* Wiki Seite zu [[FHEMWEB/iconAnimated\| iconAnimated Widget]] (Bild drücken für Gif)		* Wiki Seite zu [[FHEMWEB/iconAnimated\| iconAnimated Widget]] (Bild drücken für Gif)
			<br clear=all>[[Datei:Gaugewidgets.png\|mini\|rechts]]
			* Wiki Seite zu [[FHEMWEB/Gauge\| Gauge-Widgets]]

	[[Kategorie:Code Snippets]]		[[Kategorie:Code Snippets]]

Datei:Gaugewidgets.png

Schwatter — Sat, 04 Jul 2026 08:31:02 GMT

Schwatter lud Datei:Gaugewidgets.png hoch

Neue Seite

FHEMWEB/Gauge

Schwatter — Sat, 04 Jul 2026 08:30:26 GMT

← Nächstältere Version		Version vom 4. Juli 2026, 10:30 Uhr
Zeile 1:		Zeile 1:
			[[Datei:gaugewidgets.png\|Mini\|rechts]]
	== Gauge – Bogen-Widgets für Werte ==		== Gauge – Bogen-Widgets für Werte ==

SolarForecast - Solare Prognose (PV Erzeugung) und Verbrauchersteuerung

300P — Sat, 04 Jul 2026 08:13:25 GMT

Umstellung auf Tabelle - V2.8.1 eingearbeitet

Änderungen zeigen

FHEMWEB/iconAnimated

Schwatter — Sat, 04 Jul 2026 08:05:52 GMT

← Nächstältere Version		Version vom 4. Juli 2026, 10:05 Uhr
Zeile 97:		Zeile 97:
	* PNG/JPG werden ignoriert.		* PNG/JPG werden ignoriert.
	* Fhemicons sind etwas zickig. Beispiel rotateLeft und das Icon "aurora".		* Fhemicons sind etwas zickig. Beispiel rotateLeft und das Icon "aurora".

			== Links ==
			* [[FHEMWEB/Widgets\|FHEMWEB Widgets]]

	[[Kategorie:Code Snippets]]		[[Kategorie:Code Snippets]]
	[[Kategorie:FHEM Frontends]]		[[Kategorie:FHEM Frontends]]

FHEMWEB/MiniChart

Schwatter — Sat, 04 Jul 2026 08:05:28 GMT

← Nächstältere Version		Version vom 4. Juli 2026, 10:05 Uhr
Zeile 147:		Zeile 147:
	\| line oder bar; Farben optional.		\| line oder bar; Farben optional.
	\|}		\|}

			== Links ==
			* [[FHEMWEB/Widgets\|FHEMWEB Widgets]]

	[[Kategorie:Code Snippets]]		[[Kategorie:Code Snippets]]
	[[Kategorie:FHEM Frontends]]		[[Kategorie:FHEM Frontends]]

FHEMWEB/ControlMiniDash

Schwatter — Sat, 04 Jul 2026 08:04:54 GMT

← Nächstältere Version		Version vom 4. Juli 2026, 10:04 Uhr
Zeile 190:		Zeile 190:

	siehe: [[KNX_Device_Definition_-_Beispiele#RaumThermostat_/_HeizungsAktor_mit_widget_controlminidash\| RaumThermostat_/_HeizungsAktor_mit_widget_controlminidash]]		siehe: [[KNX_Device_Definition_-_Beispiele#RaumThermostat_/_HeizungsAktor_mit_widget_controlminidash\| RaumThermostat_/_HeizungsAktor_mit_widget_controlminidash]]

			== Links ==
			* [[FHEMWEB/Widgets\|FHEMWEB Widgets]]

	[[Kategorie:Code Snippets]]		[[Kategorie:Code Snippets]]
	[[Kategorie:FHEM Frontends]]		[[Kategorie:FHEM Frontends]]

FHEMWEB/Gauge

Schwatter — Sat, 04 Jul 2026 08:04:22 GMT

← Nächstältere Version		Version vom 4. Juli 2026, 10:04 Uhr
(Eine dazwischenliegende Version desselben Benutzers wird nicht angezeigt)
Zeile 69:		Zeile 69:
	* Nicht benötigte Alarme im `multigauge` auf `none` setzen.		* Nicht benötigte Alarme im `multigauge` auf `none` setzen.
	* Nach dem Update der JS-Dateien bitte den Browser-Cache leeren (z.B. <code>Strg + F5</code>).		* Nach dem Update der JS-Dateien bitte den Browser-Cache leeren (z.B. <code>Strg + F5</code>).

			== Links ==
			* [[FHEMWEB/Widgets\|FHEMWEB Widgets]]

	[[Kategorie:Code Snippets]]		[[Kategorie:Code Snippets]]
	[[Kategorie:FHEM Frontends]]		[[Kategorie:FHEM Frontends]]

FHEMWEB/Gauge

Schwatter — Sat, 04 Jul 2026 07:56:02 GMT

Die Seite wurde neu angelegt: „== Gauge – Bogen-Widgets für Werte == Die '''Gauge-Widgets''' visualisieren einen einzelnen oder mehrere numerische Werte als bogenförmige Instrumente im FHEMWEB (PGM2) Frontend. Die Farbe der Fortschrittsbögen passt sich dabei dynamisch an (Hue-Farbverlauf) oder bleibt statisch. Zudem werden Alarm-Grenzwerte unterstützt, die bei Unter- oder Überschreitung einen visuellen Pulse-Effekt auslösen. --- == gauge – Bogen-Widget für Einzelw…“

Neue Seite

== Gauge – Bogen-Widgets für Werte ==

Die '''Gauge-Widgets''' visualisieren einen einzelnen oder mehrere numerische Werte als bogenförmige Instrumente im [[FHEMWEB]] ([[PGM2]]) Frontend. Die Farbe der Fortschrittsbögen passt sich dabei dynamisch an (Hue-Farbverlauf) oder bleibt statisch. Zudem werden Alarm-Grenzwerte unterstützt, die bei Unter- oder Überschreitung einen visuellen Pulse-Effekt auslösen.

---

== gauge – Bogen-Widget für Einzelwerte ==

Das '''gauge'''-Widget visualisiert einen einzelnen numerischen Wert als bogenförmiges Instrument. Die Farbe des Fortschrittsbogens passt sich dynamisch an (Hue-Farbverlauf) oder bleibt statisch. Zudem werden Alarm-Grenzwerte unterstützt, die bei Überschreitung einen Pulse-Effekt auslösen.

=== 1️⃣ Widget-Datei aus contrib laden ===
<syntaxhighlight lang="Perl">
{ Svn_GetFile('contrib/fhemweb_gauge.js', 'www/pgm2/fhemweb_gauge.js') }
</syntaxhighlight>

=== 2️⃣ Widget im Device einrichten ===
Die Einrichtung erfolgt über das Attribut `widgetOverride`.

:<code>attr <devicename> widgetOverride cmd<X>:gauge,<Reading>,<Einheit>,<Min>,<Max>,<Farbe/Modus>,<Skalierung></code>

=== Parameter ===
{| class="wikitable"
! Parameter !! Beschreibung
|-
| <code>Reading</code> || Name des Readings, dessen Wert angezeigt wird.
|-
| <code>Einheit</code> || Anzeige-Einheit (z. B. kWh, %).
|-
| <code>Min / Max</code> || Start- und Endpunkt der Skala.
|-
| <code>Farbe/Modus</code> || Farbwert (z.B. #ff0000) ODER Hue-Modus: <code>hue:start:ende:alarmMin:alarmMax</code>
|-
| <code>Skalierung</code> || Optional: Skalierungsfaktor (Standard: 1.0).
|}

=== Beispiel ===
<syntaxhighlight lang="Perl">
attr <device> widgetOverride cmd1:gauge,kWh,kWh,0,10000,hue:0:120:3000:none,1.3
</syntaxhighlight>

---

== multigauge – Mehrfach-Bogen-Widget ==

Das '''multigauge'''-Widget erlaubt die Anzeige von bis zu drei Werten in konzentrischen Bögen. Jedes Reading ist individuell konfigurierbar (Einheit, Farbverlauf, Alarmgrenzen).

=== 1️⃣ Widget-Datei aus contrib laden ===
<syntaxhighlight lang="Perl">
{ Svn_GetFile('contrib/fhemweb_multigauge.js', 'www/pgm2/fhemweb_multigauge.js') }
</syntaxhighlight>

=== 2️⃣ Widget im Device einrichten ===
:<code>attr <devicename> widgetOverride cmd<X>:multigauge,<Ring1>,<Ring2>,<Ring3>,<Label>,<Skalierung></code>

=== Parameter-Syntax der Ringe ===
Jeder Bogen folgt dem Schema: <code>Reading:Einheit:Farbe:Min-Max-AlarmMin-AlarmMax</code>

* '''Reading''': Name des FHEM-Readings.
* '''Einheit''': Text (z.B. °C, %).
* '''Farbe''': Hex-Code oder HUE-Bereich <code>hue-START-ENDE</code> (z.B. <code>hue-240-0</code>).
* '''Limits''': Min-Max-AlarmMin-AlarmMax (Werte mit <code>none</code> deaktivierbar).

=== Beispiel ===
<syntaxhighlight lang="Perl">
attr <device> widgetOverride cmd:multigauge,humidity:%:hue-0-240:0-100-29-61,temperature:°C:hue-240-0:0-35-none-none,ppm:ppm:hue-120-0:0-5000-none-1401,Keller,1.1
</syntaxhighlight>

== Hinweise ==
* Nicht benötigte Alarme im `multigauge` auf `none` setzen.
* Nach dem Update der JS-Dateien bitte den Browser-Cache leeren (z.B. <code>Strg + F5</code>).

[[Kategorie:Code Snippets]]
[[Kategorie:FHEM Frontends]]

SolarForecast - Solare Prognose (PV Erzeugung) und Verbrauchersteuerung

300P — Sat, 04 Jul 2026 07:30:07 GMT

Beispiel Sonderregistrierung (ab V2.0.0) einer Wärmepumpe: ON - OFF bei Heatpump möglich ab V2.8.1

← Nächstältere Version		Version vom 4. Juli 2026, 09:30 Uhr
Zeile 4.605:		Zeile 4.605:
	Reading:Einheit (W/kW) welches den aktuellen Energieverbrauch liefert. Die Angabe ist verpflichtend.		Reading:Einheit (W/kW) welches den aktuellen Energieverbrauch liefert. Die Angabe ist verpflichtend.

	~~Automatisch gesetzter~~ Eintrag ~~als~~ '''mode=mustNot'''		Eintrag '''mode=mustNot'''

	'''''ACHTUNG''' ~~- Dem~~ '''~~Verbrauchertyp~~ heatpump ~~wird immer mode=mustNot zugewiesen~~''' und ~~es sind weitere Besonderheiten~~ (s.og.) ~~zu beachten:~~''		'''''ACHTUNG:''' Bei dem Verbrauchertyp '''heatpump''' ist sicherzustellen, dass keine doppelte Regelung durch SolarForecast und die native Gerätesteuerung erfolgt. Daher sollte bei modulierenden Verbrauchern dieses Types der Eintrag genutzt werden. Ansonsten kann (ab V2.8.1) auch ein "can" oder "must" wie bei allen anderen Verbrauchertypen zur Einplanung / Steuerung durch Soöarforecast genutzt werden.''

	=== Beispiel Registrierung eines Shelly Devices ===		=== Beispiel Registrierung eines Shelly Devices ===

DUOFERN

Caldir65 — Fri, 03 Jul 2026 06:37:05 GMT

Kleinen Hinweis zur Installation am Ende eingefügt

← Nächstältere Version		Version vom 3. Juli 2026, 08:37 Uhr
Zeile 37:		Zeile 37:
	Das Duofern Gerät muss hierzu in den manuellen Modus und darf NICHT im Automatik Modus sein.		Das Duofern Gerät muss hierzu in den manuellen Modus und darf NICHT im Automatik Modus sein.
	:<code>set mein_DuoFern_Stick pair</code>		:<code>set mein_DuoFern_Stick pair</code>

			'''Hinweis''': Das Gerät läßt sich erst fernsteuern, wenn auch am Gerät mindestens der obere und der untere Stopp-Punkt eingestellt wurden.

	=== Links ===		=== Links ===
	* {{Link2Forum\|Topic=40076\|LinkText=Forenthema}}		* {{Link2Forum\|Topic=40076\|LinkText=Forenthema}}

SolarForecast - Solare Prognose (PV Erzeugung) und Verbrauchersteuerung

300P — Fri, 03 Jul 2026 06:19:59 GMT

Beispiel Sonderregistrierung (ab V2.0.0) einer Wärmepumpe: Nur Ergänzung "Setzen von Automode" ->> mode=mustNot - kein ON / OFF durch SF bei dem Consumertyp

← Nächstältere Version		Version vom 3. Juli 2026, 08:19 Uhr
Zeile 4.604:		Zeile 4.604:

	Reading:Einheit (W/kW) welches den aktuellen Energieverbrauch liefert. Die Angabe ist verpflichtend.		Reading:Einheit (W/kW) welches den aktuellen Energieverbrauch liefert. Die Angabe ist verpflichtend.

			Automatisch gesetzter Eintrag als '''mode=mustNot'''

			'''''ACHTUNG''' - Dem '''Verbrauchertyp heatpump wird immer mode=mustNot zugewiesen''' und es sind weitere Besonderheiten (s.og.) zu beachten:''

	=== Beispiel Registrierung eines Shelly Devices ===		=== Beispiel Registrierung eines Shelly Devices ===
Zeile 7.243:		Zeile 7.247:
	####>>> EM-Gesamtenergieflüsse der WP		####>>> EM-Gesamtenergieflüsse der WP
	type=heatpump		type=heatpump
	####>>> "Spezial"-Consumer !!!		####>>> "Spezial"-Consumer - keine ON/OFF-Schaltung des Consumer durch SF bei Typ heatpump möglich !!!
	power=2500		power=2500
	####>>> ich untertreibe hier immer etwas extra - es wird bei mir sehr wenig bis zu 3100 W verbraucht		####>>> ich untertreibe hier immer etwas extra - es wird bei mir sehr wenig bis zu 3100 W verbraucht

Solaranlage Komplettbeispiel Fronius BYD

Wds1957 — Wed, 01 Jul 2026 18:05:23 GMT

SolarForecast überarbeitet, Consumer hinzugefügt

← Nächstältere Version		Version vom 1. Juli 2026, 20:05 Uhr
Zeile 612:		Zeile 612:
	defmod Forecast SolarForecast		defmod Forecast SolarForecast
	attr Forecast DbLogExclude .*		attr Forecast DbLogExclude .*
	attr Forecast DbLogInclude LastHourPVforecast,LastHourPVreal,~~AllPVforecastsToEvent~~		attr Forecast DbLogInclude LastHourPVforecast,LastHourPVreal
	attr Forecast consumer01 MQTT2_evcc1 type=~~charger~~ power=~~0 exconfc~~=1 icon=electric_car_icon pcurr=loadpoints_1_chargePower :W		attr Forecast aiControl aiConActivate=1\
			aiConProfile=v1,active,pv,bev
			attr Forecast consumer01 MQTT2_evcc1\
			type=bev\
			aliasshort=KIA\
			evid=loadpoints_1_vehicleTitle:PE-SO-60E\
			batCap=15400\
			power=22000\
			targetSoC=100\
			currSoC=loadpoints_1_vehicleSoc\
			etotal=loadpoints_1_sessionEnergy:Wh\
			icon=electric_car_icon\
			pcurr=loadpoints_1_chargePower:W
			attr Forecast consumer02 pool.pump\
			type=noSchedule\
			aliasshort=Pool\
			power=670\
			icon=sani_pump\
			etotal=SENSOR_ENERGY_Total:Wh\
			pcurr=SENSOR_ENERGY_Power:W
			attr Forecast ctrlDebug none
	attr Forecast ctrlLanguage DE		attr Forecast ctrlLanguage DE
	attr Forecast ctrlNextHoursSoCForecastReadings 07,08,09,10,11,12,13,14,15,16,17,18,19,20,21		attr Forecast ctrlNextHoursSoCForecastReadings 05,06,07,08,09,10,11,12,13,14,15,16,17,18,19,20,21,22
	attr Forecast ctrlSpecialReadings BatPowerIn_Sum,BatPowerOut_Sum,conForecastTillNextSunrise,dayAfterTomorrowPVforecast,todayConsumption,todayConsumptionForecast,todayConsumptionForecastDay,todayGridConsumption,todayGridFeedIn,tomorrowConsumptionForecast		attr Forecast ctrlSpecialReadings BatPowerIn_Sum,BatPowerOut_Sum,conForecastTillNextSunrise,dayAfterTomorrowPVforecast,todayConForecastTillSunset,todayConsumption,todayConsumptionForecast,todayConsumptionForecastDay,todayGridConsumption,todayGridFeedIn,tomorrowConsumptionForecast
			attr Forecast ctrlUserExitFn {\
			my $pvfc = ReadingsNum ($name, 'RestOfDayPVforecast', 0);;\
			my $cofc = ReadingsNum ($name, 'RestOfDayConsumptionForecast', 0);;\
			my $diff = $pvfc - $cofc;;\
			storeReading ('userFn_estimated_surplus', $diff);;\
			}
	attr Forecast event-on-change-reading .*		attr Forecast event-on-change-reading .*
			attr Forecast graphicBeam3Content consumption
			attr Forecast graphicBeam4Content consumptionForecast
	attr Forecast graphicControl energyUnit=kWh headerDetail=all,pv		attr Forecast graphicControl energyUnit=kWh headerDetail=all,pv
	attr Forecast graphicHistoryHour 8		attr Forecast graphicHistoryHour 8
	attr Forecast graphicSelect ~~forecast~~		attr Forecast graphicSelect both
	attr Forecast graphicShowNight 01		attr Forecast graphicShowNight 01
	attr Forecast plantControl ~~showLink~~=1		attr Forecast plantControl genPVdeviation=continuously:reverse
	attr Forecast room Energie-Strom		attr Forecast room Energie-Strom
	attr Forecast setupBatteryDev01 PV_Batterie pin=BatteryChargeWatt:W pout=BatteryDischargeWatt:W ~~intotal=Summe_Ladung:kWh outtotal=Summe_Entladung:kWh~~ show=1 cap=12800 charge=BatteryChargePercent		attr Forecast setupBatteryDev01 PV_Batterie\
	attr Forecast setupInverterDev01 Fronius_Symo pvOut=PowerFlow_Site_P_PV:W etotal=User_Produced_FPV:kWh capacity=~~11000~~ strings:Ostseite,Suedseite		pin=BatteryChargeWatt:W\
	attr Forecast setupInverterDev02 Fronius_Symo pvOut=Meter_1_PowerReal_P_Sum:W etotal=Meter_1_EnergyReal_WAC_Sum_Produced:Wh capacity=4000 strings:Westseite,GH_Ost,GH_West		pout=BatteryDischargeWatt:W\
			show=1\
			cap=12800\
			label=below\
			charge=BatteryChargePercent
			attr Forecast setupInverterDev01 Fronius_Symo\
			pvOut=PowerFlow_Site_P_PV:W\
			etotal=User_Produced_FPV:kWh\
			capacity=10000\
			strings=Ostseite,Suedseite
			attr Forecast setupInverterDev02 Fronius_Symo\
			pvOut=Meter_1_PowerReal_P_Sum:W\
			etotal=Meter_1_EnergyReal_WAC_Sum_Produced:Wh\
			capacity=4000\
			strings=Westseite,GH_Ost,GH_West
	attr Forecast setupInverterStrings Suedseite,Westseite,Ostseite,GH_West,GH_Ost		attr Forecast setupInverterStrings Suedseite,Westseite,Ostseite,GH_West,GH_Ost
	attr Forecast setupMeterDev Fronius_Symo gcon=Bezug:W contotal=Meter_0_EnergyReal_WAC_Plus_Absolute:Wh gfeedin=Einspeisung feedtotal=Meter_0_EnergyReal_WAC_Minus_Absolute:Wh conprice=~~powerCost~~:€ feedprice=0.083:€		attr Forecast setupMeterDev Fronius_Symo\
			gcon=Bezug:W\
			contotal=Meter_0_EnergyReal_WAC_Plus_Absolute:Wh\
			gfeedin=Einspeisung:W\
			feedtotal=Meter_0_EnergyReal_WAC_Minus_Absolute:Wh\
			conprice=0.30:€\
			feedprice=0.083:€
	attr Forecast setupRadiationAPI OpenMeteoDWD_D2-API		attr Forecast setupRadiationAPI OpenMeteoDWD_D2-API
	attr Forecast setupStringAzimuth Suedseite=0 Westseite=90 Ostseite=-90 GH_Ost=-90 GH_West=90		attr Forecast setupStringAzimuth Suedseite=0 Westseite=90 Ostseite=-90 GH_Ost=-90 GH_West=90
Zeile 634:		Zeile 682:
	attr Forecast setupStringPeak Suedseite=7.66 Westseite=2.2 Ostseite=3.48 GH_Ost=1.74 GH_West=0.58		attr Forecast setupStringPeak Suedseite=7.66 Westseite=2.2 Ostseite=3.48 GH_Ost=1.74 GH_West=0.58
	attr Forecast setupWeatherDev1 OpenMeteoDWD_D2-API		attr Forecast setupWeatherDev1 OpenMeteoDWD_D2-API
	attr Forecast verbose 0		attr Forecast userReadings .jsonReading:nextCycletime.* { main::forecast_json($NAME) }
			attr Forecast verbose 1
	</pre>		</pre>
	</div>		</div>

SolarForecast - Solare Prognose (PV Erzeugung) und Verbrauchersteuerung

Ph1959de — Mon, 29 Jun 2026 18:18:14 GMT

syntaxhighlight-Fehler behoben

Änderungen zeigen

Mini-Dashboard für PV-Anlage

Ph1959de — Mon, 29 Jun 2026 18:14:13 GMT

syntaxhighlight-Fehler behoben, Kategorie eingefügt und Seite teilweise wikifiziert (könnte beides noch erweitert werden)

← Nächstältere Version		Version vom 29. Juni 2026, 20:14 Uhr
Zeile 5:		Zeile 5:

	== Komponenten ==		== Komponenten ==

	=== Übersicht ===		=== Übersicht ===
	Das Dashboard wird als JPG-Bild mit dem Modul RSS on-the-fly erstellt. Ein at-Kommando ruft jede Minute ein Bild vom Modul ab und schiebt es über eine Perl-Funktion auf das GIFTV. Das GIFTV arbeitet dabei mit seiner Standard-Firmware im Bilderalbum-Modus.		Das Dashboard wird als JPG-Bild mit dem Modul RSS on-the-fly erstellt. Ein at-Kommando ruft jede Minute ein Bild vom Modul ab und schiebt es über eine Perl-Funktion auf das GIFTV. Das GIFTV arbeitet dabei mit seiner Standard-Firmware im Bilderalbum-Modus.
Zeile 12:		Zeile 11:

	=== readingsProxy ===		=== readingsProxy ===

	==== Einleitung ====		==== Einleitung ====
	Der readingsProxy wird benötigt, um aus verschiedenen Geräten Werte zusammenzuziehen, diese verständlich zu benennen, und weitere Werte mit userReadings zu berechnen.		Der [[readingsProxy]] wird benötigt, um aus verschiedenen Geräten Werte zusammenzuziehen, diese verständlich zu benennen, und weitere Werte mit userReadings zu berechnen.

	Ich möchte im Mini-Dashboard gerne folgende Werte sehen:		Ich möchte im Mini-Dashboard gerne folgende Werte sehen:
Zeile 33:		Zeile 31:

	==== Definition ====		==== Definition ====

	Inspiration fand ich auf der Webseite [https://www.juergenstechnikwelt.de/photovoltaik/pv-anlage-in-fhem-die-datenbasis-fuer-das-dashboard/ Jürgens Technikwelt].		Inspiration fand ich auf der Webseite [https://www.juergenstechnikwelt.de/photovoltaik/pv-anlage-in-fhem-die-datenbasis-fuer-das-dashboard/ Jürgens Technikwelt].

	<syntaxhighlight lang="~~text~~">		<syntaxhighlight lang="Text">
	define aggr.PV readingsProxy \		define aggr.PV readingsProxy \
	smainverter:SPOT_PDC_SUM:PVPowerSourceW \		smainverter:SPOT_PDC_SUM:PVPowerSourceW \
Zeile 63:		Zeile 60:

	=== RSS ===		=== RSS ===

	==== Definition ====		==== Definition ====
			<syntaxhighlight lang="Text">
	<syntaxhighlight>define sensorfeed2 RSS jpg has-1.example.com /opt/fhem/conf/sensorfeed2.layout		define sensorfeed2 RSS jpg has-1.example.com /opt/fhem/conf/sensorfeed2.layout
	attr sensorfeed2 bg /opt/fhem/PictureFrame/sensorfeed2		attr sensorfeed2 bg /opt/fhem/PictureFrame/sensorfeed2
	attr sensorfeed2 size 240x240</code>		attr sensorfeed2 size 240x240</code>
Zeile 74:		Zeile 70:

	==== Layout ====		==== Layout ====

	Das Modul 98_DOIF.pm wird benötigt, damit RSS die darin enthaltenen Widgets verwenden kann. Wenn man kein DOIF benutzt, muss man das Modul mit <code>require 98_DOIF.pm</code> im Perl-Kode laden - das erfolgt unprätentiös in dem automatisch geladenen 99_GIFTV.pm.		Das Modul 98_DOIF.pm wird benötigt, damit RSS die darin enthaltenen Widgets verwenden kann. Wenn man kein DOIF benutzt, muss man das Modul mit <code>require 98_DOIF.pm</code> im Perl-Kode laden - das erfolgt unprätentiös in dem automatisch geladenen 99_GIFTV.pm.

Zeile 81:		Zeile 76:
	Datei: <code>/opt/fhem/conf/sensorfeed2.layout</code>		Datei: <code>/opt/fhem/conf/sensorfeed2.layout</code>

	<syntaxhighlight>		<syntaxhighlight lang="Perl">
	# ------------------		# ------------------
	# font		# font
Zeile 127:		Zeile 122:

	=== Bespielung des GIFTV ===		=== Bespielung des GIFTV ===

	==== at ====		==== at ====

	Der at-Befehl schiebt durch Aufruf von push2giftv() in Sekunde 1 jeder Minute das Bild vom RSS-Gerät sensorfeed2 auf zwei im Haus verteilte GIFTVs.		Der at-Befehl schiebt durch Aufruf von push2giftv() in Sekunde 1 jeder Minute das Bild vom RSS-Gerät sensorfeed2 auf zwei im Haus verteilte GIFTVs.

	<syntaxhighlight>		<syntaxhighlight lang="Text">
	define at.sensorfeed at +*00:01:00 { push2giftv( { "sensorfeed2" => ["giftv-1.example.com","giftv-3.example.com"] } ) }		define at.sensorfeed at +*00:01:00 { push2giftv( { "sensorfeed2" => ["giftv-1.example.com","giftv-3.example.com"] } ) }
	attr at.sensorfeed alignTime 01:01:01		attr at.sensorfeed alignTime 01:01:01
Zeile 138:		Zeile 131:

	==== push2giftv() ====		==== push2giftv() ====

	Es wird ein automatisch von FHEM geladenes Modul 99_GIFTV.pm mit folgendem Inhalt im Ordner FHEM (unter Linux üblicherweise <code>/opt/fhem/FHEM/99_GIFTV.pm</code>) bei den anderen Modulen angelegt:		Es wird ein automatisch von FHEM geladenes Modul 99_GIFTV.pm mit folgendem Inhalt im Ordner FHEM (unter Linux üblicherweise <code>/opt/fhem/FHEM/99_GIFTV.pm</code>) bei den anderen Modulen angelegt:

Zeile 186:		Zeile 178:
	Beispielaufruf, um mehrere Dashboards (sensorfeed1 und sensorfeed2) auf zwei GIFTVs zu schieben:		Beispielaufruf, um mehrere Dashboards (sensorfeed1 und sensorfeed2) auf zwei GIFTVs zu schieben:

	<syntaxhighlight>		<syntaxhighlight lang="Text">
	push2giftv( { "sensorfeed1" => ["giftv-1.example.com","giftv-3.example.com"], "sensorfeed2" => ["giftv-1.example.com","giftv-3.example.com"] } ) }		push2giftv( { "sensorfeed1" => ["giftv-1.example.com","giftv-3.example.com"], "sensorfeed2" => ["giftv-1.example.com","giftv-3.example.com"] } ) }
	</syntaxhighlight>		</syntaxhighlight>

	Das GIFTV zeigt dann die beiden Dashboards im Wechsel an.		Das GIFTV zeigt dann die beiden Dashboards im Wechsel an.

			[[Kategorie:Code Snippets]]

XiaomiDevice

Ph1959de — Mon, 29 Jun 2026 18:05:24 GMT

syntaxhighlight-Fehler behoben

← Nächstältere Version		Version vom 29. Juni 2026, 20:05 Uhr
Zeile 31:		Zeile 31:
	* Bei erfolgreichem Login erfolgt noch eine Server-Abfrage - drückt man hier nur die '''Enter'''-Taste, werden alle verfügbaren Server abgefragt. Als Ausgabe kommen entweder die Informationen der Geräte auf deinem Server, oder aber eine Fehlermeldung, daß auf dem entsprechenden Server kein Device existiert.		* Bei erfolgreichem Login erfolgt noch eine Server-Abfrage - drückt man hier nur die '''Enter'''-Taste, werden alle verfügbaren Server abgefragt. Als Ausgabe kommen entweder die Informationen der Geräte auf deinem Server, oder aber eine Fehlermeldung, daß auf dem entsprechenden Server kein Device existiert.

	Die Ausgabe sieht etwa so aus (in Auszügen):<syntaxhighlight>		Die Ausgabe sieht etwa so aus (in Auszügen):
			<syntaxhighlight lang="Text">
	Devices found for server "cn" @ home "42500110xxxx":		Devices found for server "cn" @ home "42500110xxxx":
	---------		---------
Zeile 93:		Zeile 94:

	== Installation ==		== Installation ==
	Das Modul ist seit 28.02.2018 ein offizielles Modul. Eine ~~separates~~ Installation ist nicht (mehr) notwendig.		Das Modul ist seit 28.02.2018 ein offizielles Modul. Eine separate Installation ist nicht (mehr) notwendig.

	== Definition ==		== Definition ==
Zeile 99:		Zeile 100:

	<code>attr Mi_Vacuum subType VacuumCleaner</code>		<code>attr Mi_Vacuum subType VacuumCleaner</code>

	== Besonderheiten einzelner Gerätetypen ==		== Besonderheiten einzelner Gerätetypen ==

	=== Saug-/Wischroboter ===		=== Saug-/Wischroboter ===
	{{Randnotiz\|RNTyp=g\|RNText=Einige detailliertere Informationen zu Saugrobotern sind derzeit noch auf der Seite [[Mi vacuum]] zu finden, sollten aber letztendlich hier integriert werden.}}		{{Randnotiz\|RNTyp=g\|RNText=Einige detailliertere Informationen zu Saugrobotern sind derzeit noch auf der Seite [[Mi vacuum]] zu finden, sollten aber letztendlich hier integriert werden.}}

Kategorie:FHEM Tablet UI V3

Ph1959de — Mon, 29 Jun 2026 17:48:42 GMT

Schreibweise vereinheitlicht

← Nächstältere Version		Version vom 29. Juni 2026, 19:48 Uhr
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.

FHEM Tablet UI v3

Ph1959de — Mon, 29 Jun 2026 17:47:55 GMT

Ph1959de verschob die Seite FHEM Tablet UI v3 nach FHEM Tablet UI V3, ohne dabei eine Weiterleitung anzulegen Falsch geschriebener Name

Neue Seite

#WEITERLEITUNG [[:Kategorie:FHEM Tablet UI V3]]

FHEM Tablet UI

Ph1959de — Mon, 29 Jun 2026 17:41:50 GMT

Seite wurde verschoben - Weiterleitung eingerichtet, um Links auf die Seite nicht ins Leere laufen zu lassen

← Nächstältere Version	Version vom 29. Juni 2026, 19:41 Uhr
Zeile 1:	Zeile 1:
		#WEITERLEITUNG [[FHEM Tablet UI V2]]

Mi vacuum

Caldir65 — Sun, 28 Jun 2026 07:02:01 GMT

Vorarbeiten am Smartphone (Token)

@@ Zeile 30: / Zeile 30: @@
 Wenn bei dem ein oder anderen Modul die Meldung kommt, dass es schon installiert ist, einfach mit dem nächsten Befehl weiter machen. Das CPAN Teil würde ich am Schluss machen, das braucht ziemlich lang zum installieren.
-===Vorarbeiten am Smartphone (Token)===
+Die Ermittlung des Tokens ist im  [[XiaomiDevice]] beschrieben.
 ===Installation des inoffiziellen Moduls===

XiaomiDevice

Caldir65 — Sun, 28 Jun 2026 07:00:47 GMT

Tokenermittlung eingefügt, Installation ergänzt

@@ Zeile 11: / Zeile 11: @@
 == Voraussetzungen ==
 Perl Libraries libjson-perl, libdigest-md5-perl, libcrypt-cbc-perl, libcrypt-ecb-perl (CPAN: Crypt::Cipher::AES oder Crypt::Rijndael_PP )
 == Installation ==
 == Definition ==
 == Besonderheiten einzelner Gerätetypen ==

Vitoconnect

Stefanru — Fri, 26 Jun 2026 16:02:26 GMT

mehrere Devices klarer

← Nächstältere Version		Version vom 26. Juni 2026, 18:02 Uhr
(7 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 47:		Zeile 47:
	Da die Parameter, die beim Definieren des Devices angelegt werden im Klartext in der Detailansicht lesbar sind, kann man beim Definieren einfach ein falsches Passwort eingeben und das richtige später mit einem "set"-Kommando setzen. Also zum Beispiel:		Da die Parameter, die beim Definieren des Devices angelegt werden im Klartext in der Detailansicht lesbar sind, kann man beim Definieren einfach ein falsches Passwort eingeben und das richtige später mit einem "set"-Kommando setzen. Also zum Beispiel:
	:<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br>		:<code>define vitoconnect vitoconnect user@mail.xx fakePassword 60</code><br>
	:<code>set vitoconnect password correctPassword 60</code>		:<code>set vitoconnect password correctPassword</code>

	Zusätzlich muss der apiKey gesetzt werden.		Zusätzlich muss der apiKey gesetzt werden.
Zeile 62:		Zeile 62:
	das Device auswählen, das FHEM abfragen soll.		das Device auswählen, das FHEM abfragen soll.

	Sollen mehrere Devices abgefragt werden, bitte mehrere FHEM vitoconnect Devices anlegen. ~~Hier bitte~~ das API Limit ~~von oben beachten~~.		Sollen mehrere Devices abgefragt werden, bitte mehrere FHEM vitoconnect Devices anlegen. Beachte dabei das API-Limit und die Intervall-Faustregel im Abschnitt [[#Betrieb\|Betrieb]].

	Zur nachträgliches Änderung des Intervalls kann das DEF aufgerufen und dort die Parameter korrigiert werden (z.B. von 60 Sek. auf 180 Sek.) - dies gilt natürlich ebenso für nachträgliches Ändern des Usernamens oder Passwortes.		Zur nachträgliches Änderung des Intervalls kann das DEF aufgerufen und dort die Parameter korrigiert werden (z.B. von 60 Sek. auf 180 Sek.) - dies gilt natürlich ebenso für nachträgliches Ändern des Usernamens oder Passwortes.

	=== Betrieb ===		=== Betrieb ===
	Der Zugriff auf die API von Viessmann ist aktuell auf 1450 pro Tag in der Gratisversion beschränkt, daraus ergibt sich ein Maximum von ca. einer Abfrage pro Minute. Die Anzahl der Zugriffe ist im Entwicklerportal einsehbar: https://developer.viessmann.com/de/clients/history (funktioniert Stand 02/2026 nicht mehr, eine "neue" Seite um die Anzahl der Zugriffe abzufragen ist (mir) nicht bekannt).		Der Zugriff auf die API von Viessmann ist aktuell auf '''1450 Calls pro Tag pro Account''' (apiKey) in der Gratisversion
			beschränkt, daraus ergibt sich ein Maximum von ca. einer Abfrage pro Minute pro Device.

			'''Hinweis bei mehreren Devices''': Bei mehreren FHEM vitoconnect Devices am selben apiKey teilen sich diese das 1450/Tag-Limit.
			Faustregel: bei 2 Devices nicht unter 120s Intervall pro Device, bei 3 Devices nicht unter 180s.

			Der aktuelle Verbrauch ist über zwei Wege einsehbar:
			* '''Im Viessmann Developer Portal''': https://app.developer.viessmann-climatesolutions.com/transactions (Login mit dem Developer-Account erforderlich)

			* '''Direkt im Modul''' (ab Version 1.1.6): Die Readings <code>apiCallsToday</code>, <code>apiCallsTodayAccount</code> und <code>apiQuotaUsedPercent</code> zeigen den Verbrauch live an. Siehe Abschnitt [[#Diagnose-Readings\|Diagnose-Readings]].
	== Readings ==		== Readings ==
	=== Mapping ===		=== Mapping ===
Zeile 95:		Zeile 103:

	Raw Readings müssen nicht erklärt werden; die Beschreibung der Datenpunkte kann hier bei Viessmann gefunden werden: https://api.viessmann-climatesolutions.com/documentation/data-points		Raw Readings müssen nicht erklärt werden; die Beschreibung der Datenpunkte kann hier bei Viessmann gefunden werden: https://api.viessmann-climatesolutions.com/documentation/data-points

			=== Diagnose-Readings ===

			Unabhängig vom gewählten Mapping erzeugt das Modul folgende Readings für Diagnose und Monitoring:

			==== API-Verbrauchszähler (ab v1.1.6) ====

			{\| class="wikitable"
			\|-
			! Reading !! Inhalt
			\|-
			\| apiCallsToday \|\| Anzahl erfolgreicher API-Calls seit Mitternacht für dieses Device (zählt Resource-Reads UND Set-Aktionen)
			\|-
			\| apiCallsLastDay \|\| Anzahl der API-Calls vom Vortag, beim Tageswechsel automatisch befüllt
			\|-
			\| apiCallsLastDay_date \|\| Datum zu dem apiCallsLastDay gehört (relevant bei FHEM-Downtime > 24h)
			\|-
			\| apiCallsTodayAccount \|\| Summe der apiCallsToday über alle vitoconnect-Devices mit gleichem apiKey. Wird nur befüllt wenn
			mindestens 2 Devices den gleichen apiKey nutzen.
			\|-
			\| apiQuotaUsedPercent \|\| Aktueller Verbrauch in Prozent vom 1450/Tag-Limit. Bei Multi-Device-Setups bezieht sich auf
			apiCallsTodayAccount, sonst auf apiCallsToday. Ab 80% erscheint eine Warnung im FHEM-Log.
			\|}

			Der Tageswechsel wird über die System-Uhrzeit erkannt (Mitternacht-Sprung), nicht über das Viessmann-eigene Sliding-Window. Das ist eine ausreichend genaue Näherung — wenn der Counter bei 100% ist, hat man die Quote auch wirklich verbraucht.

			==== Aktive Fehler (ab v1.1.5) ====

			{\| class="wikitable"
			\|-
			! Reading !! Inhalt
			\|-
			\| currentError \|\| Kommagetrennte Liste aller aktuell aktiven F-Codes aus <code>device.messages.errors.raw.entries</code>. Leer
			wenn keine F-Codes aktiv. Beispiel: <code>F.11,F.770</code>. Triggert FHEM-Events nur bei Wertänderung — geeignet als Auslöser für
			notify-Regeln.
			\|}

			Die ausführliche Fehlerliste mit Klartext steht weiterhin in <code>device.messages.errors.list</code> (Format: <code>DD.MM.YYYY
			HH:MM:SS - F.xxx - Volltext</code>).

	<div class="mw-collapsible mw-collapsed">		<div class="mw-collapsible mw-collapsed">
Zeile 359:		Zeile 406:
	\|clearReadings\|\| \|\|clear all readings immeadiatlely		\|clearReadings\|\| \|\|clear all readings immeadiatlely
	\|-		\|-
	\|clearMappedErrors		\|clearMappedErrors\|\| \|\|Löscht alle Readings die mit "device.messages.errors.mapped." beginnen. Nutzt man wenn die aufgelösten Fehlertexte (Code → Klartext) im Cache mal neu aufgebaut werden sollen — z.B. nach einem Sprachwechsel.
	\|
	\|~~clear all~~ mapped ~~errors immediately~~
	\|-		\|-
	\|password <passwd>\|\|String\|\|store password in key store		\|password <passwd>\|\|String\|\|store password in key store
Zeile 431:		Zeile 476:

	==Get==		==Get==
	~~Derzeit gibt es keine "get"-Kommandos.~~

	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-
	!Name!!Beschreibung		! Name !! Beschreibung
	\|-		\|-
	\| \|\|		\| html \|\| Liefert das Modul-SVG (z.B. Kältekreislauf bei Wärmepumpen, falls über Attribut
			<code>vitoconnect_showKaeltekreislauf</code> aktiviert) als HTML-Fragment zurück. Geeignet zur Einbindung in andere
			FHEM-Web-Devices.
			\|-
			\| ftui \|\| Identisch zu <code>html</code>, aber speziell für die Einbindung in [https://wiki.fhem.de/wiki/FHEM_Tablet_UI TabletUI]
			gedacht. Die SVG-Größe wird auf 100% gesetzt für responsive Darstellung.
	\|}		\|}

Zeile 503:		Zeile 551:
	\|		\|
	\|Setzt ein Timeout für den API-Aufruf.		\|Setzt ein Timeout für den API-Aufruf.
			\|-
			\| vitoconnect_showKaeltekreislauf \|\| 0,1 \|\| 0 \|\| Zeigt in der Detail-Ansicht des Devices ein SVG des Kältekreislaufs (nur bei Wärmepumpen sinnvoll). Wird auch von <code>get html</code> / <code>get ftui</code> ausgeliefert wenn aktiviert.
	\|}		\|}