📚Quellen & Hinweise
Alle Fachangaben dieser App stammen aus den folgenden Quellen, abgerufen am 01.10.2026. Musterhaus, Seriennummern (000A1BE9A0000x, XYZ000000x), Kopplungscodes, Kennungen und Adressen (ccu.example.org, 192.0.2.0/24, 198.51.100.0/24) sind erfunden.
🏷️Projekt, Lizenz, Marken
Das Projekt
hap-homematic von Thomas Kluge (thkl), angelegt am 08.03.2020, veröffentlicht unter der MIT-Lizenz. Das Repository ist seit dem 29.05.2026 archiviert. Das Logo stammt laut README von @roe1974.
Marken
HomeMatic und Homematic IP sind Marken der eQ-3 AG. HomeKit, Siri, Apple TV, HomePod und iPhone sind Marken von Apple Inc. Alle weiteren Namen gehören ihren jeweiligen Inhabern.
Diese App
Inoffizielle Lehr-App. Kein Bezug zum Autor des Addons, zu eQ-3 oder zu Apple; keine Gewähr für Richtigkeit oder für die Eignung des Addons. Kurze Auszüge aus dem Quelltext des Addons (MIT-Lizenz, © Thomas Kluge) sind als solche gekennzeichnet.
🔗Das Addon: README, Wiki und Quelltext
Zweck („much like homebridge-homematic but without homebridge“, keine Zusatzhardware), Installation über die Systemsteuerung, HomeKit-Button, CCU2 nicht unterstützt, Ports 9874/9875/9876/9877…n, HTTPS mit dem selbstsignierten CCU-Zertifikat, Anmeldung über die CCU-Benutzerverwaltung (nur Admins), Raumkonzept mit mehreren Bridges, FakeGato-Verlauf nur in der Eve-App
Gliederung der Dokumentation
unterstützt: CCU3 und RaspberryMatic, nicht CCU2; Unterschied zwischen Addon-Version (Installer) und Version in der WebUI (npm-Paket); Internet bei der Erstinstallation
Ablauf mit Neustart der CCU, Firewall-Ports, Aufruf http://<CCU>:9874/, HTTPS und CCU-Benutzerverwaltung, Updates über den gelben Hinweis, debmatic, Betrieb außerhalb der CCU (-C, -H)
HAP kennt keine Räume → eine Bridge je Raum; Instanz anlegen (Name ohne Sonderzeichen, HomeMatic-Raum), PIN aus der Instanzliste, QR-Code ab 0.55
Veröffentlichungseinstellungen, Gerät hinzufügen (Name, Service, Untertyp, Instanz), mehrere Instanzen je Gerät, Einschaltdauer ON_Time, Schalt-Mess-Steckdose (Kanal 3 und 6), Apple TV zeigt nur Szenen, Hue-Geräte der CCU nicht einbinden
Variablen zuordnen, Abfrageintervall, Faktor, Trigger über eine virtuelle Taste und das Hilfsprogramm _hap_autotrigger_, Beispiel Anwesenheit
Programme als HomeKit-Gerät anlegen
Duty Cycle, CCU-Temperatur, Mehrkanal-Taster, HTTP-Aufruf, KeyMatic, Garagentor aus Sensor + Aktor, config.json-Auszug
Einstellungen (CCU-Anmeldung, HTTPS, Monitoring, Cache, Apple-Home-Kompatibilität, Watchdog), Debug, Log-Datei, Support-Datei, Backup/Restore, CCU-Cache-Refresh, Neustart
Dienst stoppen/starten, Start auf der Kommandozeile mit -D, Log- und Crash-Dateien, Cache leeren (evdps.json, persist), JSON-Dateien prüfen, erst im Addon löschen dann in der CCU, ein Port je Instanz, Instanz bereinigen
Kurzbeschreibungen einiger Services, Untertypen Lightbulb/Fan/Switch/Outlet
Portvergabe ab 9877 (powerUpBridges), Bridge-Name „HomeMatic <Name>“, Kopplungscode im Format XXX-XX-XXX (generatePin), Kennung 12:34:56:… (randomMac), Instanz „default“, Auswahl der Service-Klassen je Kanaltyp, kompatible Variablentypen, eigener Port für nicht gebridgte Geräte
Schreiben und Lesen per ReGa-Skript (dom.GetObject(…).State/Value), Variablen und Programme, Wert-Cache, Ereignisserver auf Port 9875, Schnittstellen-Ports 2001/2010/9292 bei entfernter CCU, Hilfsprogramm _hap_autotrigger_, monit-Überwachung
XML-RPC-Server (event, system.multicall, listDevices, newDevices), init() mit Kennung HAP_<Schnittstelle>, BIN-RPC für CUxD auf Port +1, Watchdog, Meldung „port … is in use“
HTTP-POST an Port 8181, Pfad /tclrega.exe, Abschneiden der Antwort bei <xml><exec>, Zeitlimit
Adressformat Schnittstelle.Seriennummer:Kanal.Datenpunkt und der zugehörige reguläre Ausdruck
Kanaltypen (channelTypes), HomeKit-Dienste, Datenpunktnamen und Umrechnungen: Schalter, Dimmer, Rollladen, Thermostate, Kontakte, Thermometer, Bewegungsmelder, Taster, Variablen, Programme, Spezialgeräte
Port 9874, HTTPS mit /etc/config/server.pem, Sitzungsprüfung gegen die CCU (Berechtigungsstufe ≥ 8), Backup als tar.gz des Konfigurationsordners (ohne Dateien *persist.json), deutsche Menütexte (localization/de.json), Texte des Einrichtungsassistenten
Installer läuft nur auf CCU3 und RaspberryMatic, Pfade /usr/local/addons/hap-homematic und /usr/local/etc/config/addons/hap-homematic, Neustart nach Erstinstallation (exit 10), postinstall.sh mit npm i hap-homematic, Operationen uninstall/restart, Installer-Log /var/log/hmhapinstall.log, Datei .nobackup
Optionen -D, -C, -H, -L, --reset, Crash-Datei <Zeit>.crash im Konfigurationsordner, Log /var/log/hap-homematic.log, Debug-Schalter /tmp/.hapdebug
Letzter Eintrag 0.0.63, neue Gerätetypen je Version, Backup-Dateiname mit Datum (0.0.61), Instanz zurücksetzen und Restore mit HomeKit-Zuordnung (0.0.57), QR-Code für neue Instanzen (0.0.55)
Lizenz MIT, Copyright Thomas Kluge
manuelle Installation unter debmatic als systemd-Dienst („work in progress“)
🔗Status, Versionen und Issues
archived: true, letzter Push 29.05.2026, 219 Sterne, 28 Forks, 78 offene Issues, Lizenz MIT, angelegt 08.03.2020; Archivhinweis auf der Repository-Seite: „archived by the owner on May 29, 2026. It is now read-only.“
8 Releases von 0.0.1 (25.03.2020) bis 0.0.14 (06.10.2020); 0.0.14 enthält hap-homematic-0.0.14.tar.gz – das ist der Installer
dist-tag latest = 0.0.63 (22.06.2021), dist-tag beta = 2.0.2 (01.10.2022), 63 veröffentlichte Versionen; 0.0.63 hängt von hap-nodejs ^0.5.7 ab
letzte Code-Änderungen am 04.05.2024, letzter Commit überhaupt am 29.05.2026 (FUNDING.yml)
führt Version 0.0.14 vom 07.10.2020; Beschreibung, Hinweise zu Firewall, HTTPS, Anmeldung und Raumkonzept; die Seite selbst wird laut eigenem Hinweis nicht weitergeführt
Einschätzung des OpenCCU-Maintainers: Addon nicht mehr gepflegt, vom Einsatz wird abgeraten, weil es die Stabilität der Zentrale gefährden könne
Start scheitert mit hap-nodejs 1.1.0, mit 0.12.2 nicht; Nutzerbericht Februar 2026: 0.14.1 läuft unter OpenCCU 3.85.7
Fehlerbild „port 9875 in use“, Crash-Datei, Neustart des Dienstes per SSH, Hinweis auf beschädigten CCU-Cache
Nach Wechsel der IP-Adresse der CCU: Bridges werden per mDNS bekannt gemacht; geholfen hat Entfernen und erneutes Hinzufügen der Instanz
„No Response“, Ansage per IPv4 und IPv6; Abhilfeversuche: hap-nodejs aktualisieren, Instanzen zurücksetzen
Geräte nach Wechsel der Steuerzentrale (Apple TV) nicht erreichbar, Neustart der HAP-Instanz hilft
🔗HomeKit Accessory Protocol und Netz
Umsetzung des HomeKit Accessory Protocol, nicht von Apple zertifiziert; Routen /pair-setup, /pair-verify, /accessories, /characteristics; SRP beim Koppeln, ChaCha20-Poly1305 für die Sitzung; mDNS-Dienst _hap._tcp; EVENT/1.0-Nachrichten; Dateien AccessoryInfo.<ID>.json und IdentifierCache.<ID>.json
MAX_ACCESSORIES = 149 („Maximum number of bridged accessories per bridge“), Fehlermeldung „Cannot Bridge more than 149 Accessories“, Setup-URI X-HM://… für den QR-Code, 8-stelliger Kopplungscode
„maximum of 150 unique accessories (aid) per bridge“, mDNS über UDP 5353, mDNS-Weiterleitung (avahi im Reflector-Modus) bei getrennten Netzen; zugleich Alternative
allgemeines Netzwissen: mDNS arbeitet mit Multicast im lokalen Netzsegment (224.0.0.251 bzw. ff02::fb, UDP 5353) und wird von Routern nicht weitergeleitet
Ablauf in der Home-App: Hinzufügen-Taste → „Gerät hinzufügen“ → Code scannen, Raum zuweisen und benennen
🔗Zentrale (CCU)
Firewall der Zentrale: Dienste XML-RPC-API und Remote-Skript-API mit Vollzugriff/Eingeschränkt/Kein Zugriff, Liste benutzerdefinierter Ports (userports), Modi MOST_OPEN und RESTRICTIVE; Schaltfläche „Firewall konfigurieren“ in der Systemsteuerung
Zentrale, Funk, Schnittstellenprozesse, XML-RPC und ReGaHss im Detail (dort mit eigenen Belegen)
🔗Alternativen
Node-RED-Nodes auf Basis von HAP-NodeJS, die HomeMatic-Geräte als HomeKit-Zubehör bereitstellen; für RedMatic 9 (CCU3/OpenCCU) oder jede Node-RED-Installation; Apache-2.0; nicht archiviert, letzter Push September 2026
ioBroker-Adapter, der Datenpunkte auf HomeKit-Characteristics abbildet; MIT; nicht archiviert
Homebridge-Plugin desselben Autors; ebenfalls archiviert (letzter Push 27.09.2022)
bindet eine CCU/OpenCCU in Home Assistant ein – Voraussetzung, um dessen HomeKit Bridge für HomeMatic-Geräte zu nutzen; MIT; nicht archiviert
🕳️Nicht belegt, gekennzeichnet oder weggelassen
Belegt ist nur, dass die Firewall eine Liste benutzerdefinierter Ports führt. Welches Trennzeichen das Eingabefeld erwartet, war nicht zu belegen – der Planer bietet deshalb mehrere Schreibweisen an.
Das README verlinkt sie; die Adresse lieferte am Abrufdatum „404 Not Found“. Sie wurde deshalb nicht ausgewertet und nicht als Quelle geführt.
Weder Wiki noch Issues des Projekts behandeln das. Der Abschnitt in der Fehlersuche ist als allgemeines Netzwissen gekennzeichnet (RFC 6762, Home-Assistant-Dokumentation).
Steht nicht in der Dokumentation des Addons. Belegt über HAP-NodeJS (MAX_ACCESSORIES = 149) und die Home-Assistant-Dokumentation; die HAP-Spezifikation von Apple selbst wurde nicht eingesehen.
Genannt werden nur SRP beim Koppeln und ChaCha20-Poly1305 für die Sitzung, soweit im Quelltext von HAP-NodeJS nachlesbar. Weitere Details der HAP-Spezifikation wurden weggelassen.
Dass Apple TV oder HomePod Fernzugriff und Automationen übernehmen, ist allgemeines HomeKit-Wissen und in der App so gekennzeichnet; es wurde nicht mit einer Apple-Quelle belegt.
Belegt ist nur, dass HAP-NodeJS nicht von Apple zertifiziert ist. Der Wortlaut des Hinweises in der Home-App wurde nicht belegt und deshalb nicht zitiert.
README und Wiki sagen nur „via system preferences“. Der Pfad entspricht der üblichen Bedienung der CCU-WebUI; belegt sind die Schaltfläche „Firewall konfigurieren“ und die Operationen „uninstall“/„restart“ des Addons.
Es gibt keine belegten Zahlen zu Speicher- oder CPU-Bedarf. Die Aussage, dass ein zusätzlicher Node.js-Dienst auf der Zentrale läuft, ist eine Folgerung aus dem Aufbau.
Die App zeigt eine Auswahl von Service-Klassen mit ihren Kanaltypen. Eine vollständige Geräteliste führt das Projekt selbst nicht; sie wurde nicht rekonstruiert.
Ausgewertet wurde der Zweig master des Repositorys. Er trägt die Versionsnummer 0.0.63, enthält aber Änderungen bis Mai 2024, die nie als npm-Version „latest“ erschienen sind (u. a. hap-nodejs 0.11.1 statt ^0.5.7). Einzelne Details können deshalb von einer installierten 0.0.63 abweichen.
Das Addon wurde für diese App nicht auf einer Zentrale installiert. Alle Abläufe stammen aus Dokumentation und Quelltext, nicht aus einem eigenen Versuch.
🧮Eigene Modelle dieser App
- Konfigurationsseite: vereinfachter Nachbau mit einem erfundenen Musterhaus – kein Abbild der echten Oberfläche.
- Ereignis-Debugger: Schrittfolge aus dem Quelltext abgeleitet; die Schritte innerhalb der Zentrale und per Funk sind bewusst grob.
- HAP-Nutzlasten (aid/iid) sind Beispielwerte.
- Port-Planer: bildet die Vergabereihenfolge des Quelltexts nach; die Verteilung auf Bridges ist eine einfache Rechenregel.
- Entscheidungsbaum in der Fehlersuche: eigene Zusammenfassung.