{"id":13604663,"url":"https://github.com/mdzio/ccu-historian","last_synced_at":"2025-07-19T08:39:27.612Z","repository":{"id":37502524,"uuid":"76988828","full_name":"mdzio/ccu-historian","owner":"mdzio","description":"Der CCU-Historian erfasst die Betriebsdaten des Hausautomations-Systems HomeMatic der Firma eQ-3.","archived":false,"fork":false,"pushed_at":"2025-06-22T17:42:50.000Z","size":122991,"stargazers_count":123,"open_issues_count":50,"forks_count":15,"subscribers_count":28,"default_branch":"master","last_synced_at":"2025-06-22T18:25:30.179Z","etag":null,"topics":["aquisition","ccu","ccu-historian","data","homematic","pims","smarthome"],"latest_commit_sha":null,"homepage":"http://www.ccu-historian.de","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mdzio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"custom":"https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=SF4BR9ZE2JUBS"}},"created_at":"2016-12-20T20:20:32.000Z","updated_at":"2025-06-22T17:42:53.000Z","dependencies_parsed_at":"2024-01-02T20:30:48.040Z","dependency_job_id":"d498cd07-937b-4430-a16b-40728c0565a0","html_url":"https://github.com/mdzio/ccu-historian","commit_stats":null,"previous_names":[],"tags_count":69,"template":false,"template_full_name":null,"purl":"pkg:github/mdzio/ccu-historian","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mdzio%2Fccu-historian","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mdzio%2Fccu-historian/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mdzio%2Fccu-historian/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mdzio%2Fccu-historian/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mdzio","download_url":"https://codeload.github.com/mdzio/ccu-historian/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mdzio%2Fccu-historian/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265905116,"owners_count":23846696,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aquisition","ccu","ccu-historian","data","homematic","pims","smarthome"],"created_at":"2024-08-01T19:00:49.907Z","updated_at":"2025-07-19T08:39:27.607Z","avatar_url":"https://github.com/mdzio.png","language":"Java","funding_links":["https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=SF4BR9ZE2JUBS"],"categories":["CCU Addons"],"sub_categories":[],"readme":"[![Release](https://img.shields.io/github/release/mdzio/ccu-historian.svg)](https://github.com/mdzio/ccu-historian/releases/latest)\r\n[![Downloads](https://img.shields.io/github/downloads/mdzio/ccu-historian/total.svg)](https://github.com/mdzio/ccu-historian/releases)\r\n[![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=SF4BR9ZE2JUBS)\r\n\r\n# CCU-Historian\r\n\r\nLangzeitarchiv für die Zentrale (CCU) des Hausautomations-Systems HomeMatic.\r\n\r\n![cover](doc/cover.png)\r\n\r\nDer CCU-Historian ist ein Langzeitarchiv für die Zentrale (CCU) des [Hausautomations-Systems](http://de.wikipedia.org/wiki/Hausautomation) HomeMatic der Firma [eQ-3](http://www.eq-3.de/).\r\n\r\nDie 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.\r\n\r\nMit vielen tausend Installationen erfreut sich der CCU-Historian bei den HomeMatic-Anwendern einer großen Beliebtheit.\r\n\r\n**[Viele weitere Informationen sind im umfangreichen Handbuch zu finden.](https://github.com/mdzio/ccu-historian/wiki)**\r\n\r\n## Übersicht\r\n\r\nDas folgende Diagramm zeigt die einzelnen Komponenten des CCU-Historians:\r\n\r\n![CCU-Historian Übersicht](doc/ccu-historian-overview.svg)\r\n\r\n## Unterstützte Plattformen\r\n\r\nDa der CCU-Historian nur eine [Java-Laufzeitumgebung](https://java.com/) zum Betrieb voraus setzt, ist er auf etlichen Hard- und Software-Plattformen lauffähig:\r\n\r\n* Windows / Linux / MacOS\r\n* x86 / x64 / ARM\r\n\r\nFür bestimmte Systeme existieren fertige Installationspakete:\r\n\r\n* CCU-Addon für folgende HomeMatic-Zentralen:\r\n  * CCU3\r\n  * [RaspberryMatic](https://github.com/jens-maus/RaspberryMatic)\r\n* Synology-Paket (DSM Version 6 und 7)\r\n* Docker-Image\r\n  * [mdzio/ccu-historian](https://hub.docker.com/r/mdzio/ccu-historian)\r\n\r\n**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!\r\n\r\n## Installationspakete\r\n\r\nDie Installationspakete sind bei den [Veröffentlichungen](https://github.com/mdzio/ccu-historian/releases) zu finden.\r\n\r\n## Installation und Konfiguration\r\n\r\nDie Installation und Konfiguration ist im [Handbuch](https://github.com/mdzio/ccu-historian/wiki#installation) ausführlich beschrieben.\r\n\r\n## Entwicklungsumgebung\r\n\r\nDer CCU-Historian ist größtenteils in der [Programmiersprache Apache Groovy](http://groovy-lang.org) geschrieben. Weitere Programmiersprachen sind Java und JavaScript. Als Entwicklungsumgebung wird die [Eclipse IDE](http://www.eclipse.org) ab der V2025-03 in der Variante für Java-Entwickler verwendet. Das Paket ist auf der [Download-Seite](https://www.eclipse.org/downloads/packages/) zu finden. Des Weiteren wird das [Groovy-Eclipse-Plugin](https://github.com/groovy/groovy-eclipse/wiki) 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.\r\n\r\nAlle Beiträge zum Projekt müssen unter die [GNU General Public License V3](LICENSE.txt) gestellt werden. Die Lizenzen von verwendeten Bibliotheken müssen mit dieser kompatibel sein.\r\n\r\n## Lizenz und Haftungsausschluss\r\n\r\nDieses Projekt steht unter der [GNU General Public License V3](LICENSE.txt) mit folgenden Ausnahmen:\r\n\r\n* Highstock/Highcharts JS: [Creative Commons (CC) Attribution-NonCommercial licence](http://creativecommons.org/licenses/by-nc/3.0/)\r\n\r\nBei einer kommerziellen Verwendung des CCU-Historians muss also auf die Erweiterung H2-Highcharts verzichtet werden, oder eine entsprechende Lizenz erworben werden.\r\n\r\nDie Lizenzen von allen Abhängigkeiten sind im Ordner [dist-generic/src/third-party-licenses](https://github.com/mdzio/ccu-historian/tree/master/dist-generic/src/third-party-licenses) zu finden.\r\n\r\n## Autoren\r\n\r\nCopyright (c) 2011-2025\r\n\r\n* [Mathias Dzionsko](https://github.com/mdzio) (Projektleiter, Hauptentwickler)\r\n* [Jens Maus](https://github.com/jens-maus) (CCU/RaspberryMatic-Distribution)\r\n* [hotroot](https://github.com/hotroot), Yannick Rocks, [Thomas Zahari](https://github.com/tzahari) (Synology-Distribution)\r\n* [D. Domig](https://github.com/jokay) (Docker Image)\r\n* [wak](https://github.com/wakr70) (Erweiterung H2-Highcharts)\r\n* Wolfgang Schneiderhan (SVG-Trend)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmdzio%2Fccu-historian","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmdzio%2Fccu-historian","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmdzio%2Fccu-historian/lists"}