https://github.com/healscodes/node-red-contrib-homegear-mqtt

Interact with Homegear connected devices via mqtt
https://github.com/healscodes/node-red-contrib-homegear-mqtt

Last synced: about 2 months ago
JSON representation

Interact with Homegear connected devices via mqtt

• Host: GitHub
• URL: https://github.com/healscodes/node-red-contrib-homegear-mqtt
• Owner: HealsCodes
• License: mit
• Created: 2015-12-21T11:04:48.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2018-08-20T20:45:15.000Z (almost 7 years ago)
• Last Synced: 2025-03-21T03:36:42.549Z (2 months ago)
• Language: JavaScript
• Size: 113 KB
• Stars: 8
• Watchers: 2
• Forks: 3
• Open Issues: 10
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
node-red-contrib-homegear-mqtt

===============================

Monitor and control your devices connect to [Homegear](https://www.homegear.eu) from [Node-RED](https://nodered.org).

[![npm version](https://badge.fury.io/js/node-red-contrib-homegear-mqtt.svg)](http://badge.fury.io/js/node-red-contrib-homegear-mqtt) [![Build Status](https://travis-ci.org/Shirk/node-red-contrib-homegear-mqtt.svg?branch=master)](https://travis-ci.org/Shirk/node-red-contrib-homegear-mqtt) [![Coverage Status](https://coveralls.io/repos/Shirk/node-red-contrib-homegear-mqtt/badge.svg?branch=master&service=github)](https://coveralls.io/github/Shirk/node-red-contrib-homegear-mqtt?branch=master) [![Dependency Status](https://david-dm.org/shirk/node-red-contrib-homegear-mqtt.svg)](https://david-dm.org/shirk/noder-red-contrib-homegear-mqtt)

### Overview

node-red-contrib-homegear-mqtt interfaces with your [Homegear](https://www.homegear.eu) 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](https://github.com/shirk/node-red-contrib-homegear-mqtt/blob/master/docs/json-device-description.md) so please bear with me.**

![Sample Node-RED setup](https://github.com/shirk/node-red-contrib-homegear-mqtt/raw/master/docs/sample-1.png)

![Sample input config](https://github.com/shirk/node-red-contrib-homegear-mqtt/raw/master/docs/config-in.png)

![Sample output config](https://github.com/shirk/node-red-contrib-homegear-mqtt/raw/master/docs/config-out.png)

### Installation

Per user:

```bash

cd ~/.node-red

npm install node-red-contrib-homegear-mqtt

```

Globaly:

```bash

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](https://www.homegear.eu) version *0.6 or later*.

As of the date of this writing (December 2015) this requires the snapshot versions of [Homegear](https://www.homegear.eu).

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`