• Stars
    star
    1,518
  • Rank 30,787 (Top 0.7 %)
  • Language
    JavaScript
  • License
    Apache License 2.0
  • Created over 8 years ago
  • Updated about 1 month ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

🏠 A feature-rich but lightweight, buildroot-based Linux operating system alternative for your CloudFree CCU3/ELV-Charly 'homematicIP CCU' IoT smarthome central. Running as a pure virtual appliance (ProxmoxVE, Home Assistant, LXC, Docker/OCI, Kubernetes/K8s, etc.) on a dedicated embedded device (RaspberryPi, etc.) or generic x86/ARM hardware.


– The alternative/free operating system for your HomeMatic CCU

Current Release Downloads DownloadsSnapshots CI Build Snapshot Build Contributors Average time to resolve an issue Percentage of issues still open Commits since last release Artifact HUB License Donate GitHub sponsors Twitter GitHub stars

Deutschsprachiges πŸ‡©πŸ‡ͺπŸ‡¦πŸ‡ΉπŸ‡¨πŸ‡­ ReadMe


RaspberryMatic is a free and non-commercial open-source operating system alternative for running a cloud-free smart-home IoT central to provide connectivity to the homematicIP / HomeMatic hardware line of IoT devices developed by eQ-3 and distributed by ELV. RaspberryMatic has the aim to be 100% compatible to the vendor-developed HomeMatic CCU3 control central (CCU3) system. It can be directly installed on a CCU3 or ELV Charly hardware device. Alternatively, it can also be installed on a wide range of freely available single-board-computers (SBC) like a RaspberryPi, ASUS Tinkerboard, Hardkernel ODROID or even on full-fledged hardware platforms like an Intel NUC system. Furthermore, it can be run as a virtual appliance in modern virtualization environments (e.g. Proxmox VE, VirtualBox, Synology VMM, Docker/OCI, Kubernetes/K8s, vmWare ESXi, etc.) or even as a pure Home Assistant Add-On. On top of that wider range of supported operating environments, it also comes with exclusive features on different levels (WebUI, Linux OS, connectivity, etc.) to support end users with a more modern and advanced user experience compared to the vendor-provided CCU3 operating system.

more...

πŸͺ Features

Due to the used base components, RaspberryMatic is 100% compatibile to the standard CCU control center distributed by eQ3/ELV (CCU2/CCU3). This means, that not only it can use the same HomeMatic/homematicIP IoT hardware like a CCU3 central with the same base version. It also provides the same level of functionality in areas like the WebUI or Add-on compatibility. Furthermore, even system backups are compatible between the two CCU variants, which allows to easily switch between the vendor-provided CCU firmware and this free open-source based CCU system software.

On top of that, RaspberryMatic provides a whole bunch of enhancements or even bugfixes in the WebUI or underlying Linux operating system which are either not yet integrated in the official eQ3 CCU firmware or will never be integrated due to the functionality not being commercially interesting enough for eQ3/ELV.

more...

πŸ’» Requirements

RaspberryMatic can be directly installed on the following, commercially distributed CCU hardware:

...or as a virtual appliance on the following virtualization environments:

more...

☁️ Quick-Start

Under Releases you will find dedicated images/files for each supported target hardware. Such an image is e.g. available as an RaspberryMatic-X.XX.XX.YYYYMMDD-XXX.zip download file. After having unarchived this file you should identify a *.img file which can be "flashed" to an adequate target media (sd card, usb-stick, ssd or virtual disk, etc.) using e.g. an imaging tool like Etcher. After having flashed this image on the target media you can then put it into your SBC or CCU3 hardware and boot the system. Depending on the used hardware, RaspberryMatic should then boot-up and try to identify the used HomeMatic/homematicIP RF-Module hardware potentially installed on the GPIO bus of your SBC. If this boot-up is finished, you should be able to access the standard WebUI in your local network by using the address http://homematic-raspi/ in your web browser. Afterwards you should then find yourself in then normal CCU WebUI where you can start configuring/using your HomeMatic/homematicIP IoT hardware.

more...

πŸ“ Documentation (πŸ‡©πŸ‡ͺ/πŸ‡ΊπŸ‡Έ)

  1. Introduction
  2. Installation
  3. Administration
  4. Usage
  5. Support, Contributions

πŸ˜‹ Support, Contributions

To provide general feedback or start discussions, please use either the Discussion fora in this GitHub project or (if you are german speaking) please contribute to the RaspberryMatic fora of the HomeMatic-Forum. If during discussions in these fora a definite and unique feature request or bug has been acknowledged by other RaspberryMatic users, please feel free to open a dedicated feature or bug fixing request in the issue tracker.

Any contribution in any way is highly welcome. Please feel free to contribute not only by using the official releases. If you have some time and free resources, we welcome any contributing to help to reproduce and perhaps even fixing any open issues in our issue tracker. Also participating in enhancing or fixing the official wiki-based documentation is appreciated. That's why any logged-in GitHub user can directly add and modify any documentation pages in this wiki.

On top of that, direct contributions by sending in PullRequests and source code contributions (Bugs, Features, etc.) are welcome. So if someone would like to see a certain feature implemented or bug fixed and has enough free resources and knowhow, please feel free to directly send in PullRequests using Git/GitHub. Please note, however, that any contribution to this open source project have to be in accordance to the Apache-2.0 open source license under which RaspberryMatic itself is developed and distributed. So by sending in PullRequests you will have to acknowledge that you are fine with the license implications of your contributions. Therefore, please refer to CONTRIBUTING as well as reading our CODE OF CONDUCT before you consider contributing to this project in any form.

more...

πŸ“œ Licenses

The RaspberryMatic project itself – the files in this repository – as well as the downloadable binary images in the Releases section are distributed under conditions of the open source Apache License 2.0 license, if not otherwise stated. RaspberryMatic itself is distributed completly free of charge and without any commercial intension whatsoever. Please note, that on top of the Apache-2.0 license, under which RaspberryMatic itself is distributed, other components (e.g. the underlying Buildroot/Linux Operating System) are distributed under different licenses. E.g. Buildroot/Linux itself is distributed under the GPLv2 which could have other implications when changing source parts or distributing own RaspberryMatic images. Furthermore, the eQ-3 OCCU components RaspberryMatic uses to provide the HomeMatic/homematicIP interconnectivity are re-distributed under the HMSL license terms. Furthermore, the RaspberryMatic logo and all other graphical image files in this repository and the downloadable binary images which are closely linked to this project are copyrighted by its sole authors. Any commercial and non-commercial (re-)use of these graphical image files or use of the RaspberryMatic logo are strictly prohibited when distributing own binary distributions or forked versions of RaspberryMatic.

Disclaimer of Warranty

All project contributors provide RaspberryMatic (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing RaspberryMatic and assume any risks associated with Your exercise of permissions under this License.

more...

πŸ“– Literature

If after reading through this documentatin anyone is still unsure regarding the pros and cons of using RaspberryMatic rather than the standard vendor-provided CCU firmware or if someone would like to read / see more on which additional features RaspberryMatic provides, please see the following list of (mostly german speaking) literature:

Usertreffen Kassel 2019 – RaspberryMatic Usertreffen Kassel 2018 – RaspberryMatic Usertreffen Kassel 2017 – RaspberryMatic (Teil 1) Usertreffen Kassel 2017 - RaspberryMatic (Teil 2)

πŸ‘ Acknowledgements

In addition to the whole list of Contributors which have contributed to the success of RaspberryMatic, we would like to explicitly thank the following list of people for their third-party contributions:

  • Alexander Reinert (@alexreinert) – for his low-latency generic_raw_uart kernel module which allows to use the eQ3 distributed RF modules (RPI-RF-MOD, HM-MOD-RPI-PCB) as well as for his HB-RF-USB, HB-RF-USB-2 and HB-RF-ETH open hardware projects providing USB and Ethernet based adapter PCBs to use the eQ3 RF modules with other base interfaces.

πŸ‘ͺ Authors

Due to the large number of existing people having contributed to the success of RaspberryMatic, please refer to the Contributors accordingly.

🚧 ChangeLog

A detailed list of Changes between individual released versions can be reviewed through the Releases section of this GitHub project.

More Repositories

1

node-unifi

NodeJS class for querying/controlling a UniFi-Controller (UDM-Pro, UDM-SE, UDM, UDR, UDW, CloudKey Gen1/Gen2) from Ubiquiti (www.ui.com)
JavaScript
138
star
2

node-ical

NodeJS class for parsing iCalendar/ICS files
JavaScript
118
star
3

amissl

πŸ” AmiSSL is the AmigaOS/MorphOS/AROS port of OpenSSL. It wraps the full functionality of OpenSSL into a full-fledged Amiga shared library that makes it possible for Amiga applications to use the full OpenSSL API through a standard Amiga shared library interface (e.g. web browsers wanting to support HTTPS, etc.)...
C
86
star
4

cuxd

CUx-Daemon – a universal interface between the HomeMatic CCU logic layer (ReGaHSS) and third-party (EnOcean, M-Bus, 1-Wire, ArtDMX, etc.) external and virtual devices.
C
65
star
5

yam

πŸ“¬ YAM (short for 'Yet Another Mailer') is a MIME-compliant open-source Internet email client written for Amiga-based computer systems (AmigaOS4, AmigaOS3, MorphOS, AROS). It supports POP3, SMTP, TLSv1/SSLv3 connection security, multiple users, multiple identities, PGPv2/v5 encryption, unlimited hierarchical folders, an ARexx interface, etc...
C
61
star
6

thinRoot

thinRoot is a buildroot (https://buildroot.org/) powered operating system environment to create lightweight user-defined kiosk systems or ThinClients (e.g. using x86 hardware, RaspberryPi, ASUS Tinkerboard, etc.) to smoothly connect to server-based desktop environments via ThinLinc, RDP, SPICE@ProxmoxVE, VNC or to create a simply web-kiosk.
Python
51
star
7

libcodesets

codesets.library is an AmigaOS shared library to handle different codesets (i.e. ISO-8859-1, UTF-8, etc.) and their respective conversions. It provides public functions for applications to deal with multiple codesets and convert them properly.
C
18
star
8

lrecog

A neuronal network based image recognition application that aims on the automatic recognition of tree species according to available images of the leaves of each species. With help of this application botanists can then identify different species...
Java
14
star
9

magicmenu

MagicMenu is a menu enhancer for AmigaOS oriented operating systems. It allows to override the default look&feel of menus presented in AmigaOS and provides a user configurable way to show nice looking menus instead of the default ones...
C
12
star
10

vxext_fs

Linux kernel module for VxWorks extended DOS filesystem support.
C
9
star
11

node-panasonic-viera

NodeJS class to query and control Panasonicβ„’ Vieraβ„’ Smart-TVs
JavaScript
8
star
12

libopenurl

A library (openurl.library) and tools for opening an application in accordance to a supplied URL. It is explicitly designed to be used by AmigaOS compatible operating systems such as AmigaOS3, AmigaOS4, MorphOS or AROS.
C
7
star
13

occu

Tcl
7
star
14

amide

AmIDE - Amiga Integrated Development Environment is a modern MUI based IDE system that should make the Amiga developer able to use his favourite Compiler system with a modern looking GUI System with features like filetype handling, Build/Make, TextEd
C
6
star
15

newsrog

NewsRog is the most powerful newsreader available for the Amiga platform. Combining a Magic User Interface frontend, an OOP approach and its overwhelming list of features, it provides the best experience even to the most demanding Usenetters.
C
6
star
16

anfs

An implementation of the Network File System protocol (NFS) for AmigaOS-based operating systems. This project is open source and based on the formerly known 'ch_nfs' NFS client and the "nfsd" NFS server implementation originally targeted for AmiTCP...
C
5
star
17

jens-maus

Personal Page Repo
4
star
18

dessolver

A Java-based Ordinary Differential Equation (ODE) System Solver Application...
Java
4
star
19

betterlayers

A replacement library which aim in replacing the default AmigaOS "layers.library" to more efficently manage layers operations on modern AmigaOS operating systems. It comes with some advanced layers techniques to speed up operations...
C
4
star
20

occu-test

Automated System Tests of "ReGaHss" - the HomeMatic (O)CCU "Logic Layer" Engine...
JavaScript
3
star
21

librtdebug

librtdebug is a comprehensive runtime debugging library which allows developers to insert predefined macros within their own source code and track the 'runtime' of their applications via standardized textual output...
C++
2
star
22

xmlrpcpp

Fork of unmaintained http://xmlrpcpp.sf.net with patches and certain fixes applied
C++
1
star