Fork me on GitHub

pimatic-fritz by Andreas Goetz | github | npm

pimatic fritz plugin

NPM Version Donate

Fritz plugin enables connecting FritzDECT devices to pimatic automation server.

Devices supported are:

  • FritzBox (Guest WLAN configuration)
  • FritzDECT 200 outlet
  • CometDECT thermostat
  • both FritzDECT and CometDECT can also be used as temperature sensors

Plugin Configuration

You can load the plugin by editing your config.json to include:

{
  "plugin": "fritz",
  "url": "http://fritz.box", // url of the FritzBox
  "user": "username", // FritzBox user
  "password": "password", // FritzBox password
  "interval": 60 // Polling interval for the FritzDECT switches
}

Device Configuration

Devices are linked to fritz plugin channels by specifying the class, middleware and ain properties:

...
"devices": [
{
  "id": "home-switch",
  "name": "Fritz outlet",
  "class": "FritzOutlet",
  "ain": "xxxxxxxxx"
},
{
  "id": "thermostat-1",
  "name": "Thermostat 1",
  "class": "FritzThermostat",
  "ain": "xxxxxxxxx"
},
{
  "id": "temp-1",
  "name": "TemperatureSensor 1",
  "class": "FritzTemperatureSensor",
  "ain": "xxxxxxxxx"
},
{
  "id": "guest-wlan",
  "name": "Guest WLAN",
  "class": "FritzWlan"
},

...

A list of available fritz switch and thermostat AINs will be logged to the pimatic console when the plugin is started.

Plugin Config Options

Fritz plugin config options
OptionDescriptionDefault
url
string
Fritz!Box URL
"http://fritz.box"
user
string
Fritz!Box user
password
string
Fritz!Box password
interval
number
Polling interval for switch state in seconds
60

Device Config Options

Fritz device config schemas

FritzOutlet

Fritz!DECT 200 outlet
OptionDescriptionDefault
ain
string
Device AIN
interval
number
Polling interval in seconds
0

FritzWlan

Fritz!Box guest WLAN
OptionDescriptionDefault
interval
number
Polling interval in seconds
1800

FritzThermostat

Comet DECT thermostat
OptionDescriptionDefault
ain
string
Device AIN
interval
number
Polling interval in seconds
0
comfyTemp
number
The defined comfy temperature
21
ecoTemp
number
The defined eco mode temperature
17
guiShowTemperatureInput
boolean
Show the temperature input spinbox in the GUI
true

FritzTemperatureSensor

Comet DECT temperature sensor
OptionDescriptionDefault
ain
string
Device AIN
interval
number
Polling interval in seconds
0
pimatic-fritz is written by Andreas Goetz