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

Installationen: 10.458 teilen Analysedaten
GitHub-Sterne: 606
Verbindung: Funktioniert lokal
Pflege: In den letzten 6 Monaten aktualisiert
Version: 2.12.1, 26. 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: homematicip_local
Quelle: github.com/SukramJ/homematicip_local
Probleme: Problem melden

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

Überblick

Homematic(IP) Local for OpenCCU ist eine benutzerdefinierte Integration, die Home Assistant über das lokale Netzwerk mit Homematic(IP)-Zentralen verbindet. Sie funktioniert mit OpenCCU, CCU2 und CCU3, Debmatic und Homegear, nutzt lokales XML-RPC für die Steuerung und für Push-Statusaktualisierungen sowie JSON-RPC für Namen und Räume und braucht keine Cloud. Geräte erscheinen auf vielen Plattformen, darunter Klima, Abdeckungen, Lichter, Schlösser, Sirenen, Ventile und Update-Entitäten. CCU-Programme können als Tasten-Entitäten importiert werden, und Systemvariablen können ebenfalls abgerufen werden. Ein eingebautes Seitenleisten-Panel bearbeitet Konfigurationswerte von Geräten pro Kanal, prüft Änderungen vor dem Schreiben und kann Parameter auf die Werkseinstellungen zurücksetzen. Weitere Bestandteile sind Dienste für Zeitpläne und den Abwesenheitsmodus beim Klima, Reparaturhinweise bei Verbindungsproblemen, Diagnose und fertige Automation-Blueprints für Tasten-Fernbedienungen. Sie wird in der Home Assistant Oberfläche eingerichtet und braucht ein CCU-Konto mit Administratorrechten.

Zusammenfassung der README und des Codes von SukramJ/homematicip_local, 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.

Erweiterte Einstellungen

Callback-Host (optional)IP-Adresse für CCU-Callbacks. Leer lassen für automatische Erkennung.
Callback-Port (optional)Port für XML-RPC-Callbacks. Leer lassen für automatische Zuweisung.
BefehlswiederholungsversucheMaximale Anzahl Wiederholungsversuche bei vorübergehenden Befehlsfehlern (Timeout, Gerät nicht erreichbar). Auf 0 setzen um Wiederholungen zu deaktivieren.
Befehlsdrosselung (Intervall)Mindestabstand zwischen Gerätebefehlen in Sekunden. Auf 0 setzen um die Drosselung zu deaktivieren. Gewährleistet einen reibungslosen Betrieb bei großen Installationen.
Gerätekonfigurations-Panel deaktivierenDas Gerätekonfigurations-Panel aus der Seitenleiste ausblenden.
Systembenachrichtigungen aktivierenBenachrichtigungen für Verbindungsprobleme und Gerätefehler in Home Assistant anzeigen.
Letzte Helligkeit für Lichter wiederherstellenWenn aktiviert, schalten Lichter mit der letzten Helligkeitsstufe ein, anstatt mit 100%.
Auf allen Netzwerkschnittstellen lauschenAktivieren, wenn Home Assistant in Docker oder einer VM läuft. Erforderlich wenn die IP von HA sich von der Host-IP unterscheidet.
MQTT aktivierenErforderlich für CUxD- und CCU-Jack-Geräteunterstützung. Erfordert MQTT-Broker verbunden mit Home Assistant.
MQTT-PräfixIn CCU-Jack konfiguriertes MQTT-Topic-Präfix. Leer lassen, wenn CCU-Jack MQTT-Bridge nicht verwendet wird.
Experimentelle FunktionenExperimentelle Funktionen aktivieren, um neue Funktionalitäten auszuprobieren. Diese Funktionen können sich ändern oder in zukünftigen Versionen entfernt werden.
Programm-MarkerProgramme nach Marker in der Beschreibung filtern (HAHM, HX, INTERNAL). Leer lassen um alle Programme zu importieren.
Programm-Import aktivierenCCU-Programme als Button-Entitäten importieren, um sie aus Home Assistant auszulösen.
Untergeräte-Entitäten erstellenTeilt Geräte mit mehreren Kanalgruppen in ein Hauptgerät mit Untergeräten auf. Entitäten werden basierend auf ihrer Kanalgruppe dem entsprechenden Untergerät zugeordnet.
Systemvariablen-MarkerSystemvariablen nach Marker in der Beschreibung filtern (HAHM, HX, INTERNAL). Leer lassen um alle Variablen zu importieren.

CCU-Verbindung

CCU Hostname/IP-Adresse
Instanzname der IntegrationEindeutiger Bezeichner für diese Home Assistant Installation. Ermöglicht mehreren Home Assistant Instanzen den gleichzeitigen Zugriff auf dieselbe CCU. Hat keine Beziehung zum CCU-Hostnamen/IP. Nach der Einrichtung nicht ändern — Entitäten würden neu erstellt.
CCU PasswortGroß-/Kleinschreibung beachten. Erlaubte Zeichen: A-Z, a-z, 0-9 und .!$():;#-
Automatische Backend-Erkennung überspringenAktivieren Sie diese Option, wenn Sie nicht-standard Ports verwenden oder wenn die Backend-Erkennung hängt. Sie werden Interfaces und Ports manuell im nächsten Schritt konfigurieren.
CCU BenutzernameGroß-/Kleinschreibung beachten. Benutzer muss die Administratorrolle haben

TLS und Schnittstellenauswahl

Homematic (Bidcos-RF) aktivieren
Homematic-Wired (BidCos-Wired) aktivieren
CCU-Jack aktivieren
Benutzerdefinierte Ports konfigurierenAktivieren um nicht-standard Ports auf der nächsten Seite zu konfigurieren. Andernfalls werden Ports automatisch basierend auf TLS-Einstellung gesetzt.
CUxD aktivieren
Homematic IP aktivieren
TLS verwenden (verschlüsselte Verbindung)TLS für verschlüsselte Kommunikation mit der CCU aktivieren.
TLS-Zertifikat überprüfenDas TLS-Zertifikat der CCU überprüfen. Bei selbstsignierten Zertifikaten deaktivieren.
Heizgruppen aktivieren

OpenCCU-Loom-Daemon (Beta)

Daemon-Hostname/IP
Name der Integrations-Instanz
Daemon-Port (leer = 8119)Wird bei der Verbindung über eine openccu-lite-Box nicht verwendet: Dann gilt der Port des Box-Webservers (443 mit TLS, 80 ohne).
TLS verwenden (HTTPS/WSS)Nur wenn der Daemon HTTPS anbietet (ein Zertifikat ist in seinen north.rest.tls-Einstellungen eingerichtet). Ab Werk spricht der Daemon unverschlüsseltes HTTP auf 8119; mit eingeschaltetem TLS schlägt die Verbindung dann fehl. Über eine openccu-lite-Box bezieht sich TLS stattdessen auf den Webserver der Box.
TLS-Zertifikat prüfen
Untergeräte-Entitäten erstellenTeilt Geräte mit mehreren Kanalgruppen in ein Hauptgerät mit Untergeräten auf. Entitäten werden basierend auf ihrer Kanalgruppe dem entsprechenden Untergerät zugeordnet.

Port-Konfiguration

HM-RF-PortStandard-Ports: 2001 (ohne TLS), 42001 (TLS)
BidCos-Wired-PortStandard-Ports: 2000 (ohne TLS), 42000 (TLS)
HmIP-RF-PortStandard-Ports: 2010 (ohne TLS), 42010 (TLS)
JSON-RPC-PortStandard-Ports: 80 (ohne TLS), 443 (TLS). Auf 0 setzen, um die Standardwerte zu verwenden.
Gruppenpfad
Gruppen-PortStandard-Ports: 9292 (ohne TLS), 49292 (TLS)

CCU-Verbindung erneut authentifizieren

CCU-PasswortGroß- und Kleinschreibung beachten. Erlaubte Zeichen: A-Z, a-z, 0-9 und .!$():;#-
CCU-Benutzername

Verbindung neu konfigurieren

CCU-Hostname/IP-Adresse
CCU-PasswortGroß- und Kleinschreibung beachten. Erlaubte Zeichen: A-Z, a-z, 0-9 und .!$():;#-
CCU-Benutzername

TLS- und Schnittstellenauswahl

Homematic (Bidcos-RF) aktivieren
BidCos-Wired (HM-Wired) aktivieren
CCU-Jack aktivieren
Benutzerdefinierte Ports konfigurierenAktivieren, um auf der nächsten Seite Nicht-Standard-Ports zu konfigurieren. Andernfalls werden die Ports automatisch anhand der TLS-Einstellung gesetzt.
CUxD aktivieren
Homematic IP aktivieren
TLS verwenden (verschlüsselte Verbindung)TLS für die verschlüsselte Kommunikation mit deiner CCU aktivieren.
TLS-Zertifikat überprüfenDas TLS-Zertifikat der CCU überprüfen. Für selbstsignierte Zertifikate deaktivieren.
Gruppen aktivieren (Heizungsgruppen)

Nach der Einrichtung

Callback Hostname/IP-AdresseIP-Adresse für CCU-Callbacks. Leer lassen für automatische Erkennung.
Callback XML-RPC PortPort für XML-RPC-Callbacks. Leer lassen für automatische Zuweisung.
BefehlswiederholungsversucheMaximale Anzahl Wiederholungsversuche bei vorübergehenden Befehlsfehlern (Timeout, Gerät nicht erreichbar). Auf 0 setzen um Wiederholungen zu deaktivieren.
Befehlsdrosselung (Intervall)Mindestabstand zwischen Gerätebefehlen in Sekunden. Auf 0 setzen um die Drosselung zu deaktivieren. Gewährleistet einen reibungslosen Betrieb bei großen Installationen.
Gerätekonfigurations-Panel deaktivierenDas Gerätekonfigurations-Panel aus der Seitenleiste ausblenden.
Systembenachrichtigungen aktivierenPersistente Benachrichtigungen für Systemereignisse wie Netzwerkprobleme oder nicht erreichbare Geräte aktivieren.
Letzte Helligkeit für Lichter aktivierenWenn aktiviert, schalten Lichter mit der letzten Helligkeitsstufe ein, anstatt mit 100%.
Auf allen Netzwerkschnittstellen lauschenAktivieren, wenn Home Assistant in Docker oder einer VM läuft. Erforderlich wenn die IP von HA sich von der Host-IP unterscheidet.
MQTT aktivierenMQTT aktivieren um Callbacks für CCU-Jack und CUxD zu nutzen
MQTT-PräfixDas für die CCU-Jack-Brücke verwendete MQTT-Präfix
Experimentelle FunktionenExperimentelle Funktionen aktivieren, um neue Funktionalitäten auszuprobieren. Diese Funktionen können sich ändern oder in zukünftigen Versionen entfernt werden.
Untergeräte-Entitäten erstellenTeilt Geräte mit mehreren Kanalgruppen in ein Hauptgerät mit Untergeräten auf. Entitäten werden basierend auf ihrer Kanalgruppe dem entsprechenden Untergerät zugeordnet.
UN-IGNORE ParameterSchau in die Dokumentation für Informationen über UN-IGNORE
Cover-Position vom Gruppenkanal meldenGruppenkanal zur Meldung der Cover-Position verwenden. Aktivieren für Abdeckungen, die auf ihren Einzelkanälen falsche Positionen melden.
CCU Hostname/IP-Adresse
CCU PasswortGroß-/Kleinschreibung beachten. Erlaubte Zeichen: A-Z, a-z, 0-9 und .!$():;#-
CCU BenutzernameGroß-/Kleinschreibung beachten. Benutzer muss die Administratorrolle haben
Homematic (Bidcos-RF) aktivieren
Homematic-Wired (BidCos-Wired) aktivieren
CCU-Jack aktivieren
Benutzerdefinierte Ports konfigurierenAktivieren um auf der nächsten Seite nicht-Standard-Ports zu konfigurieren. Andernfalls werden Ports automatisch basierend auf TLS gesetzt.
CUxD aktivieren
Homematic IP aktivieren
TLS verwenden (verschlüsselte Verbindung)TLS für verschlüsselte Kommunikation mit der CCU aktivieren.
TLS-Zertifikat überprüfenDas TLS-Zertifikat der CCU überprüfen. Bei selbstsignierten Zertifikaten deaktivieren.
Heizgruppen aktivieren
HM-RF PortStandard-Ports: 2001 (ohne TLS), 42001 (mit TLS)
BidCos-Wired PortStandard-Ports: 2000 (ohne TLS), 42000 (mit TLS)
HmIP-RF PortStandard-Ports: 2010 (ohne TLS), 42010 (mit TLS)
JSON-RPC PortStandard-Ports: 80 (ohne TLS), 443 (mit TLS). Auf 0 setzen für Standardwerte.
Gruppen-Pfad
Gruppen-PortStandard-Ports: 9292 (ohne TLS), 49292 (mit TLS)
Daemon-Hostname/IP
Daemon-Port (leer = 8119)Wird bei der Verbindung über eine openccu-lite-Box nicht verwendet: Dann gilt der Port des Box-Webservers (443 mit TLS, 80 ohne).
API-Bearer-Token
TLS verwenden (HTTPS/WSS)Nur wenn der Daemon HTTPS anbietet (ein Zertifikat ist in seinen north.rest.tls-Einstellungen eingerichtet). Ab Werk spricht der Daemon unverschlüsseltes HTTP auf 8119; mit eingeschaltetem TLS schlägt die Verbindung dann fehl. Über eine openccu-lite-Box bezieht sich TLS stattdessen auf den Webserver der Box.
TLS-Zertifikat prüfen
openccu-lite-Box-TokenDas API-Token der openccu-lite-Box, mit dem sich dieser Eintrag verbindet (Scope addon:openccu-loom oder Vollzugriff, von der Token-Seite der Box). Füge ein neues ein, um es zu ersetzen; leer gelassen bleibt das gespeicherte Token erhalten.
Nicht-Admin-Benutzern erlauben, Zeitpläne zu bearbeitenWenn aktiviert, können Nicht-Admin-Benutzer Gerätezeitpläne über die Zeitplan-Karten bearbeiten. Admin-Benutzer haben immer vollen Zugriff.
Programm-MarkerKommaseparierte Liste mit Markern für Programme zum Abrufen. Zum Zurücksetzen auf Leerzeichen setzen.
Programm-Scan aktivierenScannen und Abrufen von CCU-Programmen aktivieren
Systemvariablen-MarkerKommaseparierte Liste mit Markern für Systemvariablen zum Abrufen. Zum Zurücksetzen auf Leerzeichen setzen.
Systemvariablen-Scan aktivierenScannen und Abrufen von CCU-Systemvariablen aktivieren
Scan-Intervall (Sekunden)Intervall in Sekunden zwischen Scans für Programme und Systemvariablen

Texte aus dem Code von SukramJ/homematicip_local. Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.

Entitäten

TastenBackup erstellen, Anlernmodus BidCos-RF aktivieren, Anlernmodus HmIP-RF aktivieren
ZahlenVentil-Öffnungsgrad
AuswahlfelderSirenen-Ton, Türmodus, Betriebsmodus, Sirenen-Lichtmuster
SensorenAlarmmeldungen, Carrier Sense Level, Verbindungslatenz, Abdeckungsposition, Lamellenposition, Daemon-Latenz, Richtung, Türzustand, Duty Cycle Level, Energiezähler Einspeisung Gesamt, Energiezähler Gesamt, Posteingang und 20 weitere

Aktionen

Eine Direktverknüpfung erstellenErzeugt eine Direktverknüpfung über die XML-RPC-SchnittstelleFelder: Beschreibung der Direktverknüpfung, Name der Direktverknüpfung, Empfänger Kanaladresse, Sender Kanaladresse
Lösche den CacheLöscht den Cache. Benötigt einen NeustartFelder: Zentrale
Textdisplay löschenLöscht alle Zeilen auf dem HmIP-WRCD Textdisplay
Alle verzögerten Geräte bestätigenBestätigt alle verzögerten Geräte auf einmal und fügt sie zu Home Assistant hinzuFelder: Zentrale
Zeitplan kopierenKopiere einen kompletten Zeitplan von einem Gerät auf ein anderesFelder: Geräteadresse, Quellgerät, Zielgerät
Zeitplan-Profil kopierenKopiere ein Zeitplan-Profil innerhalb eines Geräts oder auf ein anderes GerätFelder: Geräteadresse, Gerät, Quellprofil, Zielgerät, Zielprofil
CCU-Backup erstellenErstellt und lädt ein System-Backup von der CCU herunter. Speichert die Backup-Datei im konfigurierten Backup-Verzeichnis.Felder: Zentrale
Erstellt ZentralenverknüpfungenErstellt Verknüpfungen zur Zentrale, um Tastendruck-Ereignisse zu ermöglichenFelder: Gerät, Zentrale
Deaktiviert den Klima-AbwesenheitsmodusDeaktiviert den Klima-Abwesenheitsmodus
Aktiviert den Klima-Abwesenheitsmodus per KalenderAktiviert den Klima-Abwesenheitsmodus per KalenderFelder: Solltemperatur, Endzeit, Startzeit
Aktiviert den Klima-Abwesenheitsmodus nach DauerAktiviert den Klima-Abwesenheitsmodus nach DauerFelder: Solltemperatur, Stunde
Exportiere Geräte-BeschreibungenExportiert die Beschreibungen eines Gerätes nach 'Dein Home-Assistant Konfigurationsverzeichnis'/homematicip_local/export*Felder: Gerät
Rufe alle Systemvariablen abRuft die Systemvariablen von einer Zentrale abFelder: Zentrale
Geräteverfügbarkeit erzwingenErzwingt die Verfügbarkeit eines Geräts. Dadurch wird der tatsächliche Status überschriebenFelder: Geräteadresse, Gerät
Wert eines Geräte-Parameters lesenLiest den Wert eines Geräte-Parameters über die XML-RPC-SchnittstelleFelder: Kanal, Geräteadresse, Gerät, Parameter
Parametersatz einer Direktverknüpfung lesenLiest den Parametersatz einer Direktverknüpfung über die XML-RPC-SchnittstelleFelder: Empfänger Kanaladresse, Sender Kanaladresse
Partner einer Direktverknüpfung lesenLiest alle Partner einer Direktverknüpfung über die XML-RPC-SchnittstelleFelder: Kanal, Geräteadresse, Gerät
Parametersatz von einem Gerät oder Kanal lesenLiest den gesamten Parametersatz von einem Gerät oder Kanal über die XML-RPC-SchnittstelleFelder: Kanal, Geräteadresse, Gerät, Parametersatz-Schlüssel
Zeitplan abrufenKompletten Zeitplan eines Geräts abrufenFelder: Geräteadresse, Gerät
Zeitplan-Profil abrufenZeitplan-Profil eines Klimageräts abrufenFelder: Geräteadresse, Gerät, Profil

Fehlerbehebung

DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:CCU-Verbindung beeinträchtigt, CCU-Verbindung fehlgeschlagen, Interner CCU-Fehler, CCU-Netzwerkverbindung fehlgeschlagen, CCU-Verbindungszeitüberschreitung, Fehler beim Abrufen von Gerätedaten, XmlRPC-Server empfängt keine Ereignisse

Aus der README

Homematic(IP) Local for OpenCCU is a custom integration for Home Assistant.
Browse all configurable devices grouped by interface
View device details including reachability, RSSI, and firmware
Edit MASTER paramset values per channel with auto-generated forms (sliders, toggles, dropdowns)
Validate changes before writing to the device
Reset parameters to factory defaults

Aus der README von SukramJ/homematicip_local, MIT License. Gekürzt.