FritzBox
Inhaltsverzeichnis
- Vorbemerkungen zur Library
- Vorbemerkungen zur Integration von Geräten
- Hinweise zum Symcon-System / Host
- Folgende Module beinhaltet das FritzBox Repository
- Changelog
- Spenden
- Lizenz
Vorbemerkungen zur Library
Falls das alte FritzBox-Project noch installiert ist:
- Deaktiviert die ScriptTimer oder setzt deren Intervall hoch. Die FritzBox reagieren empfindlich auf zu viele Anfragen.
- Schließt den Client-Socket vom Anrufmonitor in Symcon.
Weitere Hinweise
- Für die Rückwärtssuche nach Rufnummern wird das Modul hier benötigt, oder ein eigenes Script [Modul] Rückwärtssuche von Rufnummern über das Internet
- Das Modul enthält fast alle Funktionen des alten FritzBox-Project, teilweise aber mit anderen Leistungsmerkmalen.
- Auch wenn AVM angefangen hat die SmartHome-Geräte über diese Schnittstelle bereitzustellen, so ist der Funktionsumfang noch sehr gering. Für das AHA-HTTP-Interface bitte das Modul von tommi benutzen, funktionsumfang kenne ich aber nicht → neue PHP-Module als Ersatz meiner Delphi-Module
- Zugriff auf eine FritzBox über das Internet ist nicht möglich! Siehe auch CallStranger Sicherheitslücke. Zitat AVM:
...ist nicht betroffen, da UPnP dort nicht aus dem Internet erreicht oder genutzt werden kann.
Vorbemerkungen zur Integration von Geräten
Es werden Instanzen zum auffinden (Discovery) und einrichten (Konfigurator) von Geräten in Symcon bereitgestellt.
Diese Instanzen werden nur korrekt funktionieren, wenn die betreffenden Geräte entsprechend Konfiguriert wurden.
Es wird dringend empfohlen vor der Integration in IPS folgende Parameter in der FritzBox zu konfigurieren / zu prüfen:
- Zugangsdaten einen Benutzers
- Berechtigung der Zugangsdaten
- Anrufmonitor, sofern gewünscht, per Telefon aktivieren. (
#96*5* wählen
)
Vorbereitungen in der FritzBox:
Es wird dringend empfohlen einen eigenen Benutzer mit Passwort in der FritzBox anzulegen und mit folgenden Berechtigungen zu versehen (Anmeldung aus Internet sollte aus sein [siehe Hinweis 5])
Unter Heimnetz / Netzwerk / Netzwerkeinstellungen / weitere Einstellungen bitte folgende Einstellungen setzen (Neustart der Box nicht vergessen):
Hinweise zum Symcon-System / Host
Um Ereignisse von der FritzBox in Symcon zu verarbeiten wird ein Webhook pro IO-Modul erzeugt.
Hier wird beim anlegen der Instanz automatisch nur der interne WebServer von Symcon auf Port 3777 eingetragen. Die IP-Adresse auf welchem Symcon die Daten empfängt wird automatisch ermittelt.
Bei System mit aktiven NAT-Support funktioniert die automatische Erkennung der eigenen IP-Adresse nicht. Hier wird automatisch die NATPublicIP aus den Symcon-Spezialschaltern benutzt.
Auch bei Systemen mit aktiven NAT-Support wird extern automatisch nur der Port 3777 beim anlegen von IO-Instanzen unterstützt.
Sollte es nötig sein, so können bei Bedarf die eigene IP und der Port, sowie die Verwendung von https, in den IO-Instanzen unter Experteneinstellungen
geändert und fixiert werden.
Der Symcon Host muss sich im gleichen Subnetz befinden wie die FritzBox.(Bei NAT, muss der NAT-Host im gleichen Subnetz sein.)
Damit Geräte über das Discovery-Modul gefunden werden können, müssen bei NAT Systemen Multicast-Pakete korrekt weitergeleitet werden.
Discovery funktioniert nicht in einem Docker Container welcher per NAT angebunden ist. Diese Konstellation wird aufgrund der fehlenden Multicast Fähigkeiten von Docker nicht unterstützt. In diesem Fall muss der Konfigurator manuell angelegt und der IO konfiguriert werden.
Für das Discovery werden Pakete über die Multicast-Adresse 239.255.255.250
auf Port 1900
gesendet und UDP Pakete auf Port 1901
empfangen.
Folgende Module beinhaltet das FritzBox Repository
- FritzBox Discovery (Dokumentation)
Auffinden von FritzBox Geräten im Netzwerk. - FritzBox Konfigurator (Dokumentation)
Konfigurator zum Anlegen von weiteren Instanzen. - FritzBox IO (Dokumentation)
Instanz zur Kommunikation mit der FritzBox. - FritzBox Anruf-Monitor (Dokumentation)
Anrufmonitor welcher ankommenden und abgehenden Anrufen erkennt. - FritzBox DVBC (Dokumentation)
DVB-C Receivers der FritzBox auslesen und steuern. - FritzBox DynDNS (Dokumentation)
Auslesen und steuern des Fernzugriff und der DynDNS Funktionen. - FritzBox Geräte Informationen (Dokumentation)
Allgemeine Geräte Informationen abrufen. - FritzBox DHCP Server (Dokumentation)
Internen DHCP-Server der FritzBox verwalten. - FritzBox Dateifreigabe (Dokumentation)
Dateifreigaben der FritzBox verwalten und darstellen. - FritzBox Firmware Informationen (Dokumentation)
Auslesen von Informationen zur Firmware der FritzBox. - FritzBox Host Filter (Dokumentation)
Abfragen und Steuern des Zugangs von Clients zum Internet. - FritzBox Hosts (Dokumentation)
Abfragen und anzeigen von Hostnamen und Onlinestatus von Geräte im Netzwerk. - FritzBox MyFritz (Dokumentation)
Auslesen und darstellen der MyFritz Dienste. - FritzBox NAS Storage (Dokumentation)
Status der Netzwerkfreigabe und des FTP Servers auslesen und setzen. - FritzBox Powerline (Dokumentation)
Auslesen der Zustände von Powerline Geräten. - FritzBox SmartHome (Dokumentation)
TR64 Geräte Instanz für SmartHome Geräte der FRitzBox. - FritzBox SmartHome Konfigurator (Dokumentation)
Konfigurator zum Anlegen von SmartHome Instanzen. - FritzBox Telefonie (Dokumentation)
Verarbeitet alle Telefonie-Funktionen. - FritzBox NTP-Server & Systemzeit (Dokumentation)
Auslesen und Steuern des NTP Dienst. - FritzBox UPnP MediaServer (Dokumentation)
Auslesen und steuern der UPnP/DLA Funktionen. - FritzBox allgemeine WAN-Schnittstelle (Dokumentation)
Auslesen der aktuell genutzten WAN Verbindung. - FritzBox DSL-Verbindung (Dokumentation)
Status der DSL Verbindung. - FritzBox WAN physikalische WAN-Schnittstelle (Dokumentation)
Status des WAN Zugang in Symcon darstellen. - FritzBox WAN IP-Verbindung (Dokumentation)
Auslesen der WAN IP Verbindung. - FritzBox WAN Port-Weiterleitung (Dokumentation)
Auslesen und darstellen der Portweiterleitungen. - FritzBox Online-Speicher (Dokumentation)
Auslesen und steuern des Online-Speichers. - FritzBox WLAN (Dokumentation)
Auslesen und steuern der WLAN Funktionen.
Changelog
siehe nächster Beitrag
Spenden
Die Library ist für die nicht kommerzielle Nutzung kostenlos, Schenkungen als Unterstützung für den Autor werden hier akzeptiert: