# RaspberryMatic [](https://travis-ci.org/jens-maus/RaspberryMatic) [](https://codeclimate.com/github/jens-maus/RaspberryMatic) [](https://opensource.org/licenses/Apache-2.0) [](https://github.com/jens-maus/RaspberryMatic/issues)

The RaspberryMatic project is a collaborate effort to provide a Linux/buildroot-based HomeMatic compatible distribution for embedded devices like the RaspberryPi. It is based on the Open-Central-Control-Unit-SDK (OCCU) provided by eQ-3 as part of the HomeMatic home automation platform. The RaspberryMatic distribution is provided as a full microSD card image that can be directly flashed and then used in a RaspberryPi as the main operating system for controlling all kind of HomeMatic compatible devices with full compatibility to a CCU2 device directly sold by eQ-3.

Features

• Fully HomeMatic CCU system compliant supporting latest OCCU software releases
• Fully self-contained SD card image primarily targeted for RaspberryPi hardware
• Up to date Buildroot environment with speed optimized hard-float support and Linux kernel v4+ versions
• Read-only root file system to minimize write operations on SD card
• Direct support for RTC clock module (PiFace Shim RTC)
• Hardware WatchDog support automatically rebooting the system upon hardware problems

Limitations

• No HomeMatic-IP support yet (Work in Progress!)
• Updates require complete Backup/Restore procedure
• adapted HomeMatic CCU Addon packages required (CCU2 versions don't work)

Requirements

• RaspberryPi 3
• microSD card (4GB minimum)
• HomeMatic GPIO hardware module (HM-MOD-RPI-PCB)

Compatible Third-Party Addons

The CCU platform allows to enhance the functionality of a CCU by installing so-called Addon packages. For RaspberryMatic, standard CCU-Addon packages won't work because included binaries have to be recompiled for the hard-float buildroot environment RaspberryMatic uses. Here is a list of well-known already compatible Addon packages (please note that this list might be incomplete):

• CUxD
• XML-API
• hm_pdetect
• Email-Addon
• CUxD-Highcharts
• HQ-WebUI
• DB-Access
• QuickAccess
• Script-Parser
• WebMatic
• Sonos Player
• hm2mqtt
• CCU-Historian
• Watchdog

License

The RaspberryMatic build environment itself – the files found in this git repository – as well as the RaspberryMatic sd card images are licensed under the conditions of the Apache License 2.0. Please note, however, that the buildroot distribution RaspberryMatic is using is licensed under the GPLv2 license instead. Furthermore, the eQ-3 OCCU software RaspberryMatic is using to provide HomeMatic-based services is licensed under the (HMSL).

Contributions

As the RaspberryMatic project is an open source based project everyone is invited to contribute to this project. Please note, however, that functionality within the corresponding eQ-3 OCCU binaries can not be modified as the main HomeMatic services (rfd, ReGaHSS, HMServer, etc.) are only provided in binary format by the OCCU project.

Authors

• Jens Maus
• Wolfgang Willinghöfer

ChangeLog / Roadmap

• 2.25.15-XXXXXXXX (beta – Not yet released)

  • HomeMatic-CCU 2.25.15 compatibility
  • working Backup / Restore / Factory-Reset
  • finalized Filesystem structure (read-only root file system)
  • working addon install/removal routines
  • implemented boot splash screen
  • implemented hardware watchdog support
  • ntpd is used as a network time protocol (NTP) daemon

• 2.21.10-20160821 (alpha)

  • First development version. There are still broken features like filesystem structure (readonly root file system), backup, restore, install extensions..., but it's possible to teach-in and controll HomeMatic RF devices.