Homematic IP Local (HCU) für Home Assistant (Marketplace-Integration)

Installationen: 357 teilen Analysedaten
GitHub-Sterne: 74
Verbindung: Funktioniert lokal
Pflege: In den letzten 6 Monaten aktualisiert
Version: 2.6.1, 27. Oktober 2026
Kategorie: Hubs und Protokolle, Smart-Home-Zentralen
Art: Marketplace-Integration
Marke: Homematic
Voraussetzung: Braucht den Marketplace (HACS bis Home Assistant 2026.10)
Domain: hcu_integration
Quelle: github.com/Ediminator/homematicip-hcu
Probleme: Problem melden

Unabhängiges Verzeichnis, erstellt vom Entwickler von Vulpo. Steht in keiner Verbindung zu Home Assistant oder der Open Home Foundation.

Screenshots Aus der README von Ediminator/homematicip-hcu.

Bridged weather station in the Homematic IP app

Überblick

Homematic IP Local (HCU) verbindet Home Assistant über das lokale Netzwerk mit einer Homematic IP Home Control Unit. Die Integration empfängt Zustandsänderungen und Ereignisse über eine dauerhafte WebSocket-Verbindung und fragt das Netzwerk daher nicht regelmäßig ab. Die Entitäten umfassen Klima, Abdeckungen, Lichter, Schalter, Schlösser, Ventile, Sensoren, Alarme, Sirenen, Updates und mehr, und Gruppen für Raumheizung, Rollläden, Schalten und Licht werden synchronisiert. Zu den Aktionen gehören Partymodus, Urlaubsmodus, Eco-Modus, Kühlmodus, das Abspielen eines Tons, das Einschalten eines Schalters für eine festgelegte Zeit sowie das Erstellen oder Löschen von Benutzernachrichten, die in der Homematic IP App angezeigt werden. Eine HA Entity Bridge, als Alpha gekennzeichnet, stellt Lichter, Schalter und Sensoren von Home Assistant der HCU als virtuelle Geräte zur Verfügung. Die Einrichtung läuft in der Oberfläche entweder mit einer App-Benutzer- oder einer Plugin-Benutzer-Verbindung, und es können mehrere HCU-Geräte hinzugefügt werden.

Zusammenfassung der README und des Codes von Ediminator/homematicip-hcu, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich

Unterstützt

Funktioniert lokal Spricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
Wird automatisch erkannt Home Assistant entdeckt sie im Netzwerk und bietet an, sie hinzuzufügen.
Geräteauslöser Die Geräte können Automationen direkt starten.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.

Stellt bereit

Lichter
Klima
Abdeckungen
Ventile
Schlösser
Alarmanlagen
Schalter
Sensoren

Einrichtung

Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.

Mit Homematic IP HCU verbinden

Hostname oder IP-Adresse
Authentifizierungs-API-Port (Standard: 6969)
WebSocket-API-Port (Standard: 9001)

Mit HCU authentifizieren

Aktivierungsschlüssel

Wird auch beim Ändern der Verbindung abgefragt.

Verbindungsmodus wählen

App-Benutzer — Unterstützt kompletten Konfigurationsumfang (kein Entwicklermodus notwendig). Erfordert die Systemtaste an der HCU.
Plugin-Benutzer — Aktiviert Plugin-Funktionen (Benutzernachrichten, Discover-/Control-Antworten). Erfordert Aktivierungsschlüssel aus HCU WebUI → Entwicklermodus.

App-Benutzer: Verbindung anfragen

HCU SGTIN (wird automatisch erkannt)Die 24-stellige SGTIN deiner HCU, z.B. 3014F711A0001234567890. Wird normalerweise automatisch erkannt – nur manuell eintragen falls das Feld leer ist.

Hersteller auswählen

Auszublendende Hersteller

HCU neu konfigurieren

Hostname oder IP-Adresse
Authentifizierungs-API-Port
WebSocket-API-Port

Verbindungsmodus wählen

Verbindungsmodus
Vorhandene Auth-Tokens behalten
✓ Verbunden
✗ Nicht verbunden
— Nicht konfiguriert

Nach der Einrichtung

✓ Verbunden
✗ Nicht verbunden
— nicht eingerichtet
App-Benutzer
Plugin-Benutzer
DualBridge (App + Plugin)
Nicht konfigurierte Kanäle deaktivierenDeaktiviert Kanäle, die in der Homematic IP App nicht konfiguriert bzw. keinem Raum zugeordnet sind. Diese Kanäle werden in Home Assistant nicht erstellt.
Automatischer Neustart bei GeräteänderungenWenn aktiviert, lädt die Integration automatisch neu, sobald ein Gerät an der HCU entfernt wird oder sich der Name, die Kanalrolle oder die Schaltervisualisierung eines Geräts ändert. Der Neustart dauert ca. 1–2 Sekunden, während derer alle Entitäten kurz als nicht verfügbar angezeigt werden. Deaktiviere diese Option, wenn du automatische Neustarts verhindern und Geräteänderungen manuell verwalten möchtest (z. B. durch einen Neustart von Home Assistant).
Standard-KomforttemperaturLege hier die Komforttemperatur fest, die für den Party-Modus verwendet wird.
Gruppen ausblendenWähle aus, welche Gruppen ausgeblendet werden sollen. Die Gruppennamen findest du in den zusätzlichen Attributen jeder Entität.
Hersteller ausblendenWähle aus, welche Hersteller in Home Assistant ausgeblendet werden sollen.
Erweitertes DebuggingAktivieren, um die vollständigen Rohdaten der HMIP_SYSTEM_EVENT-Ereignisse zu protokollieren. Schalte diese Funktion wieder aus wenn du sie nicht mehr benötigst.
Erweiterte AttributeAktivieren, um zusätzliche Entwickler-Attribute pro Entität anzuzeigen.
Ziel-Temperatur
Enddatum und -uhrzeit
GerätetypDer Gerätetyp bestimmt, welche Entitäts-Felder als Nächstes angezeigt werden.
Licht
Schalter
Energiezähler
Feinstaubsensor
Klima-/Wettersensor
Bewegungs-/Anwesenheitssensor
Tür-/Fensterkontakt
Rauchmelder
Feuchtigkeits-/Wassersensor
Batterie
E-Auto-Ladestation
Netzanschlusspunkt
Wärmepumpe
Klimaanlage (HVAC)
Zu bearbeitendes Gerät
Gerätename
Ein/Aus
Helligkeit
Farbtemperatur
RGB-Farbe
Einschaltdauer (Auto-Aus)
Temperatur
Luftfeuchtigkeit
Helligkeit (Lux)
CO₂
Windgeschwindigkeit
Niederschlag
Sturm
Sonnenschein
Zu entfernende Geräte

Texte aus dem Code von Ediminator/homematicip-hcu. Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.

Entitäten

AlarmanlagenAlarmanlage
BinärsensorenEinbruchalarm, Gefahrenalarm, Urlaubsmodus
TastenIdentifizieren, Gefahrenalarm quittieren
EreignisseTürklingel
AuswahlfelderAktion nach Spannungszufuhr, Akustisches Testsignal, Optisches Testsignal
SensorenInterne Einschaltdauer, Einschaltdauer
SchalterInterne Einschaltdauer verwenden
TexteZutrittsberechtigungs-PIN
UpdatesFirmware

Aktionen

Sound abspielenSpielt eine Sounddatei auf einem kompatiblen Gerät ab (z.B. HmIP-MP3P Türklingel, Alarmsirenen).Felder: Sounddatei, Lautstärke, Dauer
Regelstatus setzenAktiviert oder deaktiviert eine einfache Automationsregel in der HCU.Felder: Regel-ID, Aktiviert
Urlaubsmodus aktivierenAktiviert den systemweiten Urlaubsmodus für alle Heizgruppen bis zu einem bestimmten Zeitpunkt.Felder: Temperatur, Endzeitpunkt
Eco-Modus aktivieren (Dauerabwesenheit)Aktiviert den systemweiten Dauerabwesenheits-Modus (Eco) für alle Heizgruppen.
Abwesenheitsmodus deaktivierenDeaktiviert jeden aktiven Abwesenheitsmodus (Urlaub oder Eco) und stellt die Heizung auf den vorherigen Zeitplan zurück.
Party-Modus aktivierenAktiviert den Party-Modus für eine bestimmte Heizgruppe mit einer bestimmten Temperatur.Felder: Temperatur, Endzeitpunkt, Dauer
Einschalten mit EinschaltdauerSchaltet einen Schalter für eine bestimmte Dauer einFelder: Einschaltdauer
Kühlmodus einstellenAktiviert oder deaktiviert den systemweiten Kühlmodus für alle Heizgruppen.Felder: Kühlung
Sende API BefehlSende einen rohen API-Befehl an die HCU. Mit Vorsicht verwenden, da dies direkten Zugriff auf die API ermöglicht und bei falscher Verwendung unbeabsichtigte Nebeneffekte verursachen kann. Siehe API-Dokumentation von EQ3 für DetailsFelder: Anfrage Pfad, Anfrage Body
User Message erstellenErstellt eine User Message, die in der Homematic IP App angezeigt wird. Siehe die eQ-3 API-Dokumentation für Details.Felder: User Message Kategorie, ID der Benutzernachricht, Titel, Nachricht, Verhaltenstyp
Lösche eine User Message NachrichtLösche eine Zuvor erstelle User Message Nachricht aus der Homematic IP App. Siehe API-Dokumentation von EQ3 für DetailsFelder: ID der Benutzernachricht

Fehlerbehebung

DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.

Aus der README

Custom integration for Home Assistant to control Homematic IP devices locally through the Homematic IP Home Control Unit (HCU).
Community Project: This is a passion project built in personal spare time. Continued development depends on the community. Every bug report, diagnostics file, and piece of user feedback directly shapes what gets improved next.
Local Push Updates: Persistent WebSocket connections push state changes and events instantly without polling your network.
Complete Platform Coverage: Integrates climate, covers, lights, switches, locks, valves, sensors, binary sensors, events, update notifications, selects, numbers, texts, and buttons.
Homematic IP Group Synchronization: Discovers and syncs room heating groups, shutter groups, switching groups, and light groups.
Direct Device Triggers: Native Home Assistant device triggers let you build button automations directly in the visual editor.
Hardware Timing Companions:
Internal On Time: Automatically passes hardware on-time values configured in the Homematic IP app with every turn_on command.
Ramp Time: Configures hardware fade durations for dimmers without requiring a transition parameter on every action.
HA Entity Bridge (Alpha): Exposes Home Assistant entities back into the HCU as virtual devices.
Energy and Metering Support: Integrates power draw and accumulated energy counters directly into the Home Assistant Energy Dashboard.
Multiple Gateways: Add multiple HCU units within a single Home Assistant installation.

Aus der README von Ediminator/homematicip-hcu, MIT License. Gekürzt.