Fritz Box Binding

Hans Wagner edited this page Mar 22, 2016 · 21 revisions

feature overview

Installation

Setup intro

Linux and OS X

Windows

FreeBSD


Configuration

Automation

User Interfaces

Persistence


Community

(link to openHAB forum)

Development


Bindings


Application Integration

Misc


Samples

A good source of inspiration and tips from users gathered over the years. Be aware that things may have changed since they were written and some examples might not work correctly.

Please update the wiki if you do come across any out of date information.

Binding configurations

Use case examples

Item definition examples

Sitemap definition examples

Collections of Rules on a single page

Single Rules

Scripts

Syntax highlighting for external editors


Release Notes

Clone this wiki locally

Documentation of the Fritz!Box binding bundle

Introduction

For installation of the binding, please see Wiki page Bindings.

Adapt your openhab.cfg to your configuration:
fritzbox:ip=<IP adress of your fritzbox>
fritzbox:password=<password of your fritzbox>

Fritzbox with user mangement enabled

fritzbox:user=<user of your fritzbox>
It is a good practice to create an additional user for openhab.

Prepare your Fritzbox

  • Enable Telnet (Link)
  • Activate User Login: FRITZ!Box-Benutzer -> Anmeldung im Heimnetz -> Anmeldung mit dem FRITZ!Box-Kennwort

Generic Item Binding Configuration

In order to bind an item to the Fritz!Box, you need to provide configuration settings. The easiest way to do so is to add some binding information in your item file (in the folder configurations/items`).

The format of the binding configuration is simple and looks like this: fritzbox="" where <eventType> is one of the following values:

  • inbound - for incoming calls
  • outbound - for placed calls
  • active - for currently active calls

Fritz!Box binding configurations are valid on Switch and Call items.

Switch items with this binding will receive an ON update event at the start and an OFF update event at the end (a connection marks the end for inbound and outbound types, only active type will be ON for connected calls).

Call items will receive the external and the internal phone number in form of a string value as a status update. At the end of the event, an empty !CallItem which contains empty strings is sent as a status update.

As a result, your lines in the items file might look like the following:

Switch    Incoming_Call     "Ringing"                        (Phone)    { fritzbox="inbound" }
Call      Active_Call       "Connected to [%1$s from %2$s]"  (Phone)    { fritzbox="active"  }
Call      Incoming_Call_No  "Caller No. [%2$s]"              (Phone)    { fritzbox="inbound" } 

Switching WIFI and DECT

The following items switch DECT, WIFI, GUEST_WIFI and the answering machine 0 (default TAM):

Switch DECT {fritzbox="dect"}
Switch WIFI {fritzbox="wlan"}
Switch GWIFI {fritzbox="guestwlan"} (Version 1.7.0)
Switch TAM0 {fritzbox="tam0"}