FRITZ!SmartHome Smart-Home-Integration, kostenlos und Open Source
Steckdosen, Heizkörperregler, Rollläden, Lampen und Taster deiner FRITZ!Box (DECT).
Veröffentlicht von guim31
- Geräte
- Version 1.0.0
- Erfordert Gladys >=5.1.0
- ★ 0
Verbinde die Smart-Home-Geräte von AVM an deiner FRITZ!Box mit Gladys: Steckdosen FRITZ!DECT 200 und 210 (Ein/Aus, Leistung, Energie), Heizkörperregler FRITZ!DECT 301 und 302 und Comet DECT (Solltemperatur, Heizen ein/aus, gemessene Temperatur, Batterie, offenes Fenster, Boost), Rollläden über DECT ULE (Rollotron), Lampen FRITZ!DECT 500, HAN-FUN-Melder sowie die Taster FRITZ!DECT 400 und 440 als Szenen-Auslöser. Alles bleibt in deinem lokalen Netzwerk: Die Integration spricht mit der Box über ihre AHA-HTTP-Schnittstelle, die AVM dokumentiert. Keine Cloud, kein MyFRITZ!-Konto.
Diese Integration ersetzt nicht die Integration FRITZ!Box (Internet, Gast-WLAN, Anwesenheit, Anrufe): Beide ergänzen sich und können nebeneinander laufen.
Ohne die Hardware entwickelt: Rückmeldungen willkommen. Die Integration ist durch automatische Tests abgedeckt, die auf echten Antworten von FRITZ!Boxen beruhen (gesammelt von der Bibliothek pyfritzhome), und die Anmeldeverfahren sind an den Beispielen von AVM geprüft, aber sie lief noch nicht an einer echten Box. Erzähl uns im Gladys-Forum, wie sie mit deinen Geräten funktioniert.
Was du bekommst
- Ein Gladys-Gerät pro Smart-Home-Gerät der Box, mit den Funktionen, die es hat (siehe Geräte): Schalter und Zähler einer Steckdose, Solltemperatur und Heizmodus eines Heizkörperreglers, Position eines Rollladens, Licht, Helligkeit und Farbe einer Lampe, Zustand eines Melders, Temperatur, Luftfeuchtigkeit und Batterie.
- Ein Dashboard-Widget: Leistung der Steckdosen, heizende Regler, offene Fenster und eine Zeile pro Gerät.
- Drei Szenen-Auslöser: ein FRITZ!DECT-Taster gedrückt (welche Taste, kurz oder lang), ein Heizkörperregler erkennt ein offenes Fenster, eine Batterie wird schwach.
- Eine Szenen-Aktion: einen Heizkörperregler auf seine Komfort- oder Absenktemperatur setzen, einen Boost oder den Fenster-offen-Modus für eine Weile starten oder beenden.
Voraussetzungen
- Eine FRITZ!Box mit FRITZ!OS 7 oder neuer (FRITZ!OS 7.24 oder neuer empfohlen: sichere PBKDF2-Anmeldung) und angemeldete Smart-Home-Geräte (Smart Home > Geräte).
- Ein FRITZ!Box-Benutzer mit dem Recht Smart Home.
- Gladys Assistant 5.1.0 oder neuer.
- Gladys im selben lokalen Netzwerk wie die Box.
Konfiguration
Die FRITZ!Box vorbereiten
- Öffne die Oberfläche der Box (http://fritz.box).
- Lege unter System > FRITZ!Box-Benutzer einen Benutzer für Gladys an (z. B.
gladys) mit einem starken Kennwort und setze das Recht Smart Home. Andere Rechte sind nicht nötig. - Prüfe, dass deine Geräte unter Smart Home > Geräte erscheinen.
Einstellungen
| Einstellung | Beschreibung |
|---|---|
| Adresse | IP-Adresse oder Name der Box. Leer: Die Box wird im Netzwerk gesucht (SSDP), dann fritz.box. |
| Benutzername | der oben angelegte Benutzer. |
| Kennwort | sein Kennwort, von Gladys gespeichert, nie in den Protokollen. |
| Verschlüsselt (HTTPS) | Port 443 statt 80. Das eigene Zertifikat der Box wird nicht geprüft. |
| Aktualisierungsintervall | wie oft die Geräte gelesen werden: 10 s, 30 s (Standard), 1 min oder 2 min. Tastendrücke folgen ihm. |
| Sprache der Namen | Sprache der Funktionsnamen hinzugefügter Geräte und der Meldungen (standardmäßig Französisch). |
Starte Verbindung testen: Die Aktion meldet sich an, zählt die Geräte und listet sie im Tab „Entdecken“ auf.
Deine Geräte hinzufügen
Öffne den Tab Entdecken der Integration und füge die gewünschten Geräte hinzu. Ein Gerät außer Reichweite der Box wird auch angeboten (es zeigt seine Werte, sobald es zurück ist). Ein später angemeldetes Gerät erscheint beim nächsten Lesen.
Geräte
Die Integration liest die Geräte selbst, im eingestellten Intervall: eine einzige Anfrage an die Box für alle Geräte. Nur geänderte Werte werden an Gladys gesendet.
Steckdosen
FRITZ!DECT 200, 210 und HAN-FUN-Steckdosen anderer Marken:
| Funktion | Typ in Gladys | Hinweise |
|---|---|---|
| Strom | Schalter | ein/aus, steuerbar |
| Leistung | Leistung, in W | |
| Energie | Energie, in kWh | von der Steckdose gemessene Summe |
| Spannung | Spannung, in V | wenn die Box sie meldet |
| Temperatur | Temperatur, in °C | von der Steckdose gemessen, Offset der Box |
Eine in der Box gesperrte Steckdose („Schaltsperre“) lehnt Befehle mit einer Meldung ab.
Heizkörperregler
FRITZ!DECT 301, 302 und Comet DECT:
| Funktion | Typ in Gladys | Hinweise |
|---|---|---|
| Solltemperatur | Thermostat-Sollwert, in °C | steuerbar, 8 bis 28 °C in halben Grad |
| Heizen | Thermostat-Modus (aus/heizen) | aus schließt das Ventil; heizen kehrt zum Wochenprogramm zurück |
| Fenster (Fenster-offen-Modus) | Öffnungssensor | „offen“, solange der Regler sein Ventil geschlossen hält |
| Boost | Eingang (an/aus) | an während eines Boosts |
| Temperatur | Temperatur, in °C | gemessen |
| Batterie | Batterie, in % |
Die Befehle sind absichtlich begrenzt: Eine Solltemperatur unter 8 °C oder über 28 °C wird in diesen Bereich zurückgeholt, und „heizen“ kehrt zur Komfort- oder Absenktemperatur des Programms der Box zurück, nie zum dauerhaften „an“ (Ventil offen, egal bei welcher Temperatur). Ein in der Box gesperrter Regler, einer im Sommermodus oder einer, der dem Urlaubsprogramm folgt, lehnt Befehle mit einer Meldung ab. Die Funktionen Fenster und Boost gibt es nur bei neueren Reglern (nicht bei den ersten Comet DECT).
Rollläden
Rollotron und andere Rollläden über DECT ULE / HAN-FUN:
| Funktion | Typ in Gladys | Hinweise |
|---|---|---|
| Position | Rollladenposition, % | 100 = offen, 0 = zu; steuerbar |
| Rollladen | Rollladenzustand | öffnen, stoppen, schließen |
Lampen
FRITZ!DECT 500 und andere HAN-FUN-Lampen:
| Funktion | Typ in Gladys | Hinweise |
|---|---|---|
| Licht | Licht ein/aus | steuerbar |
| Helligkeit | Helligkeit, in % | steuerbar |
| Farbe | Farbe | steuerbar (FRITZ!OS 7.39 oder neuer); leer im Weißmodus |
Melder
An der Box angemeldete HAN-FUN-Melder: Ein Tür- oder Fensterkontakt wird ein Öffnungssensor, ein Rauchmelder ein Rauchsensor, ein Bewegungsmelder ein Bewegungssensor, ein Wassermelder ein Lecksensor; andere ein Eingang (an = Alarm).
Taster und Sensoren
Die Taster FRITZ!DECT 400 und 440 zeigen ihre Batterie (und die vom 440 gemessene Temperatur und Luftfeuchtigkeit). Die Tastendrücke sind der Auslöser Taster gedrückt. Ein FRITZ!DECT-Repeater zeigt seine Temperatur.
Dashboard-Widget
FRITZ!SmartHome: drei Kacheln (Leistung der Steckdosen, heizende Regler von allen, offene Fenster), dann bis zu zehn Zeilen: Heizkörperregler (gemessene → Solltemperatur, oder aus, Boost, offenes Fenster, Sommer, Urlaub), Steckdosen (an und Leistung), Lampen, Rollläden, Melder, eine schwache Batterie, ein Gerät außer Reichweite. Einstellung: die anzuzeigenden Geräte; leer, die hinzugefügten Geräte (oder alle Geräte der Box, solange keines hinzugefügt ist). Das Widget zeigt nur an: Steuere die Geräte über ihre eigenen Dashboard-Kacheln oder über Szenen.
Szenen-Auslöser
| Auslöser | Filter (optional) | Variablen |
|---|---|---|
| FRITZ!DECT-Taster gedrückt | Taster, welche Taste (400 oder eine der vier des 440), kurz oder lang (400) | Gerätename, Taste, Drücken |
| Offenes Fenster erkannt | Heizkörperregler | Gerätename, Minuten bis zum erneuten Heizen |
| Batterie schwach | Gerät | Gerätename, Batteriestand (%) |
Die Box liefert die Zeit des letzten Drückens jeder Taste: Die Integration erkennt einen Tastendruck beim nächsten Lesen (10 s bis 2 min später, je nach Intervall), und zwei Drücke derselben Taste zwischen zwei Lesevorgängen zählen als einer. Ereignisse vor einem Start der Integration werden nicht nachgespielt.
Szenen-Aktionen
Heizkörperregler einstellen: Regler, Modus, Dauer.
- Komforttemperatur / Absenktemperatur: die in der Box für diesen Regler eingestellten Temperaturen.
- Boost: Ventil ganz offen für die Dauer (standardmäßig 30 min).
- Fenster offen: Ventil zu für die Dauer (standardmäßig 15 min), z. B. beim Lüften.
- Boost und Fenster offen beenden.
Die Dauer beträgt höchstens 24 Stunden, die Grenze der Box: Boost und Fenster-offen-Modus enden immer von selbst.
Szenen-Beispiele
- Schlafzimmer lüften: Wenn der Fensterkontakt des Schlafzimmers öffnet, „Heizkörperregler einstellen“ → „Fenster offen“ für 20 Minuten; wenn er schließt, „Boost und Fenster offen beenden“.
- Ein Taster fürs Bad: Kurzer Druck auf den FRITZ!DECT 400 im Bad, Boost des Badreglers für 30 Minuten; langer Druck, Steckdose des Handtuchheizkörpers aus.
- Batterie-Erinnerung: Wenn eine Batterie schwach wird, eine Nachricht senden „Batterie von {{triggerEvent.data.device_name}}: {{triggerEvent.data.battery}} %“.
Fehlerbehebung
- „hat Benutzername oder Kennwort abgelehnt“: Prüfe sie unter System > FRITZ!Box-Benutzer. Nach einem Fehlschlag wartet die Integration 15 Minuten, dann immer länger bis zu 4 Stunden (oder eine Änderung der Konfiguration), bevor sie es erneut versucht: Die Box sperrt Anmeldungen nach Fehlversuchen immer länger.
- „sperrt Anmeldungen … s“: Die Box lehnt Anmeldungen nach Fehlversuchen ab; die Integration wartet.
- „fehlt das Recht Smart Home“: Setze es für den Benutzer unter System > FRITZ!Box-Benutzer.
- „Keine FRITZ!Box gefunden“: Gib die Adresse der Box in der Konfiguration ein.
- Ein Gerät zeigt „Außer Reichweite“: Es hat die DECT-Verbindung zur Box verloren (Batterie, Entfernung).
- Befehle abgelehnt: Das Gerät ist in der Box gesperrt, oder der Regler ist im Sommer- oder Urlaubsmodus.
- Mehr Details: Setze
LOG_LEVEL=debugam Container der Integration.
Grenzen
- Gruppen und Vorlagen der Box werden nicht angeboten: Eine Gruppe würde die enthaltenen Geräte doppeln. Steuere die Geräte einzeln oder mit einer Gladys-Szene.
- Ein Tastendruck wird beim nächsten Lesen der Box erkannt, nicht sofort; zwei Drücke zwischen zwei Lesevorgängen zählen als einer.
- Die Farbtemperatur (Weißtöne) der Lampen wird nicht angeboten, nur die Farbe.
- Urlaubs- und Sommerzeiträume, Komfort- und Absenktemperaturen und das Wochenprogramm werden in der Box eingestellt, nicht in Gladys.
- Ohne die Hardware entwickelt: beruht auf der AVM-Dokumentation und auf echten Antworten, die pyfritzhome gesammelt hat; Geräte, die diese Antworten nicht abdecken, können sich anders verhalten.
Konfigurationseinstellungen
Diese Einstellungen fragt FRITZ!SmartHome in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Deine FRITZ!Box verbinden | section | Nein | Deine DECT-Smart-Home-Geräte (Steckdosen, Heizkörperregler, Rollläden, Lampen, Taster, Melder) werden aus der FRITZ!Box gelesen. Lege in der FRITZ!Box (http://fritz.box) unter System > FRITZ!Box-Benutzer einen Benutzer mit dem Recht „Smart Home“ an. Starte dann „Verbindung testen“ und füge deine Geräte im Tab „Entdecken“ hinzu. |
| Adresse der FRITZ!Box | string | Nein | Leer lassen, um sie automatisch im Netzwerk zu finden. |
| FRITZ!Box-Benutzername | string | Ja | Ein Benutzer aus System > FRITZ!Box-Benutzer mit dem Recht „Smart Home“. |
| Kennwort | secret | Ja | |
| Verschlüsselte Verbindung (HTTPS) | boolean | Nein | Port 443 statt 80. Das eigene Zertifikat der Box wird nicht geprüft. |
| Aktualisierungsintervall | select | Nein | Wie oft die Geräte aus der Box gelesen werden. Tastendrücke werden in diesem Takt erkannt. |
| Sprache der Funktionsnamen | select | Nein | Namen der Funktionen neuer Geräte und Sprache der Meldungen. |
So installierst du FRITZ!SmartHome in Gladys
- Öffne in Gladys Integrationen: FRITZ!SmartHome erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-fritz-smarthome:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-fritz-smarthome.
FRITZ!SmartHome benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
FRITZ!SmartHome ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation