Homematic IP mit Apple Home verbinden: CCU3 & HomeKit

Homematic IP lässt sich über eine Software-Bridge in Apple Home einbinden. In unserem Kundenprojekt läuft der Weg von der CCU3 über Home Assistant zur HomeKit Bridge. Damit erscheinen ausgewählte Rollläden, Thermostate, Leuchten und Sensoren in der Home-App und lassen sich dort bedienen.

Die Anleitung richtet sich an eine Installation mit CCU3 und einem zusätzlichen Rechner für Home Assistant, bei uns einem Raspberry Pi. Ein Homematic IP Access Point ist eine andere Zentrale und braucht einen anderen Integrationsweg. Diese Unterscheidung ist wichtiger als die Frage, welche App zuerst installiert wird.

Überarbeitet am 10. November 2026: Zentralen-Auswahl, Einrichtung und Fehlersuche aktualisiert. Die beschriebenen Geräteerfahrungen stammen aus dem ursprünglichen Kundenprojekt; sie sind kein erneuter Hardwaretest aller aktuellen Versionen.

Welche Zentrale hast du: CCU3 oder Access Point?

Die Hersteller-FAQ beschreibt für Access Point und CCU3 keine native HomeKit-Anbindung. Die zusätzliche Bridge übernimmt daher die Übersetzung zu Apple Home. Homematic IP: FAQ

Für den Access Point dokumentiert Home Assistant die Integration HomematicIP Cloud. Deren API-Anbindung ist nicht offiziell vom Hersteller dokumentiert; außerdem weist das Projekt auf mögliche IP-Sperren bei zu häufigen Cloud-Zugriffen hin. Die CCU3-Schritte unten lassen sich deshalb nicht einfach durch Eintragen der Access-Point-Adresse übernehmen. Hinweis des Integrationsteams

Der kurze Weg von der CCU3 zu Apple Home

Der Ablauf für unser Setup besteht aus fünf Schritten:

1. Home Assistant bereitstellen, etwa auf einem Raspberry Pi.
2. CCU3 anbinden, damit die relevanten Geräte zunächst in Home Assistant funktionieren.
3. Schalten, Zustände und Rollladenpositionen prüfen, bevor eine weitere Bridge dazukommt.
4. HomeKit Bridge einrichten und gezielt die gewünschten Entitäten auswählen.
5. Die Bridge in Apple Home koppeln und denselben Funktionstest dort wiederholen.

Die Reihenfolge erleichtert die Fehlersuche: Reagiert ein Rollladen bereits in Home Assistant nicht, wird die Home-App das Problem nicht lösen.

Ausgangslage: ein gemischtes Homematic- und Wired-Projekt

Das Kundenprojekt umfasst eine CCU3, Heizkörper- und Raumthermostate, Fensterkontakte, Wassermelder sowie Licht, Dimmer, Markise und Bus-Aktoren. Besonders wichtig waren drei HmIPW-DRBL4-Jalousieaktoren für neun Rollläden.

Zunächst haben wir Homebridge ausprobiert. Bei den Wired-Rollläden stießen wir auf Grenzen der damals getesteten Plugins. Mit Home Assistant und der lokalen Homematic-Integration wurden schließlich 76 Geräte mit ihren CCU3-Namen erkannt. Diese Zahl beschreibt den Gerätebestand in Home Assistant, nicht automatisch die Zahl der nach Apple Home exportierten Accessories.

Das Ziel war eine zusätzliche, verständliche Bedienoberfläche. Die bestehende CCU-Konfiguration sollte erhalten bleiben.

Home Assistant auf dem Raspberry Pi bereitstellen

Die CCU3, der Pi und die Apple-Geräte müssen sich im vorgesehenen lokalen Netz erreichen können. Im Projekt hing der Pi anfangs direkt am Mac und hatte eine Adresse aus dem Bereich 169.254.x.x. Die CCU3 lag im Heimnetz. Diese getrennte Ausgangslage musste zuerst korrigiert werden.

Für ein dauerhaft betriebenes System würde ich dem Pi eine feste DHCP-Zuordnung geben und die Erreichbarkeit beider Geräte prüfen. Die Beispieladressen aus einem fremden Netzwerk sind keine Vorgabe für das eigene Zuhause.

Home Assistant OS oder Container?

Für einen Rechner, der ausschließlich Home Assistant betreibt, ist Home Assistant OS ein möglicher Einstieg. Unser Pi sollte sein vorhandenes Debian behalten; deshalb lief Home Assistant als Container. Die Unterschiede und aktuellen Voraussetzungen stehen in der offiziellen Installationsanleitung.

Dieses reduzierte Beispiel setzt einen Linux-Rechner mit bereits eingerichtetem Docker voraus:

sudo docker run -d \
  --name homeassistant \
  --restart=unless-stopped \
  --network=host \
  -v /opt/homeassistant:/config \
  --env TZ=Europe/Berlin \
  ghcr.io/home-assistant/home-assistant:stable

Die Oberfläche ist nach dem Start unter http://<pi-ip>:8123 erreichbar. Das Verzeichnis /opt/homeassistant enthält die persistente Konfiguration und gehört ins Backup. Die vollständige Container-Anleitung enthält weitere Optionen, etwa für zusätzliche Hardware; für diesen CCU-Netzwerkweg wird kein direkt angeschlossener Funkstick vorausgesetzt. Home Assistant Container unter Linux

CCU3 mit Homematic(IP) Local verbinden

Im Projekt verwenden wir die Community-Integration Homematic(IP) Local, inzwischen unter dem Namen Homematic(IP) Local for OpenCCU dokumentiert. Sie unterstützt unter anderem die CCU3. Steuerung und Zustandsmeldungen laufen lokal über XML-RPC, Namen und Räume über JSON-RPC. Das separat installierbare CCU-Addon XML-API ist etwas anderes und für diesen Integrationsweg keine Voraussetzung. Projekt und Installationshinweise

Für die Einrichtung:

1. Die Integration über den zur Home-Assistant-Version passenden Installationsweg hinzufügen. Die aktuelle Projektdokumentation nennt den Marketplace; bei älteren Installationen erfolgt dies über HACS.
2. Nach einem erforderlichen Neustart unter Einstellungen → Geräte & Dienste → Integration hinzufügen nach der Homematic-Integration suchen.
3. Die tatsächliche CCU-Adresse und die erforderlichen CCU-Zugangsdaten eintragen.
4. Die für die eingesetzten Geräte benötigten Schnittstellen auswählen und die Entitäten prüfen.

Vor einem Update lohnt sich der Blick auf die Mindestversionen von Home Assistant und CCU-Firmware. Eine aktuelle Integrationsversion passt nicht zwangsläufig zu einer älteren Installation.

Bei Verbindungsproblemen sind CCU-Firewall, Authentifizierung und Rückverbindungen zu prüfen. Zugriffe sollten auf die benötigten Schnittstellen und den Home-Assistant-Rechner begrenzt werden. Eine pauschale Freigabe der gesamten CCU oder das Abschalten der Authentifizierung ist keine notwendige Grundeinstellung. Die Integrationsdokumentation nennt die benötigten Ports und empfiehlt XML-RPC-Authentifizierung.

HomeKit Bridge einrichten und in Apple Home koppeln

In Home Assistant HomeKit Bridge hinzufügen. HomeKit Device verfolgt die umgekehrte Richtung: Damit werden HomeKit-Geräte in Home Assistant aufgenommen.

Für den ersten Test nur wenige benötigte Entitäten freigeben, etwa ein Licht, einen Rollladen und ein Thermostat. Anschließend in Apple Home Gerät hinzufügen wählen und den von Home Assistant bereitgestellten Kopplungscode verwenden. Die Bridge lässt sich danach schrittweise erweitern. HomeKit Bridge: Einrichtung und Filter

Ein Heizgerät kann mehrere Messwerte und Funktionen liefern; ein Bus-Aktor kann zahlreiche Kanäle besitzen. Deshalb ist „alle Entitäten exportieren“ kein guter erster Test. Es erschwert die Zuordnung, erzeugt unter Umständen doppelte Bedienelemente und kann das Bridge-Limit erreichen.

Für Automationen in Apple Home, das Teilen der Steuerung und den Zugriff von unterwegs gehört eine passende Apple-Steuerzentrale zur Planung, beispielsweise HomePod oder Apple TV. Home Assistant kann eigene Automationen unabhängig davon ausführen, ersetzt aber nicht alle Aufgaben einer Apple-Steuerzentrale. Apple: Home Hub einrichten

Was bei Homebridge und den Wired-Rollläden passiert ist

Homebridge war unser erster Versuch. Die Erfahrungen aus diesem Abschnitt beziehen sich auf die damaligen Plugins und Versionen, nicht auf sämtliche heutigen Homebridge-Lösungen.

Zu viele Accessories

Im ersten Import landeten auch virtuelle und unbenutzte Kanäle in der Bridge. Das verwendete Setup meldete:

Error: Cannot Bridge more than 149 Accessories

Beim Plugin homebridge-homematic lässt sich die Auswahl über ein CCU-Gewerk und den Parameter subsection begrenzen. Ein Gewerk namens Homekit enthält dann nur die tatsächlich benötigten Kanäle. Die Auswahl muss zum Gerät und seiner Funktion passen; eine pauschale Kanalnummer für alle Schalter oder Thermostate wäre irreführend. Plugin-Dokumentation zur Kanalauswahl

Die aktuelle Home-Assistant-Dokumentation nennt ein Maximum von 150 Accessories pro Bridge und beschreibt mehrere Bridges für größere Bestände. Die historische Homebridge-Fehlermeldung oben sollte nicht als universelle Zählregel für jede Implementierung gelesen werden. HomeKit Bridge: Device Limit

HmIPW-DRBL4 wurde angezeigt, reagierte aber nicht

Das getestete Plugin kannte die Zuordnung für den Wired-Jalousieaktor nicht. Eine manuell ergänzte Service-Zuordnung ließ die Geräte erscheinen, machte sie aber noch nicht bedienbar. Die zugrunde liegende Implementierung passte nicht zu den benötigten Datenpunkten.

Weitere Plugin-Versuche lösten das Problem in unserem Setup ebenfalls nicht. Einen Umweg über CCU-Systemvariablen und zusätzliche Programme haben wir verworfen, weil er die Wartung unnötig verkompliziert hätte.

Mit Home Assistant funktionierten die benötigten Rollladenpositionen. Daraus folgt eine praktische Prüfregel: Ein sichtbares Gerät ist noch kein erfolgreich integriertes Gerät. Entscheidend sind Steuerbefehl, Rückmeldung und der Abgleich mit dem realen Zustand.

„Keine Antwort“: den Fehler an der richtigen Stelle suchen

Bei Netzwerksegmenten oder Gast-WLANs kann die Erkennung scheitern, obwohl die Weboberfläche erreichbar ist. HomeKit nutzt unter anderem mDNS; die Erreichbarkeit einer HTTP-Seite beweist deshalb noch keine funktionierende Bridge-Kommunikation. Die HomeKit-Fehlerhilfe beschreibt typische Kopplungs- und Netzwerkprobleme.

Ich würde nicht mit dem Zurücksetzen aller Geräte beginnen. Erst feststellen, welcher Übergang ausfällt, dann dort eine Änderung vornehmen und erneut testen.

Welche Funktionen im Projekt nutzbar wurden

Zusätzliche Messwerte in Home Assistant werden nicht zwangsläufig von der Apple-Home-Oberfläche dargestellt. Insbesondere sollte man aus einem Energie-Messwert in Home Assistant keine zugesicherte Stromverbrauchsanzeige in Apple Home ableiten.

Häufige Fragen

Kann ich Homematic IP direkt mit Apple Home verbinden?

Für den hier beschriebenen CCU3-Weg wird eine Bridge benötigt. Ein QR-Code auf einem Homematic-Gerät ist nicht automatisch ein HomeKit-Kopplungscode. Gekoppelt wird in dieser Anleitung die von Home Assistant erzeugte HomeKit Bridge.

Geht es auch mit dem Homematic IP Access Point?

Dafür gibt es einen separaten Weg über HomematicIP Cloud. Er hat andere Voraussetzungen und Abhängigkeiten. Die CCU3-Zugangsdaten und XML-RPC-Konfiguration aus diesem Artikel gelten dafür nicht.

Brauche ich gleichzeitig Homebridge und Home Assistant?

Für unser finales Setup nicht. Home Assistant übernimmt die Homematic-Anbindung und stellt selbst die HomeKit Bridge bereit. Dasselbe Gerät parallel über beide Systeme zu exportieren, würde die Zuordnung unnötig erschweren.

Muss ich meine Geräte von der CCU3 ablernen?

Für die hier beschriebene Anbindung bleiben sie an der CCU3 angemeldet. Home Assistant verbindet sich mit der vorhandenen Zentrale. Das ist keine Migration des Funk- oder Wired-Systems zu Apple.

Was passiert, wenn Home Assistant ausfällt?

Die zusätzliche Bedienung über diese Bridge fällt aus. Vorhandene CCU-Programme und Geräte-Direktverknüpfungen folgen ihren eigenen Abhängigkeiten. Welche Grundfunktionen im konkreten Haus erhalten bleiben, sollte durch einen geplanten Ausfalltest geprüft werden.

Bei uns war die Trennung der Zuständigkeiten entscheidend: Die CCU verwaltet die Homematic-Geräte, Home Assistant verbindet die Systeme, Apple Home bietet die gewünschte Bedienung. Wie solche Grenzen auch in Softwareprojekten helfen, beschreibt der Artikel über modulare Webarchitektur.