[b]FritzBox-Project
Version 1.09 (11.03.2018) by Nall-chan
[/b]Version 1.10 (11.03.2020) by Nall-chan, paresy, Optimiert für Import mit neuer Konsole[b][SIZE=2]
[u][SIZE=4]Übersicht:
[/SIZE][/u][/b][SIZE=4]
[ul]
[li]Auslesen und abbilden diverser Werte und Zustände aus der FritzBox als IPS-Variablen.[/li][li]Steuern diverser Funktionen in der FritzBox, sowohl über das WebFront, also auch per externen Skripten.[/li][li]Aufbereiten und darstellen diverser Informationen in tabellarischer Form.[/li][li]Design und Funktionsumfang ist vollständig vom User konfigurierbar.[/li][/ul]
[/SIZE][/SIZE]
[SIZE=2]Funktionsumfang:[/SIZE]
[SIZE=2][SIZE=4]
[ul]
[li][SIZE=2]Hardware und Software der FritzBox auslesen.[/li][li]NTP-Server und Systemzeit auslesen, NTP-Server setzen.[/li][li]DSL-Modem Status, sowie diverse WAN Daten (Auslastung, Bandbreiten, etc…)lesen.[/li][li]Alle bekannten Netzwerkgeräte auslesen und in einer Tabelle darstellen. (Eventuell ein Limit vorhanden. Siehe bekannte Einschränkungen)[/li][li]WOL für Netzwerkgeräte[/li][li]WLAN Status lesen und setzen, sowie alle aktiven Geräte auslesen und in einer Tabelle darstellen.[/li][li]PopUp mit QR-Code beim einschalten eines WLANs.[/li][li]MyFritz-Dienste auslesen. (Steuern des MyFritz-Dienst, ist aktuell nicht möglich. Siehe bekannte Einschränkungen)[/li][li]Port-Weiterleitungen auslesen und steuern.[/li][li]NAS-Funktion, Online-Speicher und Media-Server Dienste auslesen und steuern.[/li][li]Konfiguration des DHCP-Server lesen.[/li][li]Anrufmonitor mit Benachrichtigung im WebFront und einer Tabelle der aktiven Gespräche.[/li][li]Anrufmonitor kann ein zusätzliches User-Skript starten.[/li][li]Beliebige Anzahl von Anruferlisten.[/li][li]Anruferlisten können sowohl FAX, als auch Sprachnachrichten darstellen bzw. wiedergeben.[/li][li]Nachrichtenliste des Anrufbeantworter.[/li][li]Download des internen Telefonbuches für die Invers-Suche.[/li][li]Unterstützung der Klicktel-API für die Invers-Suche.[/li][/ul]
[SIZE=2]Screenshots:[/SIZE]
siehe 3. Post
[SIZE=2]Vorraussetzungen:
[/SIZE]
[/SIZE][/SIZE][/SIZE]
[ul]
[li]ab IPS 3.4[/li][li]FritzBox mit relativ aktueller Firmware (Labor und Beta nicht einbezogen)[/li][/ul]
Vorbereitungen[SIZE=2] (FritzBox):
[/SIZE]Auf der Weboberfläche der FritzBox (alle) Punkte unter ‚Heimnetzfreigaben‘ einschalten.
Zu finden unter: Heimnetz -> Netzwerk Und dann den Reiter Netzwerkeinstellungen wählen.
- Punkt : ‚Zugriff für Anwendungen zulassen‘ sonst funktioniert gar nichts.
- Punkt : ‚Statusinformationen über UPnP übertragen‘ sonst bekommen wir keine Events von der Box gesendet.
- Punkt : ‚Smarthome-Funktion im FRITZ!Box-Heimnetz freigeben‘ ist noch nicht implementiert, aus Mangel an Hardware.[SIZE=2][SIZE=4]
[/SIZE][/SIZE]Unter Umständen den Anrufmonitor der FritzBox per angeschlossenen Telefon (DECT, ISDN oder VOIP) mit der Wählfolge #965 aktivieren, wenn diese Funktion erwünscht ist (Standard im Project= an).
Installation[SIZE=2][SIZE=4][SIZE=5][b][u][SIZE=2][SIZE=4] (Import des FB-Project):
[/SIZE][/u][/b][/SIZE][/SIZE][/SIZE][/SIZE]
[ul]
[li]Die ZIP-Datei herunterladen und das enthaltene Script entpacken.[SIZE=2][/li][/SIZE]
[li]Über den Button ‚Importieren‘ das zuvor entpackte Script in IPS laden.[/li][li]In Zeile 25 bei WFC_TargetID die InstanzID des WebFront Konfigurator eintragen.[/li][li]Speichern und anschließend ausführen.[/li][li]Das angezeigte Installationsprotokoll sollte keine Fehler (Warnungen sind ok) auflisten.[/li][/ul]
Download Version 1.09 (Nur Legacy Konsole)
FBProjectV1.09.zip (96.6 KB)
Download Version 1.10 (Alle Konsolen)
FB Project V1.10.zip (95.7 KB)
(Bei Updates hier weiterlesen: Fritz-Box Project)
[SIZE=2][SIZE=4][SIZE=5][b][SIZE=2]
Der Objektbaum sollte nun so aussehen:[u][SIZE=4]
[SIZE=5][SIZE=2][SIZE=4][b][u]Konfiguration (Pflicht):
[/u][/b][/SIZE][/SIZE][/SIZE][/SIZE][/u][/b][/SIZE][/SIZE][/SIZE][/SIZE]
[ul]
[li]Das Script ‚Anleitung & Changelog‘ zu finden unter ‚Scripte‘ enthält wichtige Installationshinweise. Diese bitte lesen (oder einfach hier diesen Punkten folgen).[/li][li]Das ‚User-Config‘ Script per doppelklick öffnen.[/li][li]Ca ab Zeile 15 sind die Zugangsdaten der FritzBox zu vervollständigen.[/li][li]Immer die Bemerkungen hinter einem Eintrag lesen, um eventuelle Fehler auszuschließen.[/li][li]Die Angeben bei ‚FB_IPS_IP‘ und ‚FB_IPS_PORT‘ sind nötig um Events der Box empfangen zu können.[/li][li]Der Port kann frei vergeben werden. Bitte daran denken, diesen Port in eurer Firewall freizugeben (TCP ankommend/eingehend).[/li][li]Soll der Anrufmonitor verwendet werden, so ist noch ca. bei Zeile 194 unter ‚FB_CallMonitor_Popup_WFC‘ die InstanzID des WebFront Konfigurator einzutragen.[/li][li]Dieses ‚User-Config‘ Script einmal ausführen.[/li][li]Die Ausführung kann bis zu 2 Minuten dauern![/li][/ul]
Die Ausgabe vom Config-Script sollte so aussehen:
Beginne mit Projekt initialisierung.
------------------------------------
Lege Profile an:
FB.Connect erzeugt:
FB.kBit erzeugt:
FB.MBits erzeugt:
FB.kbs erzeugt:
FB.Speed erzeugt:
------------------------------------
Scripte starten um Variablen und Timer zu initialisieren:
Hardware Informationen lesen.
NTP-Server uns Systemzeit lesen.
DSL-Modem Status lesen.
WAN physikalische Daten lesen.
WAN Verbindung lesen.
WAN Interface lesen.
WAN Auslastung lesen.
Host-Tabelle lesen.
WLAN-Netzwerke und Geräte lesen.
MyFritz-Dienste lesen.
Port-Weiterleitungen lesen.
Storage-Dienste lesen.
WebDav-Dienst lesen.
UPnP-Dienste lesen.
Fernzugriff und DynDNS lesen.
Fernzugriff und DynDNS lesen.
Anrufmonitor erzeugen.
Anruferliste erzeugen.
Anrufbeantworterliste erzeugen.
Popup-Script erzeugen.
Sprach- und Fax-Nachrichten Script erzeugen.
------------------------------------
Namen, Links und Dummy-Instanzen für die Visualisierung erzeugen.
Hardware Informationen Link erzeugt.
NTP-Server und Systemzeit Link erzeugt.
DSL-Modem Link erzeugt.
Dummy-Instanz für WAN-Geschwindigkeit erzeugen.
Dummy-Instanz für WAN-Bandbreite erzeugen.
Dummy-Instanz für WAN Verbindung erzeugen.
Empfangsrate Link erzeugt.
Senderate Link erzeugt.
Last Downstream Link erzeugt.
Last Upstream Link erzeugt.
Downstream Link erzeugt.
Upstream Link erzeugt.
DNS-Server 1 Link erzeugt.
DNS-Server 2 Link erzeugt.
VoIP DNS-Server 1 Link erzeugt.
VoIP DNS-Server 2 Link erzeugt.
Portfreigaben per UPnP Link erzeugt.
WAN Steuerung Link erzeugt.
Verbindungsstatus Link erzeugt.
Verbindungsdauer Link erzeugt.
Externe IPv4 Adresse Link erzeugt.
Dummy-Instanz für physische WAN Verbindung erzeugen.
Verbindungstyp Link erzeugt.
Status Link erzeugt.
Upstream Link erzeugt.
Downstream Link erzeugt.
Fernzugang & DynDNS Link erzeugt.
WAN Port-Weiterleitungen Link erzeugt.
MyFritz Dienst Link erzeugt.
DHCP Server Link erzeugt.
Storage Link erzeugt.
UPnP Dienste Link erzeugt.
WebDav Link erzeugt.
Netzwerkgeräte Link erzeugt.
WLAN 5 GHz - Status Link erzeugt.
WLAN 2,4 GHz - Status Link erzeugt.
WLAN Gäste - Status Link erzeugt.
Dummy-Instanz für Anruferlisten erzeugen.
Anruferliste TOCHTER Link erzeugt.
Anruferliste DUMMY Link erzeugt.
Anruferliste FAMILY Link erzeugt.
Anrufbeantworter Link erzeugt.
Anrufmonitor Link erzeugt.
------------------------------------
I/O-Instanzen prüfen, erzeugen und konfigurieren.
FB Event Receiver erzeugen.
FB Event Receiver wurde in Event-Control eingetragen.
RegVar für FB Event Receiver erzeugen.
Übernahme der Einstellungen für FB Event Receiver und starten des Subscribe (ausgelöst durch Event-Control).
Socket für Anrufmonitor erzeugen.
RegVar für Anrufmonitor erzeugen.
[SIZE=2][SIZE=4]
[SIZE=5][SIZE=2][SIZE=4][SIZE=5][b]Der Objektbaum sollte nun so aussehen:[u]
[SIZE=2]Und unter Scripte so aussehen:
[/SIZE]
[SIZE=2][SIZE=4][SIZE=5][b][u][SIZE=2][SIZE=4][SIZE=5][SIZE=2][SIZE=4][b][u]Konfiguration (WebFront):
[/u][/b][/SIZE][/SIZE][/SIZE][/SIZE][/u][/b][/SIZE][/SIZE][/SIZE][/SIZE][/SIZE][/SIZE][/u][/b][/SIZE][/SIZE][/SIZE][/SIZE]Beim Import wurde automatisch ein Objekt ‚FB_ROOT‘ im WebFront-Konfigurator angelegt.
Dieses muss noch nach euren Wünschen einsortiert bzw. angepasst werden.
Es zeigt per default auf die Kategorie ‚Visualisierung (Vorlage / Beispiele)‘ welches, wie der Name schon sagt, als Beispiel zu verstehen ist.
Ihr könnt jederzeit euch eigene Links auf die Dummy-Instanzen bzw. Variablen setzen.
Grundlegendes[SIZE=2]:
[/SIZE]
[ul]
[li]Es werden ausschließlich Funktionen welche per SOAP zugänglich sind abgebildet.[/li][li]Das User-Config Script übernimmt alle ‚FB_Intervall_‘ Einstellungen nur, wenn es nochmal ausgeführt wird.[/li][li]Gleiches gilt für den Abschnitt ‚Event Receiver‘ im User-Config-Script.[/li][li]Das User-Config Script löscht keine Einstellungen / Variablen / Objekte. Es kann somit nach Änderungen problemlos ausgeführt werden. Jedoch werden die Link im Beispiel-Ordner der Visualisierung dabei u.U. neu angelegt.[/li][li]Alle Objekte (Instanzen, Variablen etc…) im Project-Baum, dürfen umbenannt, aber niemals in eine andere Ebene verschoben werden.[/li][li]Anruferliste-Config, Anrufmonitor-Config und Anrufbeantworter-Config sollten nach euren Wünschen angepasst werden. Anschließend das dazugehörige (Aktions &) Auslese-Script ausführen, damit die Änderungen sofort sichbar sind.[/li][li]Nicht jede FritzBox und/oder Firmware stellt alle Funktionen zur Verfügung. Bei Fehlern bitte hier melden: Q & A zum FritzBox-Project[/li][li]AVM erweitert die Funktionen aktuell bei jedem neuen Release einer Firmware. Leider kann ich diese Funktionen immer erst sehr spät selber testen (Kabel-FritzBox). Fehlt also etwas, so ebenfalls hier melden: Q & A zum FritzBox-Project[/li][li]Schaltet man die NAS-Funktion aus,so sind auch der Online-Speicher und der Media-Server ohne Funktion. Dies wird aber von der Box intern nicht geprüft. Darum können diese Dienste separat über IPS geschaltet werden.[/li][/ul]
Bekannte Einschränkungen[SIZE=2]:
[/SIZE]
[ul]
[li]Die Anzahl der Netzwerkgeräte ist bis zur Version FritzOS 6.30 auf 16 Stück limitiert.[/li][li]Der Chrome-Browser verhält sich nicht korrekt bei der Wiedergabe von Sprachnachrichten. Er spielt diese in einer Endlosschleife ab.[/li][li]Die Steuerung des Anrufbeantworters funktioniert u.U. nicht (ein & ausschalten).[/li][li]‚Microsoft Edge‘ & ‚Internet Explorer‘ zeigen keinen QR-Code an. Ebenso kein PopUp bei den Sprachnachrichten.[/li][li]Ein ‚reconnect‘ der WAN IP-Verbindung, kann bei Kabel-Boxen einen Neustart der FritzBox auslösen.[/li][li]MyFritz-Dienste können aktuell nicht geschaltet werden.[/li][/ul]
Bei Problemen:
Q & A zum FritzBox-Project