homebridge-zway-velux v0.0.6

homebridge-zway-velux

Homebridge plugin for controlling Velux blinds by triggering Z-Wave switches via HTTP using a Z-Way Server instance.

This plugin is all about triggering switches by performing HTTP requests to a Z-Way Server. In my case, I used Fibaro FGS-222 Z-Wave switches. One of the switches is connected to the power supply of the Velux shutter blinds and the other one to a Velux KLF 050 controller module, which actually controls the blinds' movement. The switch for the power supply is optional and enables the power supply to be completely disconneced from the electric power when the blinds are not moving (to silence the transformators and to save energy).

Setup

Hardware Stack

The hardware setup is shown as follows. I use a RaZberry module for my Raspberry Pi to communicate with the Z-Wave switches. These are connected to the blinds' power supply and to the Velux KLF 050 controller, which controls the blinds wirelessly.

Software Stack

To get the plugin working, an installed Z-Way Server is required. With the Z-Way Server, you can manage all your Z-Wave devices, in this case 2 Fibaro GS-222 switches. The Z-Way Server allows to utilize devices via HTTP requests, which is the main purpose of this plugin.

Installation

First, install Homebridge. See https://www.npmjs.com/package/homebridge for more information.

Then install this plugin:

$ sudo npm install homebridge-zway-velux -g

If you are having permission problems during install, try this:

$ sudo npm install homebridge-zway-velux -g --unsafe-perm

To add this plugin to a Homebridge installation, you have to add a new accessory to the config.json file. The configuration variables are described in the following table:

Example accessory in config.json:

{
    ...
    
    "accessories": [
        ...

        {
            "accessory": "ZWayVelux",
            "name": "Blinds",
            "powerOnUrl": "http://localhost:8083/ZAutomation/api/v1/devices/ZWayVDev_zway_3-1-37/command/on",
            "powerOffUrl": "http://localhost:8083/ZAutomation/api/v1/devices/ZWayVDev_zway_3-1-37/command/off",
            "openStartUrl": "http://localhost:8083/ZAutomation/api/v1/devices/ZWayVDev_zway_4-2-37/command/on",
            "openStopUrl": "http://localhost:8083/ZAutomation/api/v1/devices/ZWayVDev_zway_4-2-37/command/off",
            "closeStartUrl": "http://localhost:8083/ZAutomation/api/v1/devices/ZWayVDev_zway_4-0-37/command/on",
            "closeStopUrl": "http://localhost:8083/ZAutomation/api/v1/devices/ZWayVDev_zway_4-0-37/command/off",
            "durationPerPercent": 375,
            "startDelay": 1750,
            "endPositionDelay": 6000
        } 
    ]
}

To Do

• Remove the initial security delay of 1s before starting to move the blinds
• Cancel the current movement and start over when the target position is changed while the blinds are moving

Updates

• 2018-08-06: Published first working prototype
• 2019-08-25: Updated documentation
• 2019-09-22: Refactored and improved logging
• 2019-10-03: Added accessory information

Useful Links

• https://z-wave.me/products/razberry/
• RaZberry API Command Examples