p3exporter-fritzbox-smarthome 1.0.2

Fritz!Box p3exporter collector module

p3exporter collector module for FritzBox smarthome data

This module provides collector for FritzBox smarthome device data. It can be enabled with a default p3exporter installation via p3.yml.

The collector is in a very early state and it provides temperature data from connected thermostat devices with temperature sensors.

Tested with:

• Comet DECT thermostat

Installation and Running

You need to install p3exporter first. It is available on pypi so you can use pip to install the exporter and run it locally.

pip install p3exporter

Now you need to install p3exporter-fritzbox-smarthome. Choose one method mentioned below.

Install from pypi.org

We also provide a pypi.org package. You can install the collector with the following command:

pip install p3exporter-fritzbox-smarthome

Install from repository

You can install it from a local clone of our github repository.

$ git clone https://github.com/codeaffen/p3exporter-fritzbox-smarthome.git
Cloning into 'p3exporter-fritzbox-smarthome'...
...
$ cd p3exporter-fritzbox-smarthome
$ pip install -e .

Activation FritzBox smarthome collectors

To start p3exporter you need a valid p3.yml you can either edit an existing one or take the example from this repository.

curl --silent https://raw.githubusercontent.com/codeaffen/p3exporter-fritzbox-smarthome/develop/p3.yml.example --output ~/tmp/p3.yml

If you edit an existing p3.yml add the following content to activate the collector.

collectors:
  - p3eFritzBox.collector.smarthome
collector_opts:
  smarthome:
    username: smarthome
    password: v3rys3cr3t

After that you can start the p3exporter as usual:

$ p3exporter -c /tmp/p3.yml
INFO:root:Collector 'p3eFritzBox.collector.smarthome' was loaded and registred successfully
INFO:root:Start exporter, listen on 5876

Configuration

There are some parameters avaiable to configure the collector. In the following table all parameters are listed.

Name	Default	Mandatory	Description
username		*	Username used to authenticate against FritzBox
password		*	Password used to authenticate against FritzBox
hostname	https://fritz.box		Hostname of FritzBox to connect to. Protocol can be http or https. If no protocol is given default will be https.
device_types			List of device type to enable. If List is empty all device types are activated. Possible values are: temperature_sensor
ssl_verify	True		Set to True to disable ssl certificate verfication. This is useful in case of using self signed certificates. Note: To use this parameter pyfritzhome from github is needed as the ssl_verify parameter is not yet available in pypi package. For details use requirements.txt.