home-assistant.io/source/_components/sensor.fritzbox_netmonitor.markdown

2.8 KiB

layout title description date sidebar comments sharing footer logo ha_category ha_release ha_iot_class
page FRITZ!Box Net Monitor Instructions on how to integrate an AVM FRITZ!Box monitor into Home Assistant. 2017-01-17 22:00 true false true true avm.png System Monitor 0.36 Local Polling

The fritzbox_netmonitor sensor monitors the network statistics exposed by AVM Fritz!Box routers.

It might be necessary to install additional packages: $ sudo apt-get install libxslt-dev libxml2-dev python3-lxml If you are working with the All-in-One installation, you may also need to execute also within your virtual environment the command pip3 install lxml; be patient this will take a while.

To use the Fritz!Box network monitor in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
sensor:
  - platform: fritzbox_netmonitor

{% configuration %} host: description: The IP address of your router, e.g., 192.168.1.1. It is optional since every fritzbox is also reachable by using the IP address 169.254.1.1. required: false default: 169.254.1.1 type: string name: description: Give the sensor a friendly name for in the front-end. required: false default: fritz_netmonitor type: string {% endconfiguration %}

The following statistics will be exposed as attributes.

Attribute Description
is_linked True if the FritzBox is physically linked to the provider
is_connected True if the FritzBox has established an internet-connection
wan_access_type Connection-type, can be DSL or Cable
external_ip External ip address
uptime Uptime in seconds
bytes_sent Bytes sent
bytes_received Bytes received
transmission_rate_up Current upstream speed in bytes/s
transmission_rate_down Current downstream speed in bytes/s
max_byte_rate_up Maximum upstream-rate in bytes/s
max_byte_rate_down Maximum downstream-rate in bytes/s

The sensor's state corresponds to the is_linked attribute and is either online, offline, or unavailable (in case connection to the router is lost).

This component does not support "Fritz!Box 6490 Cable" with FritzOS 6.87 installed.