Node-RED als Addon für die
Homematic CCU3 und
RaspberryMatic
Click here for 🇬🇧🇺🇸 english readme
RedMatic fasst mehrere Softwarekomponenten zu einem CCU Addon zusammen, einem Softwarepaket, dass auf einer Homematic CCU3 oder RaspberryMatic als Zusatzsoftware komfortabel über das WebUI installiert werden kann.
Die Grundlage bildet Node-RED mit den CCU Nodes für Node-RED. Hiermit ist es auf einfache und visuelle Weise möglich Regeln, Automationen, Scripte und Anbindungen von externen Services und Systemen für ein Homematic System zu realisieren - und das weitgehend auch ohne Programmierkenntnisse. Im Wiki gibt es weitere Informationen zu Node-RED und einige Anwendungsbeispiele (sogenannte Flows).
Die Einrichtung und der Betrieb von RedMatic ist sehr benutzerfreundlich, es bedarf keiner Linux-Kenntnisse und es müssen keine Konfigurationsdateien bearbeitet werden.
Für die Visualisierung und Steuerung sind RedMatic WebApp und Node-RED Dashboard enthalten. RedMatic WebApp ist eine Bedienoberfläche die ohne weitere Konfiguration sofort genutzt werden kann um das Homematic System mit dem PC oder Mobilgeräten zu steuern (vergleichbar mit WebMatic oder Yahui). Node-RED Dashboard ist ein konfigurierbares User Interface, kann mehr Möglichkeiten als die RedMatic WebApp bieten, ist aber mit Konfigurationsaufwand verbunden. Beispiel Screenshots: RedMatic WebApp, Node-RED Dashboard.
Außerdem ist es mit der ebenfalls enthaltenen Erweiterung RedMatic HomeKit ohne weiteren Installations- oder Einrichtungsaufwand möglich Homematic Geräte in Apple HomeKit einzubinden und über Siri und mit HomeKit-Apps anzusteuern. Darüberhinaus können auch beliebige andere an Node-RED angebundene Systeme und Kameras in HomeKit integriert werden.
Eine Anbindung der CCU an einen MQTT Broker mit komfortabel konfigurierbarer Topic- und Payload-Struktur wird durch einen speziellen Node vereinfacht.
Eine große und aktive Community rund um Node-RED hat zudem eine Bibliothek von tausenden zusätzlichen Nodes geschaffen die auf einfache Weise installiert werden können und es ermöglichen spezielle Automatismen zu implementieren und diverse weitere Services und Systeme komfortabel anzubinden - wie z.B. KNX, Xiaomi/Aqara, Loxone, Somfy Tahoma, Velux KLF200, Home Connect Haushaltsgeräte, den Logitech Harmony Hub, verschiedene Smart TVs und AV-Receiver, Sonos, Netatmo, Hue/Lightify/Tradfri, Deconz, ArtNET/DMX, DALI, Modbus, Amazon Alexa, Google Home, diverse Datenbanken wie z.B. InfluxDB oder MySQL, Webservices zur Abfrage von beispielsweise Wetterdaten und vieles mehr.
RedMatic kann damit - insbesondere auch für diejenigen die neben der CCU keinen weiteren Server betreiben möchten - eine Alternative zu einem "ausgewachsenen" Smart Home System wie z.B. Home Assistant oder ioBroker darstellen. Mit RedMatic-HomeKit steht des weiteren eine Alternative zum Betrieb einer Homebridge zur Verfügung die insbesondere bei der Integration von Homematic Geräten in HomeKit einige Vorteile bietet. Auch eine Koexistenz mit vorhandener anderer Smart Home Software kann sinnvoll sein, RedMatic eignet sich z.B. auch sehr gut als Schnittstelle um eine Homematic CCU an ein übergeordnetes System via MQTT anzubinden. Nicht zuletzt kann RedMatic auch als stabile und mit wesentlich mehr Möglichkeiten aufwartende Alternative oder Ergänzung zu den WebUI-Programmen und Scripten der CCU Logikschicht "Rega" dienen.
RedMatic ist nur für die CCU3, piVCCU3 und die RaspberryMatic Varianten rpi2, rpi3, rpi4, tinkerboard, intelnuc und ova geeignet.
Auf der CCU1, CCU2 und der RaspberryMatic Variante rpi0 kann RedMatic nicht verwendet werden.
Unter Releases steht die Datei redmatic-<version>.tar.gz
zum Download zur Verfügung. Nach der Installation des Addons über das Homematic WebUI (Systemsteuerung ->
Zusatzsoftware) und dem darauf folgenden Reboot der CCU ist Node-RED unter http://<ccu-addresse>/addons/red
erreichbar. Bei der Installation ist Geduld erforderlich, es kann bis zu ~10 Minuten dauern. Einige Beispiel-Flows sowie ein einfaches Dashboard sind bereits vorkonfiguriert, das Dashboard ist unter http://<ccu-addresse>/addons/red/ui erreichbar.
Für Feedback jeglicher Art, Fragen, Vorschläge und Wünsche bitte das Diskussionsforum nutzen. Für Bug Reports bitte den Issue Tracker nutzen. Alternativ steht auch ein Chatraum in Slack zur Verfügung.
Beteiligung in jeder Form ist willkommen und gewünscht, insbesondere sind alle Nutzer aufgefordert die Liste erfolgreich getesteter Nodes zu ergänzen, Beispiel-Flows zu veröffentlichen und an der Verbesserung und Erweiterung der Dokumentation mitzuarbeiten.
Es werden keine Spenden angenommen, ich würde mich jedoch darüber freuen wenn der erfolgreiche Einsatz dieser Software mit einem Github Sternchen ⭐️ honoriert wird (Github Account ist schnell angelegt! ;-)
-
Administration
-
Nutzung
-
Spezielle Nodes und Erweiterungen
- node-red-contrib-zigbee - Einbindung von Zigbee Geräten über USB-Interface (z.B. Xiaomi Aqara, Philips Hue, IKEA Tradfri, Osram/Ledvance Lightify, Müller Licht Tint, ...)
- RedMatic-HomeKit - Anbindung an Apple HomeKit, Steuerung via Siri und Home.app
- RedMatic-WebApp
- Node-RED Dashboard
- node-red-contrib-sun-position Zeit- und Sonnenstandabhängige Funktionen, Komfortable Beschattungssteuerung
-
Beispiel Flows
- Kostenlose Alexa (und Google) Anbindung
- Sprachausgabe über Alexa/Echo
- CCU an MQTT anbinden
- Anzahl und Liste offener Fenster im Dashboard anzeigen
- Hue Lampen mit langem Tastendruck dimmen
- UNREACH Meldung unterdrücken
- STICKY_UNREACH Meldungen bestätigen und zählen
- Anzeigen und Setzen von Systemvariablen im Dashboard
- DutyCycle Graph im Dashboard anzeigen
- JSON Daten von Webservice abfragen und in Systemvariable schreiben
- Inhalt einer Systemvariablen über einfachen Webservice bereitstellen
- Per Pushover benachrichtigen wenn Fenster länger als 10 Minuten offen ist
- CPU Auslastung als Graph im Dashboard anzeigen
- Schnelles Blinken der LED im Offline-Betrieb unterbinden
- Bidcos-Wired Dimmer mit Bidcos-RF Tasten steuern
- Discovery von Geräten mit Echo Dot v3 und node-red-contrib-amazon-echo
-
Von Usern bereitgestellte Flows
- Licht mittels Tastendruck aus und einschalten
- Licht schalten mit einem Dashboard button
- Textausgabe mittels Chromecast oder Google Home
- Berechnung von Feiertagen
- Funktion nur innerhalb einer bestimmten Uhr-Zeit ausführen
- Fehlerüberwachung der CCU
- Integration Weatherman (JSON, httpStatic, SteelSeries Gauges)
- Systeminformationen der CCU Zentrale
- Werte in InfluxDB speichern
- Diverse Flows von @Sineos
- Harmony Activities mit Homekit nutzen
- Homekit: Kamera einbinden
- Homekit: Öffnen einer Tür mit Keymatic HM-Sec-Key-(S)
- Nachrichten an Telegram versenden
- Dashbuttons ohne zusätzliche Nodes auswerten
- Monitoring der Batteriespannung von Aktoren (hier: HM-CC-RT-DN)
- Datenpunktstatus von mehreren Geraeten gleichzeitig abfragen
- Rollladen und Jalousiesteuerung
- Zwischen zwei Zeitpunkten jede halbe Stunde einen Inject generieren
- Wetterdaten mittels OpenWeatherMap in ein CUxD Device übertragen
- Schalter mit Statusanzeige
- Pillenförmige-Schalter sychron mit globaler Variable
- Zusätzliche Wettericons für UI-Dashboard in Redmatic verfügbar machen
- E3DC Anbindung per Modbus-TCP
- Steuerung von Miele Geräten
- Subflow für Enigma2 Receiver
- INSTAR Kameras anbinden
- Subflow für Home24-Mediaplayer App
- EASY Push Subflow Push Nachrichten an EASY-Smarthome App oder Smartha App
- Shelly Relais zu Schalten von Leuchten
- Waschmaschine fertig? Waschmaschine mit HmIP-PSM Messsteckdose monitoren
- SMS mit SIM800 Modul: SMS senden & empfangen
- BMW Connect Status in Dashboard und Apple HomeKit
- EgiGeoZone Geofence Subflow: An/abmelden von Geozonen, in Redmatic empfangen
- Xiaomi / Roborock S1-S6 in Dashboard
-
Sonstiges
- RedMatic © 2018-2021 Sebastian Raff and RedMatic Contributors, licensed under Apache License 2.0
- RedMatic Documentation © 2018-2021 Sebastian Raff and RedMatic Contributors, licensed under CC BY-SA License 4.0
- Third Party Licenses
DIE SOFTWARE WIRD OHNE JEDE AUSDRÜCKLICHE ODER IMPLIZIERTE GARANTIE BEREITGESTELLT, EINSCHLIEẞLICH DER GARANTIE ZUR BENUTZUNG FÜR DEN VORGESEHENEN ODER EINEM BESTIMMTEN ZWECK SOWIE JEGLICHER RECHTSVERLETZUNG, JEDOCH NICHT DARAUF BESCHRÄNKT. IN KEINEM FALL SIND DIE AUTOREN ODER COPYRIGHTINHABER FÜR JEGLICHEN SCHADEN ODER SONSTIGE ANSPRÜCHE HAFTBAR ZU MACHEN, OB INFOLGE DER ERFÜLLUNG EINES VERTRAGES, EINES DELIKTES ODER ANDERS IM ZUSAMMENHANG MIT DER SOFTWARE ODER SONSTIGER VERWENDUNG DER SOFTWARE ENTSTANDEN.