Introduction
🚧 WORK-IN-PROGRESS 🚧
RaspberryMatic is an alternative, open source-based operating system for the commercially developed CCU3 and ELV-Charly control panels for the cloud-free use of HomeMatic/BidCos-RF and homematicIP hardware from the eQ3/ELV group of companies. RaspberryMatic has set itself the goal of not only making the complete range of functions of a HomeMatic CCU SmartHome central control unit usable for cloud-free use of HomeMatic/homematicIP devices for freely available single-board computers (SBC) such as the RaspberryPi, ASUS Tinkerboard or also as a virtualized variant for modern virtualization environments (e.g. Proxmox VE, VirtualBox, vmWare ESXi, etc.). Furthermore, it brings improvements and bug fixes at various levels (WebUI, Linux operating system, etc.) that are not (yet) available in the original CCU3 firmware from eQ3/ELV.
For communication with HomeMatic/homematicIP devices, RaspberryMatic makes use of the fact that eQ3/ELV has been offering USB-based wireless/communication hardware (HmIP-RFUSB, HM-CFG-USB) and also GPIO-based wireless modules (RPI-RF-MOD, HM-MOD-RPI-PCB), which can be plugged directly into the GPIO interface of an SBC and used for communication with BidCos-RF/HomeMatic (HmRF) and/or homematicIP (HmIP) components. Furthermore, they can also be operated using suitable GPIO adapter boards such as HB-RF-USB/HB-RF-USB-2 via USB or via Ethernet/LAN (HB-RF-ETH) and can therefore also be used either as a fully virtual machine under a virtualization environment such as Proxmox VE or as a Docker container within an existing operating system such as RaspberryPi OS or as an add-on within HomeAssistant.
RaspberryMatic is distributed in the form of complete images (*.img or *.ova), which can be used with suitable tools (e.g. Etcher, Raspberry Pi Imager) on a microSD card, USB stick/hard disk, eMMC or as a complete virtual machine and can therefore be used as an independent operating system for the communication/control/configuration of HomeMatic components. It follows the approach of a completely independent distribution and does not require a host operating system such as Raspbian/Debian. This has a number of advantages that increase stability and performance - but also has the disadvantage that third-party software (such as ioBroker, apache, mysql, etc.) can only be operated on the same system via the integrated "CCU-Addon" system. In this respect, RaspberryMatic claims to be a fully-fledged operating system replacement for a CCU control center and not to extend an existing Linux system with the functionality of a CCU control center.
RaspberryMatic can currently be installed on the following commercially available complete hardware (computer + HomeMatic communication module):
Or on the following self-assembled SBC/communication hardware or under the following virtualization environments:
- 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 ESXi
- vmWare Workstation Player
- HyperV
If you have successfully completed the basic installation on your own hardware or in your virtualization environment and you already have a different or older CCU central control unit from eQ3/ELV, you can find out how to adopt your existing configuration in the following sections.
