Homebridge-openhab2 NPM

homebridge-openHAB2

Prerequisites

Installation

Install the mdns and avahi library:
sudo apt-get install libnss-mdns libavahi-compat-libdnssd-dev
Install homebridge:
npm install -g homebridge
This plugin is published through NPM and should be installed "globally" by typing:
npm install -g homebridge-openhab2 or if you have issues npm install -g --unsafe-perm homebridge-openhab2
Update your config.json file (usually is in your home/.homebridge/ directory, if you can't find, follow the instruction in homebridge). See config.json in this repository for a sample.

Configuration (config.json)

{
  "bridge": {
    "name": "openHAB2",
    "username": "CC:22:3D:E3:CE:30",
    "port": 51826,
    "pin": "031-45-154"
  },

  "description": "This is an example configuration file with one fake accessory and one fake platform. You can use this as a template for creating your own configuration file containing devices you actually own.",

  "accessories": [
  ],

  "platforms": [
    {
      "platform": "openHAB2",
      "name": "openHAB2",
      "host": "192.168.0.100",
      "port": "8080",
      "sitemap": "home"
    }
  ]
}

Fields:

"platform" - Must be set to openHAB2
"name" - Name that you see in homekit
"host" - IP address/host of the openHAB2 server
"port" - Port of the openHAB2 server
"sitemap" - Sitemap name of your openHAB2 server

Item Configuration (home.items)

This plugins uses the same logic for items configuration of HomeKit Add-on for openHAB2.

You will need to tag your openHAB items in order to view in HomeKit.

A full list of supported accessory types can be found in the table below.

See the sample below for example items:

Switch KitchenLight "Kitchen Light" <light> (groupKitchen) [ "Switchable" ]
Color KitchenRGB "Kitchen RGB" <light> (groupKitchen) [ "Switchable" ]
Dimmer KitchenDimmer "Kitchen Dim" <light> (groupKitchen) [ "Switchable" ]

Switch KitchenLight "Kitchen Light" <light> (groupKitchen) [ "Lighting" ]
Color KitchenRGB "Kitchen RGB" <light> (groupKitchen) [ "Lighting" ]
Dimmer KitchenDimmer "Kitchen Dim" <light> (groupKitchen) [ "Lighting" ]

Color KitchenRGB "Kitchen RGB" <light> (groupKitchen) [ "Dimmable" ]
Dimmer KitchenDimmer "Kitchen Dim" <light> (groupKitchen) [ "Dimmable" ]