domoticz-FritzBox

[]()

Adds Virtual Hardware for your Fritz!Box within domoticz. That devices show connection information and enables you to control your WiFi.

Device	Images
guest WiFi
normal WiFi (2.4 GHz)
counter
alarm
switch

Summary

This is a plugin for Domoticz that works with your Fritz!Box. Therefore it generates three devices.

• One alert sensor. Showing the status of the connection.
• One switch, showing if connection is established.
• One selector switch for guest WiFi to turn on/off or also enable WPS
• another selector switch to turn on WPS for normal WiFi
• counter for sent and received bytes

This plugin only works with Fritz Box and is open source.

It is more or less just a wrapper around python lib fritzconnection from Klaus Bremer. Icons used are from DomoticzIcons see Domoticz Wiki

Prepare

• set up your Fritz!Box
  • for plain status, nothing needed
  • enable TR064
  • for guest WiFi control
  • create user and assign TR064 right to this one

Installation and Setup

• a running Domoticz, tested with version 2020.1 and Python 3.7
• Python >= 3.6 (mainly depending on requirements for fritzconnection)
• install needed python modules:
  • fritzconnection Version 1.2.1
  • you can use sudo pip3 install -r requirements.txt
  • might be worth testing with fritzconnection works - just run fritzconnection
• clone project
  • go to domoticz/plugins directory
  • clone the project

    cd domoticz/plugins
    git clone https://github.com/belzetrigger/domoticz-FritzBox.git

• or just download, unzip and copy to domoticz/plugins
• no need on Raspbian for sys path adaption if using sudo for pip3
• some extra work for Windows or Synology, make sure downloaded modules are in path eg. site-packages python paths or change in plugin.py / fritzHelper.py path
  • example adaption:

    import sys
    sys.path
    sys.path.append('/usr/lib/python3/dist-packages')
    # for synology python3 from community
    # sys.path.append('/volume1/@appstore/python3/lib/python3.5/site-packages')
    # for synology sys.path.append('/volume1/@appstore/py3k/usr/local/lib/python3.5/site-packages')
    # for windows check if installed packages as admin or user...
    # sys.path.append('C:\\Program Files (x86)\\Python37-32\\Lib\\site-packages')

• restart Domoticz service
• Now go to Setup, Hardware in your Domoticz interface. There add Fritz!Box Plugin.

  Settings

Versions

Bugs and ToDos

• counter needs still improvements
• rework standard WiFi / Wlan1 and add or integrate 5ghz WLAN in switch
• for WiFi-Selector Switch the BigText always shows Off, I did not found a way to change it.
• sometimes the Devices[idx].Used is incorrect, json shows correct value but on python it is still 0. So we do update even if not used!
• On windows system changing icons for sensors did not really work, so there will be the standard switch icons.
• On windows system "update" the hardware breaks imported python libs. Plugin can not get data from FritzBox. But after restart, service works fine.
• On Synology NAS, up to now, they official support python 3.5. So you might use a previous version of this plugin or use community python.

State

In development. Guest WiFi is now more stable especially on refresh status for WPS. Counters are new and behave a bit different than Fritz!Box Online Monitor. Means there is always a delta in the way FritzBox is showing the daily usage.

Developing

For TR064 actions codes see AVMs Documentation
Based on https://github.com/ffes/domoticz-buienradar/ there are

• fakeDomoticz.py - used to run it outside of Domoticz
• test.py it's the entry point for tests