Open Source Ecosystems

** Das alternative/freie Betriebssystem fr Ihre HomeMatic CCU**

Bei RaspberryMatic handelt es sich um ein alternatives, freies und nicht-kommerziell vertriebenes OpenSource Betriebssystem fr die kommerziell erhltlichen CCU3 bzw. ELV Charly SmartHome-Zentralen zur Nutzung von HomeMatic/BidCos-RF bzw. homematicIP Hardware der Firmengruppe eQ-3/ELV. RaspberryMatic hat sich zum Ziel gesetzt nicht nur den kompletten Funktionsumfang einer sogn. HomeMatic CCU SmartHome-Zentrale fr eine Cloudfreie Nutzung von HomeMatic Gerten fr frei erhltliche Single-Board-Computern (SBC) wie z.B. den RaspberryPi, ASUS Tinkerboard oder aber auch als virtualisierte Variante fr moderne Virtualisierungsumgebungen (z.B. vmWare ESXi, Proxmox, VirtualBox, Docker/OCI, Kubernetes/K8s, etc.) nutzbar zu machen. Es hat sich auch zum Ziel gesetzt auf verschiedenen Ebenen (WebUI, Linux-Betriebsystem, etc.) Verbesserungen bzw. Bugfixes mitzubringen die in der originalen CCU Firmware von eQ3/ELV (noch) nicht vorhanden sind.

mehr...

🍪 Features

RaspberryMatic ist systembedingt zu der Betriebssystemsoftware einer CCU-Zentrale der Firma eQ3/ELV (CCU2/CCU3) (die den gleichen Versionsstand hat) 100% kompatibel. Dies bedeutet, das nicht nur die selben HomeMatic/homematicIP Gerte angelernt/genutzt werden knnen, auch verhlt sich RaspberryMatic in Punkto Funktionalitt und WebUI vollkommen kompatibel. Des Weiteren kann die komplette Konfiguration zwischen der Standard Betriebssystemsoftware von eQ3/ELV und RaspberryMatic ausgetauscht werden und ein Wechsel zwischen den beiden Betriebssystemen ist jederzeit mglich.

Darber hinaus bringt RaspberryMatic jedoch eine ganze Reihe von Verbesserungen/Erweiterungen, neuen Features und teilweise bereits integrierten Bugfixes mit sich die entweder noch nicht in der originalen CCU Firmware von der Firma eQ3/ELV bernommen wurde oder aus kommerzieller Sicht nicht bernommen werden soll.

mehr...

💻 Voraussetzungen

RaspberryMatic lsst sich auf folgender, kommerziell erhltlicher Kompletthardware (Rechner + HomeMatic-Kommunikationsmodul) installieren:

CCU3, ELV-Charly

...oder auf folgender selbst zusammengestellter Hardware:

Hardware:

bzw. unter folgenden Virtualisierungsumgebungen installieren:

Virtualisierungsumgebung:

mehr...

☁️ Schnellstart

Unter Releases steht fr die jeweilige Target-Hardware Dateien im Format RaspberryMatic-X.XX.XX.YYYYMMDD-XXX.zip als Download zur Verfgung. Nach Entpacken dieser Datei erhlt man eine *.img Imagedatei die man auf ein geeignetes Medium (SD-Karte, USB-Stick, SSD oder als virtuelle Disk) mit z.B. dem Imaging-Tool Etcher "flashen" lassen kann. Danach legt man z.B. die SD Karte in den jeweiligen RaspberryPi ein und startet diesen. Danach sollte dann RaspberryMatic starten und versuchen im Laufe des Startes das passende HomeMatic/homematicIP Funkmodul zu initialisieren (das man vorher installiert hat). Ist dies erfolgt kann man mittels Webbrowser in seinem lokalen Netzwerk unter Nutzung der Adresse http://homematic-raspi/ auf die Weboberflche (WebUI) von RaspberryMatic normal zugreifen und HomeMatic/homematicIP Gerte anlernen, konfigurieren oder bedienen.

mehr...

📝 Dokumentation

😋 Support, Mitarbeit

Fr Feedback jeglicher Art, Fragen, Vorschlge, Wnsche und Fehlerberichte wird darum gebeten bitte zuerst im jeweiligen RaspberryMatic Teil des HomeMatic-Forum (https://homematic-forum.de/forum/viewforum.php?f=65) einen entsprechenden Beitrag zu erstellen oder an bereits existierenden Beitrgen dort sich zu beteiligen. Sollte aus den Diskussionen dort sich dann ein spezieller Feature-Wunsch oder von anderen Personen besttigter Bug in RaspberryMatic herauskristallieren wird darum gebeten diesen Bug bzw. diesen Feature-Request im Issue Tracker von RaspberryMatic entsprechend einzutragen bzw. zu melden.

Beteiligung in jeder Form ist willkommen und ausdrcklich gewnscht, insbesondere sind alle Nutzer aufgefordert etwaige Probleme so frh wie mglich zu melden damit diese in zuknftigen Versionen entsprechend repariert werden knnen. Auch wre es schn wenn noch offene Issues im Issue Tracker von vielen Nutzern reproduziert werden knnte und man sich dort an etwaigen Diskussionen zur Lsungsfindung beteiligen wrde. Ausdrcklich erwnscht ist auch an der permanenten Verbesserung und Erweiterung der Dokumentation mitzuarbeiten. Deshalb sind die Schreibrechte fr die Dokumentation auch so gesetzt das dort Korrekturen/nderungen von jedem GitHub Nutzer sofort durchgefhrt werden knnen.

Erwnscht sind natrlich auch direkte Entwicklungsbeteiligungen in Form von PullRequests und Source Code submissions (Bugs, Features). Falls hier jemand also gerne ein Feature umsetzen oder einen Bug selbst ausmerzen will, so wird darum gebeten hierfr die unter Git/GitHub zur Verfgung stehenden Mechanismen zu verwenden. Hierbei gilt jedoch die Lizenzierung von RaspberryMatic und dessen genutzter Drittpakete (z.B. OCCU von eQ3) zu beachten und entsprechend zu akzeptieren. Mehr Informationen dazu kann man unter CONTRIBUTING.md nachlesen. Zustzlich dazu wird darum gebeten fr jegliche Beteiligung an diesem Projekt zuerst unseren CODE OF CONDUCT zu studieren und erst dann Beteiligungen in Betracht zu ziehen wenn dieser vollumfnglich akzeptiert werden kann.

mehr...

📜 Lizenzen

Die RaspberryMatic Buildumgebung selbst die Dateien die hier in diesem Git Repository zu finden sind sowie die frei herunterladbaren RaspberryMatic Images sind unter der OpenSource Apache License 2.0 lizenziert. RaspberryMatic wird selbst komplett kostenfrei und ohne jeglichen kommerziellen Intensionen entwickelt und zur komplett kostenfreien Nutzung bereit gestellt. Hierbei gilt zu beachten, dass die Komponenten der genutzten Buildroot/Linux Umgebung jeweils anderen Lizenzen stehen knnen wobei Buildroot/Linux hier selbst unter der GPLv2 lizenziert ist. Des Weiteren stehen die mit RaspberryMatic mitgelieferten eQ-3 OCCU Komponenten (Binr+Textdateien), die zur Nutzung der HomeMatic/homematicIP Interoperabilitt notwendig sind, unter der sogenannten HMSL Lizenz.

Haftungsausschluss

RASPBERRMATIC WIRD OHNE JEDE AUSDRCKLICHE ODER IMPLIZIERTE GARANTIE BEREITGESTELLT, EINSCHLIELICH DER GARANTIE ZUR BENUTZUNG FR DEN VORGESEHENEN ODER EINEM BESTIMMTEN ZWECK SOWIE JEGLICHER RECHTSVERLETZUNG, JEDOCH NICHT DARAUF BESCHRNKT. IN KEINEM FALL SIND DIE AUTOREN ODER COPYRIGHTINHABER FR JEGLICHEN SCHADEN ODER SONSTIGE ANSPRCHE HAFTBAR ZU MACHEN, OB INFOLGE DER ERFLLUNG EINES VERTRAGES, EINES DELIKTES ODER ANDERS IM ZUSAMMENHANG MIT DER SOFTWARE ODER SONSTIGER VERWENDUNG DER SOFTWARE ENTSTANDEN.

mehr...

📖 Literatur

Wenn der Eine oder Andere bzgl. Einsatz von RaspberryMatic noch unentschlossen ist oder die Vor-/Nachteile abwgen will so soll die folgende Literaturliste eine Hilfestellung geben:

👏 Danksagungen

Zustzlich zu den Personen die sich als Contributors im Rahmen des RaspberryMatic OpenSource Projekte indirekt oder direkt beteiligt haben, soll hier natrlich folgenden Personen ausdrcklich gedankt werden:

Alexander Reinert (@alexreinert) fr sein Low-Latency generic_raw_uart Kernelmodul, welches es erlaubt die von eQ3 angebotenen Funkmodule (RPI-RF-MOD, HM-MOD-RPI-PCB) zu nutzen sowie fr seine HB-RF-USB, HB-RF-USB-2 und HB-RF-ETH OpenHardware Projekte fr eine USB- bzw. Ethernet-basierte Nutzung dieser Funkmodule.