Langzeitarchiv für die Zentrale (CCU) des Hausautomations-Systems HomeMatic.
Der CCU-Historian ist ein Langzeitarchiv für die Zentrale (CCU) des Hausautomations-Systems HomeMatic der Firma eQ-3.
Die Kommunikationsvorgänge der CCU-Schnittstellen (BidCos-RF, BidCos-Wired und System) werden aufgezeichnet. Darunter befinden sich z.B. die Messwerte aller Sensoren und alle ausgeführten Schaltvorgänge. Aus der Logikschicht der CCU werden zusätzlich die Systemvariablen archiviert. Die gesammelten Daten werden strukturiert in einer Datenbank abgelegt und stehen daraufhin für Visualisierungen oder Analysen zur Verfügung. Für einen ersten Überblick werden Web-Seiten mit Trend-Diagrammen durch einen eingebetteten Web-Server generiert.
Mit vielen tausend Installationen erfreut sich der CCU-Historian bei den HomeMatic-Anwendern einer großen Beliebtheit.
Viele weitere Informationen sind im umfangreichen Handbuch zu finden.
Am 23.01.2011 wurde mit einem Beitrag im HomeMatic-Forum der CCU-Historian der HomeMatic-Community vorgestellt. Dies ist inzwischen 15 Jahre her. Seitdem wurde er kontinuierlich gepflegt und weiter entwickelt. Ursprünglich für die CCU1 entwickelt, folgten über die Jahre die Unterstützung für die CCU2, CCU3 und RaspberryMatic bzw. OpenCCU auf verschiedenen Plattformen.
Zudem wurde stetig die Funktionalität erweitert. Angefangen hat alles mit einer einfachen Trend-Darstellung, dann folgten die Vorverarbeitung von Messwerten, die Meldungsanalyse, eine Skript-Umgebung, umfangreiche Import- und Export-Funktionen und zuletzt die Zeitreihenberechnungen. Immer wurde darauf geachtet, dass die bestehende Datenbank von Version zu Version migriert werden kann. Auch durch die Export-Funktionen sind die gesammelten Zeitreihen nie verloren und können in andere Datenbanken importiert werden.
Der CCU-Historian hat inzwischen eine umfangreiche Code-Basis, sodass das Einbauen neuer Funktionalität immer aufwendiger wird. Am Anfang war die Entwicklungsrichtung nicht abzusehen, sodass damalige Entscheidungen nicht optimal waren. Eine Weiterentwicklung würde eine komplette Neuentwicklung für die Version 5 bedeuten.
Daher wird auf absehbare Zeit der CCU-Historian funktional nicht erweitert. Er wird weiterhin gepflegt, sodass er mit allen CCU-Zentralen, auch den kommenden auf OpenCCU-Basis, kompatibel bleibt.
Die Homematic IP Home Control Unit (HCU) besitzt eine komplett andere Programmierschnittstelle und wird auch zukünftig nicht unterstützt.
In diesem Abschnitt will ich immer Neues und Interessantes aus der CCU-Historian Community vorstellen. Dieses Mal bin ich auf die batteriebetriebene ePaper-Anzeige inki aufmerksam geworden, die als Datenquelle für Trendkurven den CCU-Historian verwendet. Das Projekt liegt ebenfalls auf GitHub und wird auch auf Hackaday.io vorgestellt.
Das folgende Diagramm zeigt die einzelnen Komponenten des CCU-Historians:
Da der CCU-Historian nur eine Java-Laufzeitumgebung zum Betrieb voraus setzt, ist er auf etlichen Hard- und Software-Plattformen lauffähig:
- Windows / Linux / MacOS
- x86 / x64 / ARM
Für bestimmte Systeme existieren fertige Installationspakete:
- CCU-Addon für folgende HomeMatic-Zentralen:
- CCU3
- RaspberryMatic
- Synology-Paket (DSM Version 6 und 7)
- Docker-Image
Hinweis: Für den Betrieb als Addon auf einer CCU3 oder RaspberryMatic muss an der Zentrale ein USB-Stick oder vorzugsweise eine USB-SSD angeschlossen sein!
Die Installationspakete sind bei den Veröffentlichungen zu finden.
Die Installation und Konfiguration ist im Handbuch ausführlich beschrieben.
Der CCU-Historian ist größtenteils in der Programmiersprache Apache Groovy geschrieben. Weitere Programmiersprachen sind Java und JavaScript. Als Entwicklungsumgebung wird die Eclipse IDE ab der V2025-03 in der Variante für Java-Entwickler verwendet. Das Paket ist auf der Download-Seite zu finden. Des Weiteren wird das Groovy-Eclipse-Plugin ab der V5.7.0 benötigt. Dieses Plugin ist im Eclipse Marketplace (Help → Eclipse Marketplace) zu finden und sollte automatisch zur Installation angeboten werden, wenn das CCU-Historian-Projekt importiert wird. Über File → Import → Projects from Git kann direkt das Repository geklont werden. Die Zielplattform ist Java Version 11.
Alle Beiträge zum Projekt müssen unter die GNU General Public License V3 gestellt werden. Die Lizenzen von verwendeten Bibliotheken müssen mit dieser kompatibel sein.
Dieses Projekt steht unter der GNU General Public License V3 mit folgenden Ausnahmen:
- Highstock/Highcharts JS: Creative Commons (CC) Attribution-NonCommercial licence
Bei einer kommerziellen Verwendung des CCU-Historians muss also auf die Erweiterung H2-Highcharts verzichtet werden, oder eine entsprechende Lizenz erworben werden.
Die Lizenzen von allen Abhängigkeiten sind im Ordner dist-generic/src/third-party-licenses zu finden.
Copyright (c) 2011-2025
- Mathias Dzionsko (Projektleiter, Hauptentwickler)
- Jens Maus (CCU/RaspberryMatic-Distribution)
- hotroot, Yannick Rocks, Thomas Zahari (Synology-Distribution)
- D. Domig (Docker Image)
- wak (Erweiterung H2-Highcharts)
- Wolfgang Schneiderhan (SVG-Trend)