Einführung:
Bei RaspberryMatic handelt es sich um eine auf buildroot und OCCU basiertes Linux-Betriebssystem das sich zum Ziel gesetzt hat den kompletten Funktionsumfang einer HomeMatic-CCU-Zentrale auf die Hardware eines sogenannten Single-Board-Computers (SBC), z.B. RaspberryPi, Tinkerboard, etc., zu portieren. Hierbei macht sich RaspberryMatic zu nutze, dass es seit einiger Zeit von eQ3/ELV vertriebene GPIO-basierte Funkmodule (RPI-RF-MOD, HM-MOD-RPI-PCB) gibt die direkt auf die GPIO Schnittstelle des SBC gesteckt werden kann und zur Kommunikation mit BidCos-RF (HmRF) und HomeMatic-IP (HmIP) Komponenten genutzt werden kann. RaspberryMatic wird in Form kompletter Images (*.img) verteilt die mit geeigneten Tools (z.B. Etcher) auf eine microSD Karte, einen USB-Stick, eine USB-Festplatte oder auf onboard eMMC Speicher kopiert werden kann und somit als eigenständiges Betriebssystem auf einem SBC vorderrangig für die Kommunikation/Steuerung/Konfiguration von HomeMatic-Komponenten zum Einsatz kommt. Es verfolgt den Ansatz einer komplett eigenständigen Distribution und benötigt keinerlei Host-Betriebssystem wie z.B. Raspbian or Debian. Dies bringt eine Reihe von Vorteilen mit sich die die Stabilität und Performance erhöht – hat jedoch auch den Nachteil das Drittsoftware (wie z.B. ioBroker, apache, mysql, etc.) nicht ohne weiteres auf dem selben System betrieben werden kann, was jedoch bei einer reinen CCU auch so der Fall ist. Insofern hat RaspberryMatic den Anspruch ein vollwertiger Ersatz einer CCU-Zentrale auf Basis eines SBC zu sein und weniger ein bestehendes Linux-System um die Funktionalität einer CCU zu erweitern.
Features:
- 100%ige HomeMatic CCU2/CCU3 Kompatibilität basierend auf den neuesten OCCU Releases.
- Volle Unterstützung von BidCos-RF (HomeMatic), Wired (HomeMatic-Wired) und HmIP-RF (HomeMatic-IP) Komponenten.
- Integrierter WebUI-basierte Firmware-Update Mechanismus sowie eines Recovery-Systems zur Systemrettung und für Wartungsoperationen.
- Präemptiver Linux-Kernel (PREEMPT) zur Minimierung möglicher Latenzzeiten und zur Verbesserung der CCU Funktionen.
- Schreibgeschützte Root-Partition für mögliche Laufzeitverlängerung stark genutzter SD-Karten.
- Integriertes (JAVA8 Runtime Environment).
- Voller IPv6 Support und standardmäßig aktiviertes HTTPS für WebUI.
- Automatische Vergrößerung der Nutzerpartition (/usr/local/) auf maximale SD-Karten-Größe.
- Hardware-Watchdog integration zum automatischen Neustart eines Systems bei möglichen Hardwareproblemen
- Direkte CloudMatic (meine-homematic.de) Unterstützung
- Kompatibel zu allen RaspberryPi und ASUS Tinkerboard Hardwarevarianten auf dem Markt.
- Integration neuester ReGaHss Community-Versionen die aktuelle Features und Bugfixes in der Logikschicht mit sich bringen.
- Integration aktuellster WebUI-Patches zur Funktionserweiterung der Weboberfläche.
- Unterstützung für den Betrieb als reinen LAN Gateway (HM-LGW-O-TW-W-EU) ohne WebUI und anderen CCU Funktionen (nicht mit RPI-RF-MOD möglich).
- Unterstützung für den Betrieb ohne GPIO-Funkmodul nur mit Anbindung via externem LAN Gateway (HM-LGW-O-TW-W-EU) für die reine BidCos-RF Kommunikation.
- Eigenständiges Installationsimage welches hauptsächlich für die Nutzung mit Single-Board-Computer Systemen (z.B. RaspberryPi, ASUS Tinkerboard, etc.) ausgerichtet ist und direkt auf SD-Karte/eMMC installiert werden kann.
- Basierend auf neuesten Buildroot Linux Versionen.
- Neueste Linux 4.14.x Kernel mit hard-float (ARMv7) support.
- Möglichkeit das Installationsimage auf einem USB-Stick oder USB-Festplatte (nur mit RaspberryPi3 möglich) oder eMMC (ASUS Tinkerboard S) zu installieren und davon zu booten.
- Unterstützung für das onboard WLAN+Bluetooth des RaspberryPi3, RaspberryPi Zero W und ASUS Tinkerboard sowie verschiedener externer USB-basierter WLAN/Bluetooth Sticks.
- Network UPS Tools (NUT) Unterstützung um eine externe unterbrechungsfreie Stromversorgung (USV) entweder via Netzwerk anzubinden (z.B. via Synology NAS) oder direkt via USB Anschluss.
- Erlaubt mittels SNMP Requests Statusinformationen über das Linux-System von RaspberrryMatic zu erhalten.
- Direkt integrierte Unterstützung für folgende Hardware-Attached-on-Top (HAT) Boards:
- S.USV – Nutzung als unterbrechungsfreie Stromversorgung zur automatischen Abschaltung bei Stromverlust und zur Benachrichtigung via Alarmmeldung
- PiUSV+ – Nutzung als unterbrechungsfreie Stromversorgung zur automatischen Abschaltung bei Stromverlust und zur Benachrichtigung via Alarmmeldung
- PiModules PIco UPS – Nutzung als unterbrechungsfreie Stromversorgung zur automatischen Abschaltung bei Stromverlust.
- StromPi2 – Nutzung als unterbrechungsfreie Stromversorgung zur automatischen Benachrichtigung bei Stromverlust.
- PiDesktop – Addon HAT mit Power-Button und dedizierter RTC-Clock (PCF8563).
- Integrierter Support für folgende RTC-Clock HAT Module:
- PiFace Shim RTC
- DS3231
- DS1307
- RX8130CE
- onboard Tinkerboard RTC
- Einfache Erstellung eines Cross-Compilers zum Kompilieren/Erzeugen von Drittanbieter-Software speziell für RaspberryMatic.
- Keine webbasierte Konfigurationsmöglichkeit für das Einrichten der WLAN/Bluetooth Unterstützung (-> In Arbeit)
- Keine webbasierte Konfigurationsmöglichkeit für das Einrichten des LAN-Gateway-Modus (-> In Arbeit)
- Keine webbasierte Konfigurationsmöglichkeit für das Einrichten der NUT (USV) Unterstützung (-> In Arbeit)
- Eines der folgenden unterstützten embedded Geräte:
- RaspberryPi3 Model B+
- RaspberryPi3 Model B
- RaspberryPi2 Model B
- RaspberryPi Compute Module 3
- RaspberryPi Compute Module 3 lite
- RaspberryPi Zero W
- RaspberryPi Zero
- RaspberryPi Compute Module 1
- RaspberryPi1 Model B+ oder Model B, 512MB
- RaspberryPi1 Model A+ oder Model A, 256MB
- Tinker Board S
- Tinker Board
- Eines der folgenden Schnittstellen-Geräte um mit den HomeMatic / HomeMatic-Wird / HomeMatic-IP Geräten kommunizieren zu können:
- HomeMatic + HomeMaticIP:
- GPIO Funkmodul HAT – RPI-RF-MOD
- GPIO Funkmodul HAT – HM-MOD-RPI-PCB (Installationsvideo)
- HomeMaticIP only:
- USB Stick – HmIP-RFUSB
- HomeMatic (BidCos-RF) only:
- LAN Gateway – HM-LGW-O-TW-W-EU
- USB Config Adapter – HM-CFG-USB-2
- HomeMatic-Wired only:
- LAN Wired Gateway – HMW-LGW-O-DR-GS-EU
- HomeMatic + HomeMaticIP:
- mindestens 4 GB microSD Karte oder USB MemoryStick / USB Festplatte (nur mit RaspberryPi3)
(1) RaspberryMatic-Image installieren:
- Vor Installation sicherstellen, dass es sich bei dem einzusetzenden embedded Board um einen der unterstützen Modelle handelt (siehe Liste oben)
- Das jeweils aktuellste RaspberryMatic Image (als gezippte Datei 'RaspberryMatic-X.XX.XX.YYYYMMDD-XXX.zip') für die jeweilige Hardware-Platform von folgender Webseite herunterladen:
Bitte beachten: RaspberryPi3, RaspberryPi2 und das Raspberry Pi Compute Module 3 benötigen das Installationsarchiv mit der Endung "-rpi3.zip" – die anderen RaspberryPi Modelle das mit der Endung "-rpi0.zip". Und das ASUS Tinkerboard benötigt die Datei mit der Endung "-tinkerboard.zip"
- Auszug Release-Website mit Hinweis auf RaspberryPi3 Image Download
- Die heruntergeladene Zip Datei entpacken damit eine '*.img' Datei entsteht.
- Das jeweilige Speichermedium auf dem RaspberryMatic installiert werden soll an den PC/Mac anbinden an dem das Image heruntergeladen wurde:
- d.h. eine freie microSD Karte (4 GB minimum) mittels microSD-Card Reader an einen Rechner anbinden
- alternativ kann bei Einsatz eines RaspberryPi3 auch das Image auf einen USB-Stick oder USB-Festplatte installiert werden (mehr dazu weiter unten).
- Wenn man ein TinkerboardS einsetzt das mit einer eMMC ausgestattet ist kann man dieses nun via microUSB Anschluss an den Rechner anschliessen und erhält dann ein entsprechendes Speichermedium angezeigt sobald man das TinkerboardS anschaltet.
- Dann sollte man das graphische Flash Image Tool "Etcher" auf seinem Betriebssystem installieren und nutzen (https://etcher.io/) um die *.img Datei auf die jeweilige microSD Karte, USB-Stick/Festplatte bzw. eMMC zu überspielen.
- Bildschirmauszug der Nutzung von "Etcher" um das Kartenimage auf ein Speichermedium zu kopieren.
- Sicherstellen das eine kompatible HomeMatic-Funkhardware existiert (siehe Liste oben). So z.B. ein GPIO Funkmodul korrekt zusammengelötet und korrekt auf den GPIO-Bus des RaspberryPi gesteckt wurde (Ein Video das das Zusammenlöten und Aufstecken auf eine RaspberryPi zeigt ist unter https://www.youtube.com/watch?v=xtzXsvOLa_Y zu finden).Alternativ kann RaspberryMatic auch ohne Funkmodul betrieben werden, es wird dann aber mindestens ein LAN-Gateway benötigt um mit HomeMatic/BidCos-RF Komponenten (kein HmIP möglich) kommunizieren zu können.
- RaspberryPi3 mit RPI-RF-MOD bestückt.
- rpi-rf-mod.jpg (17.37 KiB) 157487 mal betrachtet
- Die microSD-Karte bzw. den USB-Stick in den SBC stecken, Netzwerkkabel und dann Netzteil anschliessen (Monitor+Tastatur kann später für Debugging Zwecke angeschlossen werden).
- Nun sollte RaspberryMatic hochfahren und während des Hochfahrens die rote LED regelmäßig blinken. Ist das System ordentlich hochgefahren sollte die rote LED ausgehen und dafür dann die grüne LED im sogenannten "heartbeat" Modus blinken. Wenn man bereits einen Monitor via HDMI Anschluss angeschlossen hatte kann man den Bootverlauf so auch verfolgen (etwaige Fehlermeldungen können durch drücken von ALT+F2 auf einer via USB angeschlossenen Tastatur angesehen werden). Nach Ende des Bootvorganges (und Wechsel zur grünen LED Anzeige) sollte hier zusätzlich zum HomeMatic/homematicIP Logo unten die Version sowie die IP-Adresse angezeigt werden unter der RaspberryMatic mit dem Netzwerk verbunden wurde.
- Bildschirmanzeige (via HDMI) bei erfolgreichem Boot von RaspberryMatic
- Nun kann man die WebUI Oberfläche der neuen RaspberryMatic-CCU unter http://<IP-ADRESSE>/ bzw. http://homematic-raspi/ von einem anderen Rechner aus via Webbrowser aufrufen und seine neue CCU-Zentrale entsprechend bedienen.
- Mit RaspberryMatic verbundener Webbrowser
(3) Datenübernahme von CCU2 (auch LXCCU, YAHM, piVCCU), CCU3 oder älterer RaspberryMatic:
Wenn man die oberen Schritte ausgeführt hat und das neue RaspberryMatic prinzipiell funktioniert kann man sich an die Datenübernahme von einer alten CCU2 (auch LXCCU, YAHM, piVCCU) bzw. älterem RaspberryMatic machen. Hierbei unterscheidet sich die Herangehensweise vor allem bei der Nutzung bestehender CCU-Addons in der jeweiligen CCU-Art:
- Datenübernahme von CCU2 (auch LXCCU, YAHM, piVCCU):
- Wenn man von einer CCU2/LXCCU/YAHM/piVCCU die Daten übernehmen möchte muss man sicherstellen, dass man als CCU2 Firmware eine Firmwareversion verwendet die kleiner oder gleich der OCCU Version ist auf der die eingesetzte RaspberryMatic Version basiert (2.XX.XX)
- Auf der alten CCU mittels WebUI einloggen und unter Einstellungen->Systemsteuerung->Sicherheit->Backup erstellen ein Backup der aktuellen Einstellungen, etc. durchführen und sicher verwahren.
- Alle unter Einstellungen->Systemsteuerung->Zusatzsoftware gelisteten Zusatzpakete notieren da diese später (nach fertiger RaspberryMatic Installation) manuell in einer RaspberryMatic-kompatiblen Version nachinstalliert werden müssen.
- Nun unter Einstellungen->Systemsteuerung->Zusatzsoftware ALLE Zusatzpakete/Addons (jedoch NICHT CUxD - das muss installiert bleiben wenn es vorher installiert war) deinstallieren.
- Erneut unter Einstellungen->Systemsteuerung->Sicherheit->Backup erstellen ein Backup erstellen und dieses temporär ablegen.
- Die alte CCU nun runterfahren und komplett vom Strom nehmen (darf nicht parallel zu RaspberryMatic laufen!).
- Den Browser-Cache des aktuell genutzten Browsers komplett löschen, danach den Webbrowser neustarten.
- Auf dem neuen RaspberryMatic mittels WebUI einloggen und unter Einstellungen->Systemsteuerung->Sicherheit->Backup einspielen das als letztes gesicherte Backup (ohne Zusatzsoftware, jedoch mit CUxD) einspielen.
- Nachdem durch das Backup einspielen erfolgte Neustart sollte man sich mit der WebUI wieder verbinden und dort als erstes unter Einstellungen->Systemsteuerung->Zeit-/Positionseinstellungen->NTP-Server die folgende NTP-Server Zeichenkette eingeben:Dies stellt sicher das dann nach dem nächsten Reboot ein valider NTP Server eingetragen ist von dem die aktuelle Uhrzeit beim hochfahren bezogen werden kann.
Code: Alles auswählen
0.de.pool.ntp.org 1.de.pool.ntp.org 2.de.pool.ntp.org 3.de.pool.ntp.org - Nun sollte man (wenn man vorher bereits CUxD eingesetzt hatte) sicherstellen, dass man das CUxD Addon nun neu in der RaspberryMatic Variante unter Einstellungen->Systemsteuerung->Zusatzsoftware drüberinstalliert (nicht vorher deinstallieren!) damit CUxD nach einem weiteren Reboot wieder korrekt funktioniert.
- Datenübernahme von CCU3:
- Da eine CCU3 und RaspberryMatic binärkompatibel ist kann man hierbei direkt ein CCU3 Backup in RaspberryMatic über die normale Einstellungen->Systemsteuerung->Sicherheit->Backup einspielen Funktion einspielen.
- Datenübernahme von älterer RaspberryMatic Version:
- Bitte für die Datenübernahme von einer älteren RaspberryMatic Version im Abschnitt Update / Upgrade weiterlesen.
(4) Installation Zusatzsoftware (CCU-Addons):
Hat man alle Schritte wie oben beschrieben erledigt kann man sich an das ggf. notwendige Nachinstallieren von CCU-Addons machen damit man die gesamte vorherige Funktionalität wieder erhält. Es soll hier jedoch erneut erwähnt werden, dass CCU-Addons die für die CCU2 entwickelt wurden NICHT automatisch zu RaspberryMatic kompatibel sind (Lediglich CCU3-Addons sind direkt kompatibel). D.h. es müssen explizit für RaspberryMatic/CCU3 kompatible CCU-Addons installiert werden. Die unten aufgeführt Liste stellt den aktuellen Stand von CCU Addons dar die für RaspberryMatic/CCU3 kompatibel sind. Diese kann man getrost unter Einstellungen->Systemsteuerung->Zusatzsoftware nun entsprechend installieren und die Konfiguration im Anschluss wie gehabt vornehmen (ggf. werden sogar Konfigurationen beim Umstieg von einer CCU2 übernommen).
Kompatible CCU-Addons:
- CUxD
- XML-API
- hm_pdetect
- Email-Addon
- CUxD-Highcharts
- HQ-WebUI
- DB-Access
- QuickAccess
- Script-Parser
- WebMatic
- Sonos Player
- hm2mqtt
- CCU-Historian
- Watchdog
- homeputer CL Studio
- Print / ProgrammeDrucken
- Check_MK Addon
- hm-tools
- HB-UW-Sen-THPL Universalsensor
- RedMatic
- Mosquitto
Da an RaspberryMatic regelmäßig weiterentwickelt wird, wird man zwangsläufig irgendwann zu dem Punkt kommen das man seine RaspberryMatic Installation auf eine neuere Version updaten muss/sollte. Seit der Version 2.31.25.20180428 funktioniert ein Firmware-Update von RaspberryMatic genauso wie bei einer CCU2. D.h. man lädt wie bei einer CCU2 die Firmware-Update-Datei über die WebUI hoch und lässt dieses dann anwenden. Dieses (wenn auch einfache) Prozedere soll hier kurz Schritt-für-Schritt erklärt werden:
- Auf der alten RaspberryMatic Version mittels WebUI einloggen und unter Einstellungen->Systemsteuerung->Sicherheit->Backup erstellen erst einmal ein Backup der aktuellen Einstellungen/Konfiguration, etc. durchführen und die heruntergeladene *.sbk Datei sicher verwahren.
- Nun unter Einstellungen->Systemsteuerung->Zentralen-Wartung->Herunterladen dafür sorgen das man auf die entsprechende Projektseite von RaspberryMatic weitergeleitet wird. Dort angekommen lädt man dann die aktuellste *.zip-Datei für die eingesetzte Hardware-Platform (rpi3=RaspberryPi2/3, tinkerboard=ASUS Tinkerboard, rpi0=RaspberryPi0/1) herunter.
- Nun unter Einstellungen->Systemsteuerung->Zentralen-Wartung->Heruntergeladene Software auswählen die Zip-Datei auswählen (nicht das ausgepackte Verzeichnis!) und dann darunter Hochladen drücken.
- Warten bis die Datei hochgeladen und kontrolliert wurde das es sich dabei auch um eine korrekte Firmware-Update-Datei handelt (dies kann auch >10 Minuten dauern -> Browser NICHT schliessen!).
- Dann das Update durch Drücken von Start Update bestätigen und erneut abwarten bis es angewendet durchgeführt wurde (wieder mehrere Minuten). Ggf. kann man hier nach einer gewissen Zeit (1-2 Minuten) einen Refresh der momentan angezeigten Webseite durchführen und sollte dann zu einer Textausgabe kommen die den momentanen Status des Firmware-Updates darstellt
- Während des Updates blinkt die rote LED des RaspberryPi/Tinkerboard in regelmäßigen Abständen und das System wird auch automatisch insgesamt 2x neu gestartet.
- Wurde das Update korrekt angewendet und RaspberryMatic ist wieder betriebsbereit hochgefahren blinkt die grüne LED im sogenannten "heartbeat" Modus.
- Den Browser-Cache des aktuell genutzten Browsers komplett löschen, danach den Webbrowser neustarten.
- Nun kann man sich wie gewohnt auf dem frisch geupdateten RaspberryMatic mittels Webbrowser/WebUI einloggen und das Update sollte korrekt vollzogen worden sein.
Lässt sich jedoch das System nach einem Firmware-Update komplett nicht mehr neustarten und auch der Recovery Modus nicht erreichen, so kann man mit dem folgenden Prozedere eine komplett frische RaspberryMatic-Installation durchführen und dann das zuvor heruntergeladene Backup wieder einspielen:
- Die RaspberryMatic-Zentrale komplett vom Strom nehmen.
- Am besten die neue Version von RaspberryMatic wie unter Installation beschrieben auf eine neue/frische microSD Karte überspielen/installieren.
- Nun am besten die neue/frische microSD-Karte mit dem frischen Image in den RaspberryPi einlegen und hochfahren.
- Den Browser-Cache des aktuell genutzten Browser komplett löschen, danach den Webbrowser neustarten.
- Auf dem frischen RaspberryMatic mittels WebUI einloggen und unter Einstellungen->Systemsteuerung->Sicherheit->Backup einspielen das zuvor gesicherte Backup einspielen.
Zusatzfunktionalitäten:
Zusätzlich zu den Standard-CCU Funktionen wie bei einer CCU2 gibt es bei RaspberryMatic zusätzliche Funktionalität (z.B. Nutzung von WLAN, Bluetooth, etc.) die im Moment jedoch nur über manuelle Aktionen (via SSH/SFTP Zugang als 'root' und manueller Anpassung von Konfigurationsdateien) vorgenommen werden kann. Hierzu sollen die folgenden Kurzanleitungen bei der Einrichtung dieser Funktionalitäten Hilfestellung geben:
(1) Einrichten von WLAN Verbindungen (z.B. via RaspberryPi3 onboard WLAN, externe USB WiFi-sticks, etc.):
RaspberryMatic unterstützt die folgende getestete WLAN Hardware:
- Onboard WLAN des RaspberryPi3 bzw. RaspberryPi Zero W
- Edimax EW-7612UAN V2 – RTL81xx based USB WiFi stick
- ThePiHut - RT2xx based USB WiFi stick
Um RaspberryMatic mittels WLAN an sein Netzwerk anzubinden müssen folgende Schritte vorgenommen werden:
- SSH Zugang via WebUI freischalten (Systemsteuerung->Sicherheit->SSH) bzw. auf einem RaspberryPi Zero W einen Monitor+Tastatur anschliessen und ALT+F2 drücken, dann dort als 'root' einloggen.
- Folgendes Kommando ausführen um die WLAN Schnittstelle zur Nutzung bzw. zur Suche der zur Verfügung stehenden WLANs in der Umgebung freizuschalten:
Code: Alles auswählen
rfkill unblock wifi - Danach via Konsole das folgende Kommando ausführen um zu überprüfen ob das WLAN interface prinzipiell die NetzwerkID (SSID) des WLANs in das man sich verbinden möchte sehen kann: Das Kommando sollte daraufhin alle SSIDs ausgeben das das WLAN interface sieht oder eben eine Fehlermeldung bzw. keine Meldung wenn es keinerlei WLAN-Netzwerke sehen kann.
Code: Alles auswählen
iw wlan0 scan - Wenn die eigene SSID gefunden wird kann folgendes Kommando ausgeführt werden um die Standardkonfigurationsdatei zu installieren:
Code: Alles auswählen
cp /etc/config_templates/wpa_supplicant.conf /etc/config/ - Dann folgenden Befehl ausführen: Hierbei dann statt SSID den Namen des WLAN angeben und unter PASSWORT eben das Zugangspasswort des WLAN. Dieses Kommando hängt dann an die Datei "/etc/config/wpa_supplicant.conf" einen "network={}" Abschnitt an der der eingegebenen WLAN Konfiguration entspricht und in etwa wie folgt aussehen sollte:
Code: Alles auswählen
wpa_passphrase "SSID" "PASSWORT" >>/etc/config/wpa_supplicant.confCode: Alles auswählen
network={ ssid="SSID" #psk="PASSWORT" psk=a76a8dce6a07582a553c35baa7bc1de6e3763b4a4354e53b769602cf608ac14e } - Nun die /etc/config/wpa_supplicant.conf Datei in einem Editor (z.B. 'vi') öffnen (oder runterladen und extern bearbeiten) und dort kontrollieren das nur ein aktiver "network={}" Abschnitt dort zu finden ist und ggf. den anderen Bereich mit "#" Zeichen am Anfang auskommentieren.
- Nun die Konfigdatei speichern bzw. in das '/etc/config/' Verzeichnis in RaspberryMatic zurückspielen.
- RaspberryMatic neustarten (ggf. 'reboot' Befehl eingeben) und das LAN-Kabel dann unmittelbar abziehen und nicht wieder verbinden.
HINWEIS: Ein paralleler Betrieb von LAN und WLAN Anschluss ist nicht möglich. D.h. man muss das Ethernet-Kabel abgezogen haben wenn RaspberryMatic hochfährt damit er das WLAN als präferiertes Netzwerk überhaupt initialisiert. Auch sollte man natürlich bei generellen Betrieb von RaspberryMatic bzw. einer CCU via WLAN beachten das die Stabilität/Geschwindigkeit/Latenzzeiten der Verbindung zur CCU somit stark von der StabilitätGeschwindigkeit/Latenzzeiten der WLAN Verbindung abhängt. Es soll daher angemerkt werden, dass grundsätzlich man davon Abstand nehmen sollte eine CCU bzw. RaspberryMatic über WLAN in Betrieb zu nehmen.
(2) Nutzung als reiner LAN Gateway: (Funktioniert NICHT in Kombination mit einem RPI-RF-MOD)
RaspberryMatic kann man prinzipiell auch als reiner LAN-Gateway betrieben und somit an eine CCU oder anderes RaspberryMatic angebunden werden um so die Reichweite seines BidCos-RF Netzes analog zu einem HM-LGW-O-TW-W-EU zu erweitern. Hierbei gilt allerdings zu beachten, das auf Grund von technischen Einschränkungen des LAN-Gateway-Protokolles damit keine Reichweitenverlängerung mit homematicIP Geräten möglich ist. Lediglich für traditionelle BidCos-RF (homematic) Geräte lässt sich somit deren Reichweite verlängern. Des Weitern gilt zu beachten, das diese Funktionalität NICHT mit einem RPI-RF-MOD Funkmodul funktioniert da hier die notwendige, spezielle Funkmodul-Firmware nicht existiert.
Für die Nutzung/Konfiguration von RaspberryMatic als reinen LAN-Gateway muss man wie folgt vorgehen:
- SSH Zugang via WebUI freischalten (Systemsteuerung->Sicherheit->SSH)
- Via SSH Zugang als Nutzer 'root' zur Konsole das folgende Kommando ausführen:
Code: Alles auswählen
touch /usr/local/HMLGW - RaspberryMatic neustarten (ggf. 'reboot' Befehl eingeben)
HINWEIS: Wie bei einem richtigen LAN-Gateway wird keinerlei WebUI oder ähnlich beim Hochfahren im LAN-GW Modus in Betrieb genommen. Möchte man RaspberryMatic nicht mehr im LAN-Gateway Modus betreiben muss man lediglich via SSH/SFTP die Datei /usr/local/HMLGW wieder löschen und RaspberryMatic neustarten. Danach sollte es dann im Normalen modus hochfahren und die WebUI dann wieder verfügbar sein.
(3) Konfiguration als NUT Client/Server:
Nennt man eine unterbrechungsfreie Stromversorgung (USV) sein Eigen kann man seit der beta5 Version von RaspberryMatic dieses entweder als sogenannten Network UPS Tools (NUT) Client mit einem NUT Server verbinden oder aber eine von NUT (http://networkupstools.org/) unterstützte USV direkt via USB an den RaspberryPi anschliessen.
Um RaspberryMatic z.B. als NUT Client in Betrieb zu nehmen (wenn man z.B. seine USV an ein Synology NAS angeschlossen hat) kann man wie folgt vorgehen:
- SSH Zugang via WebUI freischalten (Systemsteuerung->Sicherheit->SSH)
- Via SSH Zugang als 'root' zur Konsole die Datei /etc/config/nut/nut.conf anpassen und dort sicherstellen das der folgende Eintrag vorgenommen wurde (standardmäßig steht da 'none'):
Code: Alles auswählen
MODE=netclient - In der Datei /etc/config/nut/upsmon.conf sicherstellen das die MONITOR Zeile (ganz oben) aaskommentiert ist (entfernen des #) und der korrekte Eintrag zum NUT Server wie folgt steht: Hierbei sollte statt ups@bigserver so etwas wie "ups@IP-ADRESSE" stehen und statt <USERNAME> und <PASSWORD> eben Nutzername+Passwort (für ein Synology NAS muss immer Nutzername: 'monuser' und Passwort: 'secret' verwendet werden, d.h. es muss kein NAS nutzer oder ähnliches angelegt werden).
Code: Alles auswählen
MONITOR ups@bigserver 1 <USERNAME> <PASSWORD> slave - Den NUT Dienst mittels folgendem Kommando neustarten:
Code: Alles auswählen
/etc/init.d/S51nut restart
HINWEIS: Der Betrieb als NUT server (d.h. direkter Anschluss einer USV via USB) sollte prinzipiell über die Konfigurationsdateien unter /etc/config/nut möglich sein, da dies aber noch nicht ausreichend getestet wurde soll hier lediglich auf die Dokumentation zu NUT verwiesen werden da dies analog dazu möglich sein sollte die NUT Konfiguratio somit auf seine eigenen Bedürfnisse anzupassen.
(4) Boot via USB Memory Stick / Festplatte (nur mit RaspberryPi3 möglich)
Bei RaspberryMatic ist es möglich bei Einsatz eines RaspberryPi3 das gesamte System prinzipiell auf einem USB Memory Stick bzw. USB Festplatte zu betreiben. Hierzu ist es notwendig die *.img Datei statt auf einer microSD Karte auf einem USB Memory Stick oder USB Festplatte mit dem selben Imaging Tool (Etcher – https://etcher.io) auf den USB Datenträger zu kopieren und dann diesen an den RaspberryPi3 anzuschliessen. Hierbei muss jedoch noch folgendes beachtet werden:
- Die Möglichkeit von USB zu booten kann technisch bedingt NUR ein RaspberryPi3 leisten. Andere Modelle bieten diese Möglichkeit momentan nicht.
- Wenn der RaspberryPi3 vorher noch NIE via USB gebootet wurde (z.B. fabrikneu) ist es trotzdem notwendig die neueste Version von RaspberryMatic ein einzelnes mal von microSD booten zu lassen. Bei diesem initialen Boot der neuen Version wird dann der RaspberryPi3 so umprogrammiert das die USB Boot Funktion aktiviert wird. Danach kann dann die microSD Karte gegen den USB Stick/Festplatte getauscht werden (sicherstellen das microSD karte entfernt wurde!) und der RaspberryPi3 sollte dann von dem USB Medium booten und auch darauf arbeiten.
- Bei Betrieb des RaspberryPi3 via eines USB Mediums gilt zu beachten, dass der RaspberryPi3 lediglich über USB2.0 verfügt und dadurch die Schreib-/Lesegeschwindigkeit nicht dem entspricht was bei Betrieb via microSD Karte geleistet werden kann. Es muss daher mit einer verminderten Schreib-/Lesegeschwindigkeit gerechnet werden.
In RaspberryMatic existiert die Möglichkeit Backups und Restores von Backups nicht nur über die WebUI anzustoßen/durchzuführen, sondern diese auch mittels Kommandozeilenprogrammen (z.b. über eine SSH Verbindung oder via cronjob) durchzuführen. Dies macht jedoch lediglich für RaspberryMatic Nutzung als CCU Zentrale Sinn. Wenn man RaspberryMatic im LAN Gateway-Modus betreibt macht dies keinen Sinn, da hier keinerlei relevanten Daten gespeichert werden die ein Backup benötigen.
Hierbei kann man eine Standard *.sbk Backupdatei mit folgendem Kommando generieren lassen:
Code: Alles auswählen
/bin/createBackup.sh <BACKUPDIR>
Möchte zusätzlich dann eine *.sbk Datei nicht über die WebUI installieren/restoren sondern dies auch via Kommandozeile/SSH-Zugang tun so kann man folgendes Prozedere anwenden um ein Backup einzuspielen:
- *.sbk Datei via SCP in das /usr/local/tmp directory kopieren
- Via SSH-Zugang (Nutzer: 'root') einloggen
- Folgenden Befehl ausführen:
Code: Alles auswählen
/bin/restoreBackup.sh /usr/local/tmp/<SBKDATEI> - RaspberryMatic neustarten (z.B. 'reboot' Befehl)
Bekannte Probleme/Limitationen:
Im Folgenden findet sich eine Liste mit bekannten Problemen bzw. Bugs und ggf. auch mit möglichen Szenarien wie man diese Fehler umgehen kann bzw. ob diese bereits bekannt/behoben wurden. Bitte beachten, dass die Lösungsansätze hier experimentell sind und nur von geübten HomeMatic/Linux Nutzern vorgenommen werden sollten.
- Schlechte Empfangs/Sendequalität des Funkmodul:
Die Antenne des Funkmoduls für den Raspberry (HM-MOD-RPI-PCB ) hat tendenziell eine schlechtere Empfangs/Sendequalität als eine CCU2 selbst. Um somit alle Hm-RF Komponenten in einem Haus korrekt zu erreichen kann es mitunter notwendig sein Funkgateways einzusetzen bzw. eine alternative Antennenvariante (siehe http://homematic-forum.de/forum/viewtop ... 27&t=27287) einzusetzen. - Keine RealTimeClock (RTC) im RaspberryPi:
Da ein Raspberry Pi standardmäßig über keine RealTimeClock (RTC) verfügt kommt es beim hochfahren dazu, dass die Uhrzeit bis zur erfolgreichen Synchronisation mit einem NTP Server auf den 1.1.1970 gestellt ist und somit mitunter CCU Funktionen nur eingeschränkt funktionieren können. Wie man ein solches RTC-Modul in einem Raspberry Pi innerhalb von RaspberryMatic in Betrieb nehmen kann ist hier beschrieben: http://homematic-forum.de/forum/viewtop ... 56&t=27684 - HmIP Geräte bzw. das HmIP-Anlernen funktioniert nicht nach CCU2 Konfig Restore :
Je nachdem zu welchem Zeitpunkt bzw. mit welcher CCU2-Firmware an einer CCU2 ein HomeMaticIP Gerät angelernt wurde kann es bei einem Umstieg von einer CCU2 zu RaspberryMatic dazu kommen das HmIP-Geräte unter RaspberryMatic nicht funktionieren und/oder der HmIP-Anlernmodus nicht mehr gestartet werden kann. Der Grund hierfür ist das die bzw. ein HomeMaticIP Gerät(e) mit einer Betafirmware der CCU2 mit HomeMaticIP Support angelernt wurden und hier ein fester Netzwerkschlüssel verwendet wurde der so unter RaspberryMatic nicht mehr funktioniert. In diesem Fall muss man leider wie folgt vorgehen und alle HomeMaticIP Geräte erneut frisch (inkl. Werksreset) neu anlernen:- Via SSH (als Nutzer 'root') folgendes Kommando unter RaspberryMatic ausführen:
Code: Alles auswählen
rm -rf /etc/config/hmip_*.conf /etc/config/crRFD/* - RaspberryMatic neustarten
- Probieren ob nach dem neuen Hochfahren der HmIP-Anlernmodus wieder funktioniert
- Alle HomeMaticIP Geräte werksresetten und komplett neu anlernen
- Via SSH (als Nutzer 'root') folgendes Kommando unter RaspberryMatic ausführen:
Hilfestellung / Feedback / Weiterentwicklung:
Da es sich bei RaspberryMatic um ein freies Community-Projekt handelt ist es natürlich stark auf die Hilfestellung und das Feedback aus der Community angewiesen. Damit auch in Zukunft eine Weiterentwicklung auf hohem Niveau gewährleistet werden kann möchte ich daher zur Beteiligung an der Weiterentwicklung von RaspberryMatic aufrufen denn es gibt diesbzgl. noch einige Ideen die umgesetzt werden könnten. Neben direkten Weiterentwicklungen kann man sich natürlich auch (falls das KnowHow fehlt) auch auf anderen Wegen an der Entwicklung von RaspberryMatic beteiligen:
- Direkte Entwicklungsbeteiligung: Bitte mittels Pull-Requests oder direkten Patches im RaspberryMatic Projekt auf GitHub beteiligen.
- Melden von Fehlern / Bug reports: Bitte den GitHub-Issue-Tracker des RaspberryMatic Projektes nutzen
- Melden von Erweiterungs/Featurewünschen: Bitte den GitHub-Issue-Tracker des RaspberryMatic Projektes nutzen
- Geld/Sach-Spenden: Wer gerne als kleine Motivationsspritze mit Geld/Sachspenden helfen will das weiter aktiv an RaspberryMatic entwickelt wird kann natürlich gerne auch mittels einer Sachspende an mich bzw. einer Geldspende via PayPal seine Zufriedenheit kundtun.
Wenn der Eine oder Andere bzgl. Einsatz von RaspberryMatic noch unentschlossen ist oder die Vor-/Nachteile solcher alternativer CCU-Umgebungen abwägen will so soll die folgende Literaturliste/Referenz eine kleine Hilfestellung geben:
- Vortrag zu 'RaspberryMatic vs. CCU3' – Usertreffen 2019 Kassel
- Vortrag zu RaspberryMatic – Usertreffen 2018 Kassel
- Vortrag zu RaspberryMatic (Teil 1) – Usertreffen 2017 Kassel
- Vortrag zu RaspberryMatic (Teil 2) – Usertreffen 2017 Kassel
Eine detaillierte Liste aller bisherigen Änderungen zwischen den individuellen RaspberryMatic-Versionen erhält man über die Release-Seite bei GitHub.
in Form der Integration einer kürzlich im OCCU zur Verfügung gestellten 