damianxd / homebridge-vera

Apache License 2.0
50 stars 37 forks source link

Looking for adoption

We are searching for some developer who's willing to take this project. None of the original developers is active any more, if you want to be in charge, please contact me thru the issues section.

VeraLink

VeraLink is an application for Z-Wave accessories from Vera to run as HomeKit Accessory Servers, allowing the devices to connect to iOS devices and be controlled by Siri.

This application use HAP-NodeJS (https://github.com/KhaosT/HAP-NodeJS) to create the HAP servers while connecting to the Luup Requests service from Vera to control the devices.

Installation

VeraLink requires the following libraries and applications to run:

In Ubuntu/Debian system you can install the requirements with the following:

sudo apt-get update

sudo apt-get install nodejs npm git-core libnss-mdns libavahi-compat-libdnssd-dev

sudo npm config set registry http://registry.npmjs.org/

sudo npm install -g node-gyp

Once all the libraries are set, you can download the actual program:

For homebridge version:

sudo npm install -g --unsafe-perm homebridge

sudo npm install -g homebridge-vera

Starting the APP

Edit your homebridge config.json file located on ~/.homebridge/config.json and add the platform for Vera, example:

{
    "bridge": {
        "name": "Homebridge",
        "pin": "987-65-432",
        "username": "CC:22:3D:E3:CE:30"
    },
    "platforms": [
        {
            "platform": "Vera",
            "name": "Vera",
            "veraIP": "10.0.1.5",
            "includesensor": false,
            "ignorerooms": [20,21,22],
            "securitypoll": 2000,
            "includethermostat": false,
            "includeRGB": false,          
            "garageLocks": [23],
            "ignoredevices":[24,25],
            "ignorescenes":[26,27],
            "ignoreplugins": ["Nest","PhilipsHue","Wemo"],
            "houseModes": false
        }
    ]
}

then you can run the app with the following command:

homebridge

Run it on the background

If you want to use it as a service, you can run it with forever https://github.com/foreverjs/forever

Options

You can change all the current options on the config.js file and it include:

Recomendation

Use Insteon+ app to add sections, rooms and devices; you can also edit the Siri name of each device with it so it can be easier to trigger any accessory with a voice command.

Debug

VeraLink and The HAP-NodeJS library support the debug library for log output. You can print some or all logs by setting the DEBUG environment variable. For instance, to see all debug logs while running the server:

DEBUG=* node VeraLink.js

Notes

Special thanks to Albeebe for all his work and his original idea to get Vera to work with HAP, Alex Skalozub who reverse engineered the server side HAP and the biggest of thanks to Khaos Tian who made the awesome HAP-NodeJS implementation.

Known issues