node-red-contrib-homegear-mqtt

Monitor and control your devices connect to Homegear from Node-RED.

Overview

node-red-contrib-homegear-mqtt interfaces with your Homegear server using MQTT and provides nodes for monitoring the published variables of your devices as well as changing their values and triggering actions.

Currently only the Homematic device family is supported but inclusion of MAX!, INSTEON an maybe even Hue is planned. However takes some time to write the required JSON device descriptions so please bear with me.

Installation

Per user:

cd ~/.node-red
npm install node-red-contrib-homegear-mqtt

Globaly:

sudo npm install -g --unsafe-perms node-red-contrib-homegear-mqtt

Requirements

node-red-contrib-homegear-mqtt uses MQTT and Homegears JSON-RPC interface.

Both are available in Homegear version 0.6 or later. As of the date of this writing (December 2015) this requires the snapshot versions of Homegear.

Make sure to set enable = true inside Homegears /etc/homegear/mqtt.conf.

TODOs

Things that are planned but not implemented (yet):

• [ ] refactor broker & homegearId to a separate config node (requires: https://github.com/node-red/node-red/issues/636)
• [ ] add support for familie selection
• [ ] add families for MAX!, INSTEON and maybe Hue (need to test that one)

Contributing

1. Fork the project
2. Create a feature branch
3. Code
4. Submit pull request to `master`