homebridge-powerview

This is a plugin for Homebridge to provide HomeKit support for Hunter Douglas PowerView window shades.

You can download it from npm.

Supports both the Generation 1 and 2 hubs.

Supported Shades:

• Roller Shades.
• Shades with Horizontal Vanes (e.g. Silhouette, Pirouette). The main accessory controls the vertical movement of the shades, and a slider under Details controls the tilt of the vanes when closed.
• Shades with Vertical Vanes (e.g. Luminette). The main accessory controls the horizontal movement of the shades, and a slider under Details controls the tilt of the vanes when closed.
• Top-Down/Bottom-Up Shades (e.g. Duette). You will get two accessories, one for the bottom of the shade, and one of the top. They can be controlled independently or combined using HomeKit scenes.

Shades can participate in HomeKit scenes and automations.

Installation

1. Install and setup Homebridge.

2. Install this plugin:

npm install -g homebridge-powerview

3. Add the PowerView Platform to your Homebridge config.json:

    "platforms" : [
        {   
            "platform" : "PowerView"
        }
    ]

Configuration

Just specifying the platform should work for more people, the hub will be found using the default powerview-hub.local mDNS hostname.

Hostname or IP

If your PowerView hub is configured with a different default hostname, you can specify that, or the hub's IP address, by adding a host key to the platform configuration:

"host" : "192.168.1.1"

Shade Types

The plugin uses the information from the PowerView hub to determine the types of shades, however it doesn't yet know all of the possible values. You may see the following warning in your log:

*** Shade 12345 has unknown type 66, assuming roller ***

If you see this, first please file an issue and provide details about the kind of shade that this is, so I can correctly recognize it in future versions.

You can then add a forceRollerShades, forceTopBottomShades, forceHorizontalShades, or forceVerticalShades key to your config.json to force shades to be a certain type, e.g.:

"forceTopBottomShades": [ 12345, 98765 ]

Shade Examples

For all shades, you can tab the accessory icons in the Home app to open and close the shades, or long-press to set any arbitrary position between closed and 100% open.

Horizontal and Vertical Shades

For shades with horizontal or vertical vanes, after long-pressing you can tap Details to adjust the tilt angle. For horizontal shades this will range from 0° to 90°, where the vanes are closed at 0°, and the vanes tilted fully open at 90°. For vertical shades it will range from -90° to 90°, with the shades fully open at 0°, and fully closed in either direction at -90° and 90°.

Adjusting the vane tilt angle will automatically close the shades if necessary, likewise adjusting the standard shade position will automatically return the vanes to 0°. When creating scenes, you should ensure that if the scene intends to tilt the vanes, the shade is Closed in the scene; likewise if the scene is intended to set a shade position, that the tilt is set to 0°. HomeKit isn't smart enough to update the scene itself.

Top-Down/Bottom-Up Shades

For shades with a movable top and bottom, two accessory controls will be created; one for the movable bottom of the shade, and the other for the movable top.

These can be controlled independantly, or combined in scenes.