Zum Hauptinhalt springen

Homematic IP Smart-Home-Integration, kostenlos und Open Source

Homematic IP-Integration für Gladys Assistant

Homematic IP über die Cloud: Heizung, Kontakte, Sensoren, Steckdosen, Rollläden, Alarm.

Auf GitHub ansehenAlle externen Integrationen

Bringt deine Homematic IP Geräte (eQ-3) über die Homematic IP Cloud in Gladys, so wie die offizielle App sie erreicht: Heizkörper- und Wandthermostate, Heizungsräume, Fenster- und Türkontakte, Bewegungs-, Präsenz-, Rauch- und Wassermelder, Steckdosen und Schaltaktoren mit ihrer Leistung, Dimmer, Rollläden und Jalousien, Wandtaster und Fernbedienungen, Wettersensoren und die Alarmanlage.

Developed without the hardware: feedback welcome. Diese Integration wurde nach dem öffentlichen Protokoll und aufgezeichneten Antworten der Homematic IP Cloud gebaut, ohne Access Point zur Hand. Wenn etwas falsch ist oder fehlt, eröffne bitte ein Issue: github.com/guim31/gladys-homematicip/issues. Nicht mit eQ-3 AG verbunden: Homematic IP ist eine Marke von eQ-3.

Voraussetzungen​

  • Ein Homematic IP Access Point (HmIP-HAP oder der Wired Access Point HmIP-DRAP), in der Homematic IP App eingerichtet, mit bereits angelernten Geräten.
  • Seine SGTIN: der 24-stellige Code auf der Unterseite des Access Points und auf dem mitgelieferten Aufkleber (zum Beispiel 3014-F711-A000-0000-0000-0000).
  • Internetzugang für Gladys: Alles läuft über die Homematic IP Cloud.
  • Gladys 5.1 oder neuer.

Die Home Control Unit (HCU) mit ihrer lokalen „Connect API“ wird nicht unterstützt: Diese Integration spricht mit der Cloud des Access Points.

Konfiguration​

Öffne den Tab Konfiguration der Integration.

  1. SGTIN des Access Points: Gib den Code von der Unterseite des Access Points ein (Bindestriche und Leerzeichen erlaubt) und speichere.
  2. PIN des Access Points: Nur wenn du deinen Access Point in der App mit einer PIN geschützt hast. Die PIN dient nur der Kopplung.
  3. Sprache der Gerätenamen: Die Sprache der Funktionsnamen der Geräte, die du hinzufügst (Temperatur, Solltemperatur, Kontakt…). Standardmäßig Französisch.
  4. Steuerung der Alarmanlage: Was Gladys mit der Alarmanlage tun darf (siehe unten).

Kopplung​

  1. Klicke auf Kopplung starten. Gladys bittet die Cloud um Zugriff, als neuer Client namens „Gladys“.
  2. Drücke die blaue Taste oben auf dem Access Point.
  3. Klicke auf Ich habe die Taste gedrückt. Gladys erhält sein Token, liest dein Zuhause und listet die Geräte im Tab Entdecken auf.
  4. Füge die gewünschten Geräte im Tab Entdecken hinzu.

Das Token wird im privaten Volume der Integration (/data) gespeichert, nie in den Protokollen. „Gladys“ erscheint dann unter den Clients der Homematic IP App: Wenn du es dort entfernst, wird der Zugriff entzogen, und der Status der Integration fordert eine neue Kopplung.

Zuhause neu lesen liest sofort alle Geräte und Räume und zeigt, wie viele gefunden wurden (nützlich, nachdem du in der App ein Gerät hinzugefügt hast).

Steuerung der Alarmanlage​

Die Alarmanlage lesen geht immer. Ob Gladys sie ändern darf, entscheidest du in Steuerung der Alarmanlage:

  • Nur lesen (Standard): Gladys zeigt den Alarmmodus und den Alarm, sonst nichts;
  • Nur scharf schalten: Gladys darf die Alarmanlage scharf schalten (Hüll- oder Vollschutz), nie unscharf;
  • Scharf und unscharf schalten: Gladys darf sie auch unscharf schalten.

Der Alarmmodus ist nie ein Schalter, den ein Sprachassistent aus Versehen umlegen könnte: Er wird über seine Auswahl am Gerät oder über die Szenenaktion Homematic IP Alarmanlage schalten geändert, im Rahmen dieser Einstellung.

Geräte​

Drei Arten von Geräten erscheinen im Tab Entdecken.

Homematic IP Geräte​

Ein Gladys-Gerät pro Homematic IP Gerät, benannt wie in der App. Seine Funktionen hängen davon ab, was das Gerät hat, egal welches Modell:

FunktionGeräteWerte
TemperaturThermostate, Klima- und Wettersensoren, STE2 (×2)°C
LuftfeuchtigkeitWandthermostate, Klima- und Wettersensoren%
CO2CO2-Sensorenppm
BeleuchtungsstärkeBewegungs-, Präsenz-, Licht- und Wettersensorenlux
WindgeschwindigkeitWettersensorenkm/h
RegenWettersensoren pro/plus, Regensensorja / nein
KontaktFenster- und Türkontakte, Fenstergriffe, Kontakteingängeoffen / zu (gekippt ist offen)
BewegungBewegungsmelderja / nein
AnwesenheitPräsenzmelderja / nein
RauchRauchwarnmelder (Rauch bei diesem Melder)ja / nein
Wasserleck / WasserstandWassermelderja / nein
HeizenHeizkörperthermostate (Ventil offen)aus / heizt
SchalterSteckdosen, Schaltaktoren, Unterputz-Schalterein / aus, steuerbar
Leistung / Energiemessende Steckdosen und AktorenW / kWh
Licht / HelligkeitDimmerein / aus, %, steuerbar
Position / Öffnen/schließenRollläden, Jalousien, Sonnenschutz0 % zu bis 100 % offen
TasteWandtaster, Fernbedienungen, Tasteingängekurzer Druck, langer Druck
Niedriger Batteriestand / SabotageBatteriegeräte, Geräte mit Sabotagekontaktja / nein

Ein Gerät mit mehreren Kanälen (ein 4-fach-Aktor, ein 6-fach-Wandtaster) hat eine Funktion pro Kanal, benannt nach dem Kanalnamen in der App oder seiner Nummer. Der Access Point selbst und Geräte, die diese Version nicht kennt (Türschlossantriebe, Sirenen, Fußbodenheizungsaktoren…), erscheinen nicht.

Tasten: Jeder Druck ist ein neuer Wert der Funktion Taste (kurzer Druck, langer Druck, Loslassen), nutzbar im Auslöser „Gerätezustand“ der Gladys Szenen. Die Cloud meldet nur die Tastendrücke der Geräte, die sie senden.

Heizungsräume​

Ein Gerät pro Heizungsraum der App, benannt Heizung gefolgt vom Raum:

  • Temperatur und Luftfeuchtigkeit des Raums (Wandthermostat oder Heizkörperthermostat);
  • Solltemperatur: die Zieltemperatur, in halben Grad, innerhalb der Grenzen des Raums;
  • Modus: Automatisch (Wochenprogramm), Manuell oder Eco;
  • Boost: die Ventile ganz offen für die in der App eingestellte Boost-Dauer;
  • Fenster: offen, sobald ein Kontakt oder das Thermostat es offen sieht;
  • Heizen: ob ein Ventil des Raums offen ist.

Zuhause (Eco-Modus und Alarmanlage)​

Ein Gerät Homematic IP für das ganze Zuhause:

  • Eco-Modus (Abwesenheit): an, alle Räume sind auf ihrer Eco-Temperatur, bis du ihn ausschaltest (ein in der App gestarteter Eco-Modus oder Urlaub erscheint hier auch);
  • Alarmmodus: Unscharf, Hüllschutz oder Vollschutz, änderbar im Rahmen von Steuerung der Alarmanlage;
  • Alarm: an, solange der Alarm läuft.

Widget​

Das Widget Homematic IP Heizung zeigt das ganze Haus auf einen Blick: die Temperatur Außen, die die Cloud für dein Zuhause kennt, wie viele Räume gerade Heizt, dann jeden Raum mit Temperatur, Solltemperatur und was er gerade tut (Fenster, Boost, Eco). Seine Schaltfläche startet den Eco-Modus des ganzen Zuhauses (mit Bestätigung) oder bietet, wenn er läuft, Eco-Modus beenden an. Wähle in seinen Einstellungen die anzuzeigenden Räume (alle, wenn keiner gewählt ist).

Szenenauslöser​

Homematic IP Alarm ausgelöst: Die scharf geschaltete Alarmanlage hat ausgelöst. Filtere nach dem Melder (beliebig, wenn leer) und nach der Ursache: Einbruch, Rauch, Wasser, Sabotage, Andere. Die Szene erhält den Namen des Melders und die Ursache als Variablen. Ein Alarm, der beim Start von Gladys schon läuft, löst ihn nicht aus.

Alles andere (ein geöffnetes Fenster, ein Tastendruck, die Temperatur eines Raums) ist eine Gerätefunktion: Nutze den Auslöser „Gerätezustand“ von Gladys.

Szenenaktionen​

  • Homematic IP Eco-Modus starten: alle Räume auf ihrer Eco-Temperatur, für eine Anzahl von Stunden oder bis zum Beenden (0).
  • Homematic IP Urlaubsmodus starten: alle Räume auf einer Temperatur (5 bis 30 °C) für eine Anzahl von Tagen, danach zurück zum Programm.
  • Homematic IP Eco- oder Urlaubsmodus beenden: zurück zum normalen Programm.
  • Homematic IP Alarmanlage schalten: unscharf, Hüll- oder Vollschutz, im Rahmen von Steuerung der Alarmanlage. Die Aktion sagt der Szene, ob der Modus übernommen wurde und welche Melder ihn verhindert haben (zum Beispiel ein offenes Fenster).

Szenenbeispiele​

  • Wenn die letzte Person das Haus verlässt (Gladys-Anwesenheit): Homematic IP Eco-Modus starten, dann Homematic IP Alarmanlage schalten auf Vollschutz; wurde der Modus nicht übernommen, schick dir eine Nachricht mit den verhindernden Meldern.
  • Wenn Homematic IP Alarm ausgelöst mit der Ursache Einbruch: alle Lichter einschalten und eine Nachricht mit dem Melder senden.
  • Wenn der Kontakt des Badfensters auf offen geht: den Boost des Raums ausschalten.

Aktualisierung und Grenzen der Cloud​

Die Cloud schickt jede Änderung sofort (eine Live-Verbindung, wie die App): Zustände erscheinen meist innerhalb von ein bis zwei Sekunden. Zusätzlich liest Gladys das ganze Zuhause beim Start, wenn die Live-Verbindung zurückkommt, und alle 30 Minuten (alle 5 Minuten, solange die Live-Verbindung unterbrochen ist). Gladys fragt diese Geräte nie selbst ab.

Die Homematic IP Cloud bremst zu gesprächige Clients und veröffentlicht kein Kontingent: Die Integration sendet höchstens 10 Anfragen auf einmal, dann eine alle 8 Sekunden, das Tempo des Referenz-Clients, den Home Assistant nutzt. Eine Szene, die viele Geräte auf einmal schaltet, kann die letzten Befehle abgelehnt sehen („Zu viele Homematic IP Befehle hintereinander“): Verteile sie oder nutze eine Gruppe der App.

Fehlerbehebung​

  • „Das ist keine SGTIN“: Der Code hat 24 Zeichen, Ziffern und Buchstaben A bis F. Kopiere ihn von der Unterseite des Access Points.
  • „Die Homematic IP Cloud hat die Anfrage abgelehnt“: Prüfe die SGTIN und, falls dein Access Point eine PIN hat, das Feld PIN des Access Points.
  • „Der Access Point hat noch nicht bestätigt“: Drücke die blaue Taste des Access Points und klicke kurz danach erneut auf Ich habe die Taste gedrückt.
  • „Die Homematic IP Cloud verweigert Gladys den Zugriff“: Gladys wurde in der App aus den Clients entfernt. Starte die Kopplung erneut.
  • „Der Access Point ist nicht verbunden“: Die Cloud antwortet noch, aber mit den letzten Werten. Prüfe Stromversorgung und Netzwerkkabel des Access Points.
  • Ein Tastendruck erscheint nicht: Manche Geräte wirken nur über ihre Direktverknüpfungen und senden nichts an die Cloud; prüfe in der App, dass die Taste nicht nur mit einem Aktor verknüpft ist.
  • Details stehen in den Protokollen der Integration; mit LOG_LEVEL=debug siehst du mehr.

Grenzen​

  • Nur Cloud: keine lokale API des Access Points (die HCU wird nicht unterstützt), also ohne Internet keine Steuerung.
  • In dieser Version nicht abgebildet: Türschlossantriebe, Sirenen, Fußbodenheizungsaktoren, Energiesensor-Schnittstellen (HmIP-ESI), RGB-Leuchten, Garagentormodule, Lamellen der Jalousien, Heizprofile.
  • Kühlen wird nicht unterstützt.
  • Der Alarmauslöser folgt dem Alarm, den die Cloud für das ganze Zuhause meldet; die Rauchwarnmelder behalten ihre eigene Funktion Rauch.
  • Funktionsnamen werden beim Hinzufügen eines Geräts festgelegt: Ändere die Sprache, bevor du die Geräte hinzufügst.
  • Mit dem Volume /data geht das Token verloren: Dann muss neu gekoppelt werden.

Support​

Developed without the hardware: feedback welcome. Fragen, Fehler und fehlende Geräte: github.com/guim31/gladys-homematicip/issues. Dieses Projekt ist nicht mit eQ-3 AG verbunden.

Konfigurationseinstellungen​

Diese Einstellungen fragt Homematic IP in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Deinen Access Point verbindensectionNeinGladys erreicht deinen Homematic IP Access Point (HmIP-HAP) über die Homematic IP Cloud, wie die App. 1. Gib seine SGTIN ein (steht auf der Unterseite des Access Points) und speichere. 2. Klicke auf „Kopplung starten“. 3. Drücke die blaue Taste oben auf dem Access Point und klicke dann auf „Ich habe die Taste gedrückt“. 4. Füge die Geräte im Tab „Entdecken“ hinzu.
SGTIN des Access PointsstringJa24 Zeichen auf der Unterseite des Access Points und auf seinem Aufkleber, Bindestriche erlaubt.
PIN des Access PointssecretNeinNur wenn du in der Homematic IP App eine PIN festgelegt hast. Dient nur der Kopplung.
Sprache der GerätenamenselectNeinNamen, die den Funktionen neuer Geräte gegeben werden (Temperatur, Solltemperatur, Kontakt…).
Steuerung der AlarmanlageselectNeinWas Gladys mit der Homematic IP Alarmanlage tun darf. Lesen ist immer möglich.

So installierst du Homematic IP in Gladys​

  1. Öffne in Gladys Integrationen: Homematic IP erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-homematicip:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-homematicip.

Homematic IP 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​

Homematic IP 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.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am