HomeMatic in Apple HomeKit – das Addon hap-homematic
Ein Addon für CCU3 und RaspberryMatic, das angelernte HomeMatic- und Homematic-IP-Geräte als HomeKit-Zubehör bereitstellt – ohne Homebridge und ohne zusätzliche Hardware. Diese App zeigt, wie es aufgebaut ist, wie man es installiert und einrichtet, welche Ports es braucht und wie aus LEVEL 0.6 in der Home-App „60 %“ wird.
thkl/hap-homematic wurde am 29.05.2026 vom Eigentümer archiviert und ist nur noch lesbar. Die letzte veröffentlichte Version des Dienstes ist 0.0.63 vom 22.06.2021. Es gibt keine Fehlerbehebungen und keine neuen Gerätetypen mehr. Bestehende Installationen laufen weiter, solange die Zentrale und ihre Node.js-Version mitspielen. Diese App erklärt das Addon so, wie es dokumentiert ist – ob du es heute noch neu einsetzt, entscheidest du am besten nach der Seite Status & Alternativen.🏗️Architektur: wer spricht mit wem?
Klick auf einen Baustein zeigt die Erklärung. Aufbau nach README, Wiki und Quelltext des Projekts.
Service-Klassen
Das Herzstück: 71 Klassen übersetzen HomeMatic-Kanäle in HomeKit-Dienste – HomeMaticDimmerAccessory macht aus LEVEL 0.0–1.0 eine Lampe mit Brightness 0–100 %, HomeMaticRadiatorThermostatAccessory aus SET_POINT_TEMPERATURE ein Thermostat. Welche Klasse zu welchem Kanaltyp passt, zeigt das Mapping-Labor.
🧾Der Weg eines Befehls in einer Zeile
Home-App ──HAP (IP, Port 9877+n)──> Bridge ──> Service-Klasse ──ReGa-Skript (HTTP 8181)──> ReGaHss ──> rfd/HMIPServer ──Funk──> Gerät Home-App <──HAP-Ereignis────────── Bridge <── Service-Klasse <──XML-RPC event (Port 9875)────────────── rfd/HMIPServer <─Funk── Gerät
⚖️Mit Homebridge und Extra-Hardware – oder als Addon auf der Zentrale?
| Thema | Homebridge + Plugin auf eigenem Rechner | hap-homematic als CCU-Addon |
|---|---|---|
| Wo läuft es? | Auf einem eigenen Rechner (z. B. Raspberry Pi) neben der Zentrale | Direkt auf der CCU3 bzw. RaspberryMatic – keine Zusatzhardware |
| Installation | Homebridge einrichten, Plugin installieren, Konfigurationsdatei pflegen | Eine Datei über „Zusatzsoftware“ einspielen, Zentrale neu starten |
| Konfiguration | Plugin-Konfiguration der Homebridge | Eigene Web-Oberfläche auf Port 9874, erreichbar aus der Systemsteuerung |
| Zugriff auf die Zentrale | Über das Netz: XML-RPC- und Skript-API müssen in der Firewall der Zentrale erreichbar sein | Lokal über 127.0.0.1; nach außen offen sein müssen nur 9874 und die HAP-Ports |
| Räume | Geräte einer Bridge landen im Raum der Bridge und werden von Hand verteilt | Eine Bridge je Raum – neue Geräte landen gleich im richtigen Raum |
| Last | Belastet die Zentrale nicht | Node.js-Dienst läuft zusätzlich auf der Zentrale |
| Stand 01.10.2026 | homebridge-homematic (derselbe Autor) ist ebenfalls archiviert | Archiviert seit 29.05.2026, letzte npm-Version von 2021 |
Die rechte Spalte folgt README und Wiki des Addons. Die linke Spalte beschreibt den üblichen Betrieb einer Homebridge auf einem eigenen Rechner (allgemeines Wissen, nicht aus der Addon-Dokumentation); die Zeile „Last“ ist eine Folgerung aus dem Aufbau, keine Messung.
🧭Kapitel
Installation
Assistent in neun Schritten: Voraussetzungen, Zusatzsoftware, Firewall, Bridges koppeln – dazu Update, Backup, Neustart und Deinstallation.
Konfiguration
Die Config-WebUI zum Ausprobieren: Instanzen je Raum, Kanal → Service, Variablen, Programme, Spezialgeräte, Einstellungen – mit live erzeugter config.json.
Ereignis-Debugger
Vom Tippen in der Home-App bis zum Aktor und zurück: HAP-Befehl, ReGa-Skript, Funk, RPC-Ereignis – Schritt für Schritt mit den echten Nutzlasten.
Mapping-Labor
Datenpunkte verstellen und sehen, was HomeKit daraus macht: LEVEL 0.0–1.0 → Brightness, SET_POINT_TEMPERATURE → Thermostat, STATE → Kontakt.
Port- und Bridge-Planer
Instanzen eingeben, Ports 9877+n berechnen, Firewall-Liste kopieren, Geräte auf Bridges verteilen – mit Warnung an der Grenze von 149 Geräten.
Fehlersuche
„Keine Antwort“, Seite nicht erreichbar, Absturz, Variable ohne Aktualisierung – Prüfschritte nach Wiki und Issues, Protokoll und Debug-Modus.
Status & Alternativen
Archiviert seit 29.05.2026: Was heißt das für Betrieb und Updates? Zeitleiste, Versionsnummern und belegte Alternativen.
Quellen
Alle Belege mit Abrufdatum, Lizenz, Markenhinweise – und die Liste dessen, was sich nicht belegen ließ.
🔢Vier Zahlen, die man kennen sollte
Port der Konfigurationsseite. 9875 ist der Ereignisserver, 9876 der für CUxD.
Port der HAP-Instanz n. Jede Bridge braucht ihren eigenen – und ihre eigene Firewall-Freigabe.
So viele Geräte lässt HAP-NodeJS höchstens hinter einer Bridge zu (MAX_ACCESSORIES).
Letzte Version des Dienstes (22.06.2021). Der Installer trägt die Nummer 0.0.14.
Wie die Zentrale selbst funktioniert – Funk, Duty Cycle, Kanäle, Datenpunkte, XML-RPC – erklärt die Grundlagen-App VisualHomematic ↗.