Node-RED-Nodes, die Homematic-Geräte und beliebige Node-RED-Daten als HomeKit-Zubehör bereitstellen (HAP-NodeJS). Für RedMatic auf der CCU3 / OpenCCU, funktioniert aber in jeder Node-RED-Installation.
Version 4.0.0 (September 2026) ist die erste Version für RedMatic 9. Was sich gegenüber 3.3.0 ändert, steht im Changelog; bestehende Kopplungen bleiben beim Update erhalten.
- Homematic-Geräte automatisch in HomeKit – über einen node-red-contrib-ccu- ccu-connection Node werden Schalter, Dimmer, Farblichter, Rollläden und Jalousien, Thermostate, Tür-/Fensterkontakte, Griffkontakte, Bewegungs- und Präsenzmelder, Rauch-, Wasser- und Regenmelder, Temperatur-/Feuchte-/Helligkeitssensoren, CO₂-Sensoren, Taster und Fernbedienungen (als programmierbare Schalter), Türschlossantriebe (HmIP-DLD, KeyMatic), Garagentormodule und Batteriestände als HomeKit-Zubehör angelegt. Pro Gerät und Kanal lässt sich im Editor einstellen, ob und als was (Steckdose, Lampe, Lüfter, Ventil, Tür, Fenster, …) ein Kanal erscheint.
- Universal-Node für beliebiges HomeKit-Zubehör (jeder HAP-Service, jede Charakteristik) aus Node-RED-Nachrichten – für Systemvariablen, MQTT, Zigbee2MQTT, Hue und alles andere, was in Node-RED ankommt.
- Switch, Pseudobutton (Schalter, der sich selbst zurücksetzt und eine Nachricht auslöst), Stateless Programmable Switch (Taster-Events aus Nachrichten), Garage und Bewässerung auf Basis von Homematic-Aktoren und -Kontakten, TV (eigenständiges Fernseher-Zubehör mit Fernbedienung im Kontrollzentrum).
RedMatic 9 (CCU3 / OpenCCU): Im Node-RED-Editor unter Palette
verwalten → Installieren nach redmatic-homekit suchen und installieren.
Es werden keine nativen Module und keine Binärprogramme benötigt.
Andere Node-RED-Installationen: npm install redmatic-homekit im
Node-RED-Benutzerverzeichnis (~/.node-red). Voraussetzungen: Node.js
≥ 22.12, Node-RED ≥ 4.
Einrichtung in Kürze:
- Einen homekit bridge-Konfigurationsknoten anlegen (MAC-Adresse und PIN werden vorgeschlagen). Nach dem Deploy zeigt der Knoten den QR-Code zum Koppeln mit der Home-App.
- Den homematic-Node mit der CCU-Verbindung und der Bridge verbinden, im Node die gewünschten Geräte und Kanäle auswählen, deployen.
- In der Home-App Gerät hinzufügen → QR-Code scannen (oder den Einrichtungscode eingeben).
Eine Bridge fasst bis zu 149 Zubehörteile; für mehr Geräte legt man einen zweiten Bridge-Knoten (andere MAC-Adresse, anderer Port) an.
Seit 4.0.0 werden Geräte nicht mehr nur über eine feste Liste erkannt.
Für jeden Kanal ermittelt der Node aus der Gerätebeschreibung der CCU
(den CONTROL-Hinweisen, dem Kanaltyp und den Datenpunktnamen) die
Rolle und daraus den passenden HomeKit-Service. Damit funktionieren auch
Geräte, die es beim Erscheinen dieser Version noch nicht gab, sowie
Homebrew-Geräte (HB-*) und CUxD-Geräte, deren Kanäle einer bekannten
Rolle entsprechen. Für rund 190 Gerätetypen gibt es weiterhin speziell
abgestimmte Module (Thermostat-Logik, Rollladen mit Lamellen, LEDs des
HmIP-BSL, Sirenen, …), die Vorrang vor der generischen Zuordnung haben.
Fehlt ein Gerät in der Liste des homematic-Nodes, bitte ein Issue mit dem
Gerätetyp öffnen – am besten mit einem Auszug der Gerätebeschreibung
(getParamsetDescription), dann lässt sich die Rolle ohne das Gerät
nachrüsten.
Accessories und Services heißen wie Gerät und Kanal in der CCU. Seit 4.1.0
lässt sich im homematic-Node neben jedem Geräte- und Kanalnamen ein
eigener Name für HomeKit eintragen; leer bleibt der CCU-Name. Der Name in
der CCU bleibt unverändert, die Identität des Zubehörs auch (sie hängt an
der Adresse). Zubehör, das schon in der Home-App ist, behält dort seinen
gespeicherten Namen; der HomeKit-Name gilt vor allem für neu hinzugefügte.
Ein Name, der mit einem Buchstaben oder einer Ziffer beginnt und endet
(… 1.OG unten statt … 1.OG (unten)), beseitigt die HAP-NodeJS-Warnung
„has an invalid 'Name' characteristic“ im Log.
HomeKit findet die Bridge per mDNS. Standardmäßig (auto) benutzt die
Bridge einen laufenden avahi-daemon (OpenCCU) über D-Bus und sonst den
eingebauten Responder (offizielle CCU-Firmware, RedMatic). Im
Bridge-Knoten lässt sich das auf ciao, bonjour-hap oder avahi
festlegen, falls ein Netzwerk Probleme macht.
- Kopplungen bleiben erhalten: Die Bridge behält ihre Identität, die
Zubehörteile ihre Zuordnung zu Räumen, Szenen und Automationen. Die
HomeKit-Daten liegen weiterhin in
<userDir>/homekit. - Kamera- und Zigbee-Nodes entfallen (siehe Changelog). Flows mit diesen Nodes lassen sich weiter importieren; die Nodes erscheinen als unbekannter Typ und müssen gelöscht werden. Für Kameras eignen sich Homebridge (homebridge-camera-ffmpeg) oder Scrypted, für Zigbee zigbee2mqtt zusammen mit dem Universal-Node.
- Node.js ≥ 22.12 und Node-RED ≥ 4 werden vorausgesetzt.
- Wiki (deutsch): https://github.com/rdmtc/RedMatic/wiki/Homekit
- Fragen und Fehler: https://github.com/rdmtc/RedMatic-HomeKit/issues
- Mitmachen:
npm ci && npm test– ESLint/Prettier und die Tests (node --test) laufen auch in der CI. Hinweise für Beitragende und KI-Agenten stehen in AGENTS.md.
© 2018–2026 Sebastian Raff und RedMatic-HomeKit-Contributors, lizenziert unter der Apache License 2.0.