README.de.md

Die flexible, cloudfreie Homematic IP® CCU-Smart-Home-Lösung

_{Click here for 🇬🇧🇺🇸 english readme}

---

OpenCCU ist ein freies, nicht-kommerzielles Open-Source-Betriebssystem für einen cloudfreien Smart-Home-Hub, der mit eQ-3s Homematic IP / HomeMatic-Geräten kompatibel ist. Ziel ist die 100%ige Kompatibilität zur herstellerseitigen CCU3. OpenCCU kann direkt auf CCU3- und ELV Charly-Hardware installiert werden. Zudem läuft es auf gängigen SBCs (z. B. Raspberry Pi, Hardkernel ODROID, ASUS Tinker Board) sowie auf generischer x86-Hardware wie Intel NUC. Darüber hinaus ist OpenCCU als virtuelle Appliance für verbreitete Hypervisor- und Container-Plattformen verfügbar (z. B. Proxmox VE, VMware ESXi, VirtualBox, Synology VMM, Docker/OCI, Kubernetes) und als natives Home Assistant-Add-on. Über die CCU3-Parität hinaus bietet OpenCCU moderne WebUI-, OS- und Konnektivitäts-Erweiterungen für ein fortschrittlicheres Nutzererlebnis.

mehr...

🍪 Funktionen

• Drop-in-Kompatibilität. Unterstützt dieselbe Homematic-/Homematic-IP-Hardware, WebUI-Funktionen und Add-on-Ökosystem wie die Hersteller-Firmware der CCU.
• Austauschbare Backups. Sicherungen sind zwischen Hersteller-Firmware und OpenCCU kompatibel, was die Migration erheblich vereinfacht.
• Verbesserungen gegenüber der Hersteller-Firmware. Umfasst WebUI-Verbesserungen, Linux-OS-Updates, Stabilitäts-/Performance-Fixes und neue Funktionen, die upstream noch nicht oder ggf. nie vorhanden sind.

mehr...

💻 Systemvoraussetzungen

OpenCCU kann auf Hersteller-CCU-Hardware, gängigen SBCs und x86-Systemen installiert oder virtuell betrieben werden:

Hardware

• CCU3, ELV Charly
• Raspberry Pi
• ASUS Tinker Board
• Hardkernel ODROID
• Intel NUC

Virtualisierung & Container

• Proxmox VE, QEMU/KVM, XCP-ng/XenServer, VMware ESXi / Workstation Player, Hyper-V, VirtualBox
• Synology Virtual Machine Manager, QNAP Virtualization Station, Unraid
• Docker/OCI, LXC, Kubernetes (K8s)
• Home Assistant (Add-on)

mehr...

☁️ Schnellstart

1. Download

   • Lade das passende Image unter Releases.
   • Dateinamensmuster: OpenCCU-X.XX.XX.YYYYMMDD-<TARGET>.zip.

2. Installation (eine Option wählen)

   • Eigene Hardware (z. B. Raspberry Pi): Zip entpacken und die *.img auf eine microSD-Karte flashen (z. B. mit Etcher oder dd).
   • Migration von CCU2/CCU3: Das OpenCCU-Paket wie ein reguläres Firmware-Update hochladen.
   • Virtualisierte Umgebung: Der Installationsanleitung für die jeweilige Hypervisor-/Container-Plattform folgen.

3. Boot

   • Gerät/VM starten. Beim ersten Start erkennt OpenCCU verfügbare Homematic / Homematic IP-RF-Module (z. B. RPI-RF-MOD, HmIP-RFUSB) an GPIO oder USB.

4. WebUI aufrufen

   • http://openccu/ im Browser öffnen (oder die per DHCP vergebene IP verwenden, falls keine Namensauflösung verfügbar ist).
   • Es erscheint die gewohnte CCU-WebUI; nun können Homematic-/Homematic-IP-Geräte konfiguriert werden.
   • Optional: Bestehendes CCU-Backup einspielen, um die Konfiguration zu übernehmen.

mehr...

📝 Dokumentation (🇩🇪/🇺🇸)

1. Einleitung
   • Voraussetzungen
   • Funktionen
   • Einschränkungen
   • Lizenz & Haftung
   • Kommerzieller Vertrieb
2. Installation
   • Schnellstart
   • Grundinstallation (Hardware)
     • CCU3
     • ELV-Charly
     • RaspberryPi
     • ASUS Tinkerboard
     • Hardkernel ODROID
     • Intel NUC
   • Grundinstallation (Virtuell)
     • Proxmox Virtual Environment
     • Home-Assistant-Add-on
     • Docker-Container (OCI)
     • Linux-Container (LXC)
     • QEmu/KVM
     • Kubernetes/K8s
     • Synology Virtual Machine Manager
     • QNAP VirtualizationStation
     • UNRAID
     • XCP-ng/XenServer
     • Oracle VirtualBox
     • vmWare Workstation Player
     • vmWare ESXi
     • HyperV
   • Konfigurationsübernahme
     • Umstieg von CCU3
     • Umstieg von CCU2
     • Umstieg von CCU1
     • Umstieg auf virtuelle OpenCCU
   • Deinstallation
3. Administration
   • Firmware-Update/-Upgrade
   • Backup/Restore
   • Sicherheitshinweise
   • CCU-Add-ons / Zusatzsoftware
4. Nutzung
   • WebUI-Benutzung
     • Log-Daten und Log-Level
   • Tipps & Tricks
   • Experten-Features
     • WLAN/WiFi-Nutzung
     • Bluetooth-Nutzung
     • LAN-Gateway-Betrieb
     • USV-Client/Server-Nutzung
     • USB-Boot
     • Monit-Watchdog-Weboberfläche
     • HB-RF-ETH-Anbindung
     • Individueller Diagramm-/Backup-Speicherpfad
     • Eigene Aktionen während des Bootvorgangs
5. Support, Beiträge
   • Bekannte Probleme
   • Hilfe suchen
   • FAQ – Häufige Fragen
   • Fehler melden
   • Funktionen anfragen
   • Mitarbeit & Weiterentwicklung

😋 Support & Beiträge

Wo diskutieren / fragen

• Für allgemeine Fragen und Feedback GitHub Discussions nutzen.
• Deutschsprachige Nutzer: der OpenCCU-Bereich im HomeMatic-Forum.

Wann ein Issue eröffnen

• Wenn eine Diskussion einen klaren Feature-Wunsch oder einen reproduzierbaren Fehler bestätigt, ein Issue unter Issues anlegen.
• Bitte vorher nach bestehenden Issues suchen und angeben: OpenCCU-Version, Zielhardware/Hypervisor, Schritte zur Reproduktion, erwartetes vs. tatsächliches Verhalten, relevante Logs.

Möglichkeiten zur Mitarbeit

• Releases testen und bei der Reproduktion/Triage von offenen Issues helfen.
• Die wiki-basierte Dokumentation verbessern.
• Pull Requests prüfen und Feedback geben.
• Code-Beiträge (Bugfixes, Features) per Pull Request einreichen.

Pull Requests

• PRs fokussiert halten (ein Thema pro PR), das zugehörige Issue/die Diskussion verlinken und die Vorgaben in CONTRIBUTING beachten.
• Mit dem Beitrag stimmst du der Lizenzierung unter Apache-2.0 zu.

Community-Standards

• Bitte CODE OF CONDUCT lesen und befolgen.

mehr...

📜 Lizenzen

• Projekt & Release-Images. Das OpenCCU-Projekt (dieses Repository) und die unter Releases bereitgestellten Images stehen – sofern nicht anders angegeben – unter der Apache License 2.0. OpenCCU wird kostenlos und ohne kommerzielle Absichten bereitgestellt.

• Drittkomponenten. Einige enthaltene Komponenten haben andere Lizenzen und verbleiben unter deren Bedingungen. Beispiel: Buildroot/Linux steht unter GPLv2, was beim Ändern von Quelltexten oder beim Weiterverteilen abgeleiteter Images relevant sein kann. Die für die Konnektivität genutzten eQ-3 OCCU-Komponenten werden unter den Bedingungen der HMSL weitergegeben.

• Branding & Artwork. Das OpenCCU-Logo und weitere Grafiken in diesem Repository und in den Images unterliegen dem Urheberrecht der jeweiligen Autoren. Jede kommerzielle oder nicht-kommerzielle Wiederverwendung – insbesondere in weiterverteilten Binaries oder Forks – ist ohne vorherige schriftliche Genehmigung untersagt.

Haftungsausschluss

Sofern nicht gesetzlich vorgeschrieben oder schriftlich vereinbart, wird OpenCCU von den Beitragenden (und jeder Beitragende stellt seine Beiträge) „WIE BESEHEN“ bereitgestellt, OHNE JEGLICHE GEWÄHRLEISTUNGEN ODER BEDINGUNGEN, weder ausdrücklich noch stillschweigend, einschließlich unter anderem Eigentum, Nichtverletzung von Rechten Dritter, Marktgängigkeit oder Eignung für einen bestimmten Zweck. Du bist allein dafür verantwortlich zu beurteilen, ob die Nutzung oder Weitergabe von OpenCCU für dich geeignet ist, und trägst alle Risiken, die sich aus der Ausübung der unter dieser Lizenz gewährten Rechte ergeben.

mehr...

📖 Literatur

Wenn nach der Lektüre dieser Dokumentation noch Unklarheit über Vor- und Nachteile von OpenCCU gegenüber der herstellerseitigen CCU-Firmware besteht – oder wenn du die zusätzlichen Funktionen von OpenCCU vertieft kennenlernen möchtest – verweisen wir auf folgende (überwiegend deutschsprachige) Ressourcen:

• Vortragsfolien HomeMatic-Usertreffen 2019
• Vortragsfolien HomeMatic-Usertreffen 2018
• Vortragsfolien HomeMatic-Usertreffen 2017
• Vortragsfolien HomeMatic-Usertreffen 2016

👏 Danksagungen

Zusätzlich zu allen Contributors, die OpenCCU möglich gemacht haben, danken wir besonders:

• Alexander Reinert (@alexreinert) — für das latenzarme generic_raw_uart-Kernelmodul zur Anbindung von eQ-3-RF-Modulen (RPI-RF-MOD, HM-MOD-RPI-PCB, HmIP-RFUSB) sowie für die Open-Hardware-Adapterplatinen HB-RF-USB, HB-RF-USB-2 und HB-RF-ETH, die USB-/Ethernet-Schnittstellen für diese Module bereitstellen.

👪 Autoren

OpenCCU wird von einer breiten Community entwickelt. Die vollständige und aktuelle Liste der Autoren und Mitwirkenden findet sich unter Contributors.

🚧 Changelog

Eine detaillierte, versionsbezogene Liste der Änderungen findet sich unter Releases in diesem Repository. Jeder Release enthält Hinweise zu neuen Funktionen, Fehlerbehebungen und weiteren Anpassungen.