Skip to content

Latest commit

 

History

History
87 lines (57 loc) · 6.12 KB

README.en.md

File metadata and controls

87 lines (57 loc) · 6.12 KB


Current Release Dependencies Status Installs

Node-RED as Addon for the Homematic CCU3 and RaspberryMatic

RedMatic combines several software components into a CCU Addon, a software package that can be comfortably installed on a Homematic CCU3 or RaspberryMatic. Homematic is a series of smart home automation products by the manufacturer eQ-3, popular especially in Germany.

The basis is formed by Node-RED with the CCU Nodes for Node-RED. These components offer the possibility to visually and easily create rules, automations, scripts and connections to external services and systems for a Homematic System. To a large extent even without programming knowledge. In the Wiki you can find more information about Node-RED and some Application examples (so-called Flows).

For visualization and control RedMatic WebApp and Node-RED Dashboard are included. RedMatic WebApp is a User interface that can be used immediately without further configuration (comparable to WebMatic or Yahui). Node-RED Dashboard is a configurable user interface which can offer more possibilities than the RedMatic WebApp, but needs some configuration effort. Example screenshots: RedMatic WebApp, Node-RED Dashboard.

Furthermore the included extension RedMatic HomeKit makes it possible to control Homematic devices and other in Node-RED available systems via Siri and with HomeKit apps.

A connection of the CCU to a MQTT broker with convenient configurable topic and payload structure is simplified by a special node.

In addition, a large and active community around Node-RED created a library of thousands of additional nodes which can be installed easily and offer connections to various other services and systems - such as the Xiaomi Aqara Smart Home System, Loxone, the Logitech Harmony Hub, various Smart TVs and AV receivers, Sonoff, Hue, Lightify, Tradfri, ArtNET/DMX, Modbus, Amazon Alexa, Google Home, various databases such as InfluxDB or MySQL, web services to query weather data and much more.

RedMatic can thus - especially for those who don't want to run another server besides the CCU - provide an alternative to a "mature" Smart Home System such as Home Assistant, ioBroker, OpenHAB or FHEM. For the automation of a Homematic system, RedMatic can also be used as an alternative or supplement to "Rega". Programs/Scripts.

Requirements

RedMatic is only suitable for the CCU3 and RaspberryMatic. Since RedMatic may consume more than 200MB memory it is advisable to use a RaspberryPi with 1GB RAM (Pi 2B and up). On the CCU1/2 RedMatic can not be used.

A modern browser is required to use the web interfaces, Internet Explorer is not supported.

Quick Start

On the Releases Page the file redmatic-<version>.tar.gz is available for download. After the installation of the addon via the Homematic WebUI (Control Panel -> additional software) and the subsequent reboot of the CCU is Node-RED is reachable at http://<ccu-addresse>/addons/red. Patience is required during installation, it can take up to ~10 minutes. Some sample flows as well as a simple dashboard are already preconfigured, the dashboard is reachable at http://<ccu-address>/addons/red/ui.

Support, Contributing

For feedback of any kind, questions, suggestions, wishes and bug reports please use the Issue Tracker. Alternatively there is Slack.

Participation in any form is welcome and desired, especially all users are invited to extend the list of successfully tested nodes, to publish sample flows and to contribute to the improvement and extension of the documentation.

No donations will be accepted, but I would be happy if the successful usage of this software is acknowledged by giving the project a Github star ⭐️

Documentation

Sorry, the Documentation is not yet translated into English. German Documentation

Licenses

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.