Skip to content
Node-RED packaged as Addon for the Homematic CCU3 and RaspberryMatic đŸ€č‍♂
HTML JavaScript Shell Other
Branch: master
Clone or download
Latest commit 48eb351 Dec 5, 2019

README.md


Current Release Dependencies Status Installs

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. Die Einrichtung und der Betrieb von RedMatic ist sehr benutzerfreundlich, es bedarf keiner Nutzung der Linux-Kommandozeile und es mĂŒssen keine Konfigurationsdateien o.Ä. bearbeitet werden. Im Wiki gibt es weitere Informationen zu Node-RED und einige Anwendungsbeispiele (sogenannte Flows).

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, 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. ioBroker, Home Assistent, OpenHAB oder FHEM 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.

Voraussetzungen

RedMatic ist nur fĂŒr die CCU3 und RaspberryMatic geeignet. Da RedMatic unter UmstĂ€nden ĂŒber 200MB Speicher benötigt ist es ratsam einen RaspberryPi mit 1GB RAM zu nutzen (ab Pi 2B). Auf der CCU1/2 kann RedMatic nicht verwendet werden.

FĂŒr die Nutzung der WeboberflĂ€chen ist ein moderner Browser notwendig, der Internet Explorer wird nicht unterstĂŒtzt.

Schnellstart

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.

Support, Mitarbeit

FĂŒr Feedback jeglicher Art, Fragen, VorschlĂ€ge, WĂŒnsche und Fehlerberichte bitte den Issue Tracker nutzen. Alternativ steht auch Slack und ein Unterforum im Homematic-Forum 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! ;-)

Dokumentation

Webseite

Eine Webseite fĂŒr das Projekt befindet sich derzeit im Aufbau. Wer einen Blick riskieren möchte: https://dev.redmatic.de - Hilfe ist willkommen und gewĂŒnscht! :-)

Lizenzen

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.

You can’t perform that action at this time.