FRITZBOX - Versionsgeschichte

0bones: /* Voraussetzungen */ Perl modul XML::Simple ergänzt

2026-03-29T10:21:54Z

Voraussetzungen: Perl modul XML::Simple ergänzt

← Nächstältere Version		Version vom 29. März 2026, 12:21 Uhr
Zeile 17:		Zeile 17:
	== Voraussetzungen ==		== Voraussetzungen ==
	=== Remote-Zugang ===		=== Remote-Zugang ===
	Für den Remote-Zugang müssen die Module JSON:XS, LWP und SOAP::Lite installiert sein; auf einem [[Raspberry Pi]] oder unter Ubuntu z. B. mit dem Befehl		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</code>		:<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.		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.

0bones: /* TR-064: Modul FRITZBOX für Zugriff auf einem externen Server einrichten */

2026-03-21T10:25:26Z

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

0bones: FRITZBOX durch FritzSmart ersetzt

2026-03-21T10:17:18Z

FRITZBOX durch FritzSmart ersetzt

← Nächstältere Version		Version vom 21. März 2026, 12:17 Uhr
Zeile 177:		Zeile 177:

	=== Anwesenheitserkennung über mehrere Fritzboxen oder AVM Repeater und Fritzbox ===		=== Anwesenheitserkennung über mehrere Fritzboxen oder AVM Repeater und Fritzbox ===
	Existiert ein AVM Repeater im Netzwerk, kann der als eigenständiges Gerät mit ~~FRITZBOX~~ 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 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 ~~FRITZBOX~~ Modul muss wegen der Anwesenheitserkennung nicht gemacht werden. Die folgende Routine kann aber universell eingesetzt werden, unabhängig von der Anzahl der ~~FRITZBOX~~ Instanzen. Wer mitloggen will, kann das analog zur obigen Routine einbauen		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($) {		<syntaxhighlight lang="perl">sub checkAllFritzMACpresent($) {
	# Benötigt: nur die zu suchende MAC ($MAC),		# Benötigt: nur die zu suchende MAC ($MAC),
	# Es werden alle Instanzen vom Type ~~FRITZBOX~~ abgefragt		# Es werden alle Instanzen vom Type FritzSmart abgefragt
	#		#
	# Rückgabe: 1 = Gerät gefunden		# Rückgabe: 1 = Gerät gefunden
Zeile 206:		Zeile 206:
	}</syntaxhighlight>		}</syntaxhighlight>

	Da hiermit nach allen Instanzen mit dem TYPE=~~FRITZBOX~~ durchsucht wird, braucht der Name der Fritzbox nicht angegeben werden.		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>		:<code>define <Name> PRESENCE function {checkAllFritzMACpresent("AA:BB:CC:DD:EE:FF")} 60 60</code>

JoWiemann am 20. März 2026 um 18:37 Uhr

2026-03-20T18:37:25Z

← Nächstältere Version		Version vom 20. März 2026, 20:37 Uhr
Zeile 192:		Zeile 192:
	$MAC =~ tr/:/_/;		$MAC =~ tr/:/_/;
	$MAC = "mac_".uc($MAC);		$MAC = "mac_".uc($MAC);
	my @FBS = devspec2array("TYPE=~~FRITZBOX~~");		my @FBS = devspec2array("TYPE=FritzSmart");
	foreach( @FBS ) {		foreach( @FBS ) {
	my $StatusFritz = ReadingsVal($_, $MAC, "weg");		my $StatusFritz = ReadingsVal($_, $MAC, "weg");

JoWiemann: /* Define */

2026-03-20T08:02:14Z

Define

← Nächstältere Version		Version vom 20. März 2026, 10:02 Uhr
Zeile 44:		Zeile 44:
	== Anwendung ==		== Anwendung ==
	=== Define ===		=== Define ===
	Siehe {{Link2CmdRef\|Lang=de\|Anker=FritzSmartdefine}}		Siehe {{Link2CmdRef\|Lang=de\|Anker=FritzSmartdefine}}

	=== Attribute ===		=== Attribute ===

JoWiemann: /* Define */

2026-03-20T07:59:15Z

Define

← Nächstältere Version		Version vom 20. März 2026, 09:59 Uhr
Zeile 44:		Zeile 44:
	== Anwendung ==		== Anwendung ==
	=== Define ===		=== Define ===
	Siehe {{Link2CmdRef\|Lang=de\|Anker=~~FitzSmart~~}}		Siehe {{Link2CmdRef\|Lang=de\|Anker=FritzSmartdefine}}

	=== Attribute ===		=== Attribute ===

JoWiemann: /* Define */

2026-03-20T07:57:09Z

Define

← Nächstältere Version		Version vom 20. März 2026, 09:57 Uhr
Zeile 44:		Zeile 44:
	== Anwendung ==		== Anwendung ==
	=== Define ===		=== Define ===
	Siehe {{Link2CmdRef\|Lang=de\|Anker=~~FitzSmartdefine~~}}		Siehe {{Link2CmdRef\|Lang=de\|Anker=FitzSmart}}

	=== Attribute ===		=== Attribute ===

JoWiemann am 20. März 2026 um 07:53 Uhr

2026-03-20T07:53:19Z

← Nächstältere Version		Version vom 20. März 2026, 09:53 Uhr
Zeile 11:		Zeile 11:
	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.		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.}}		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 ==

JoWiemann am 20. März 2026 um 07:50 Uhr

2026-03-20T07:50:59Z

← Nächstältere Version		Version vom 20. März 2026, 09:50 Uhr
Zeile 3:		Zeile 3:
	\|ModType=d		\|ModType=d
	\|ModForumArea=FRITZ!Box		\|ModForumArea=FRITZ!Box
	\|ModTechName=~~72_FRITZBOX~~.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]] ermöglicht die Steuerung einer [[AVM Fritz!Box]] ~~und~~ von AVM FRITZ!WLAN Repeatern 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 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.

	{{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=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.}}
Zeile 21:		Zeile 21:

	=== Telnet (wird vom Modul nicht mehr unterstütz) ===		=== Telnet (wird vom Modul nicht mehr unterstütz) ===
	<s>Das Modul basierte ursprünglich auf dem Zugriff auf die Fritzbox per Telnet. Ab FRITZ!OS 6.2x baut AVM den abgekündigten Telnet-Zugang sowie die webcm-Schnittstelle sukzessive zurück bzw. hat dies, je nach Firmware, schon ganz abgestellt (siehe {{Link2Forum\|Topic=38586\|LinkText=dieses Forenthema}}). Der zukunftssichere Zugriff auf die Fritzbox sollte also per TR-064 erfolgen. Der Vollständigkeit halber und für ältere Firmwareversionen:</s>

	# <s>Wer den Zugang per Telnet (noch) nutzen (kann und) möchte, muss dies zuerst freischalten. Üblicherweise durch Eingabe von #967 an einem direkt an der entsprechenden FritzBox angeschlosssenen Telefon</s>
	~~# <s>Auf dem System, auf dem FHEM läuft ([[Systemübersicht#Server\|Server]]) muss Telnet installiert sein; auf einem [[Raspberry Pi]] und unter Ubuntu z. B. mit dem Befehl</s>~~
	~~::<code><s>sudo apt-get install libnet-telnet-perl</s></code>~~

	== Installation ==		== Installation ==
	=== Erste Schritte ===		=== Erste Schritte ===
	Zur Erstinstallation reicht ein einfaches <code>define FritzBox ~~FRITZBOX~~ < 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).

	==== TR-064: Modul FRITZBOX für Zugriff auf einem externen Server einrichten ====		==== TR-064: Modul FRITZBOX für Zugriff auf einem externen Server einrichten ====
Zeile 35:		Zeile 29:

	Fritzbox definieren:		Fritzbox definieren:
	:<code>define FritzBox ~~FRITZBOX~~ < IP oder Hostname ></code>		:<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.		192.168.168.168 dabei natürlich durch die passende IP ersetzen... Alternativ kann statt der IP auch der Hostname eingegeben werden.
Zeile 48:		Zeile 42:
	== Anwendung ==		== Anwendung ==
	=== Define ===		=== Define ===
	Siehe {{Link2CmdRef\|Lang=de\|Anker=~~FRITZBOXdefine~~}}		Siehe {{Link2CmdRef\|Lang=de\|Anker=FitzSmartdefine}}

	=== Attribute ===		=== Attribute ===
	Siehe {{Link2CmdRef\|Lang=de\|Anker=~~FRITZBOXattr~~}}		Siehe {{Link2CmdRef\|Lang=de\|Anker=FritzSmartattr}}

	=== TR-064 ===		=== TR-064 ===

Ph1959de: "Links" wieder als Überschrift definiert

2025-04-25T17:25:57Z

"Links" wieder als Überschrift definiert

← Nächstältere Version		Version vom 25. April 2025, 19:25 Uhr
Zeile 355:		Zeile 355:
	Auch ZigBee-Devices werden dann als FBDECT-Devices gemappt.		Auch ZigBee-Devices werden dann als FBDECT-Devices gemappt.

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

← Nächstältere Version		Version vom 21. März 2026, 12:25 Uhr
Zeile 27:		Zeile 27:
	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).

	==== TR-064: Modul ~~FRITZBOX~~ für Zugriff auf einem externen Server einrichten ====		==== 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):		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):

Zeile 149:		Zeile 149:

	=== Anwesenheitserkennung per regelmäßiger Abfrage über das PRESENCE Modul ===		=== 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 ~~FRITZBOX~~ 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.		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:		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:
Zeile 171:		Zeile 171:
	wobei		wobei
	*<Name> ein beliebig zu wählender Name für die PRESENCE-Funktion ist,		*<Name> ein beliebig zu wählender Name für die PRESENCE-Funktion ist,
	*Fritzbox der Name ist, mit dem ihr die abzufragende Fritzbox als ~~FRITZBOX~~ definiert habt,		*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.		*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.		* "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.
Zeile 224:		Zeile 224:
	* <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>).		* <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.		* mac_AA_BB_CC_DD_EE_FF ist die MAC-Adresse des gesuchten Geräts.
	* "Fritzbox" ist der Name, unter dem die Fritzbox als ~~FRITZBOX~~-Modul definiert wurde.		* "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.		* 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.		* 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.