Homebridge MotionBlinds Plugin

Connects to MOTION Wi-Fi Mini bridge and enables controller MotionBlinds curtains.

!! Experimental !!

Important

This is an experimental plugin. Supporting this plugin is not necessarily a priority, so use at your own risk. (you can open tickets if you'd like, response times are not guaranteed though)

Important

This plugin currently only supports Roller Blinds. Was only tested on:

• Retrofit Motor CMD-02-P 433MHz

Note

MOTION API was heavily influenced by https://github.com/jhurliman/node-motionblinds

Settings

It's possible to configure multiple wifi bridges from which this plugin will load all devices. Here's a sample configuration:

{
    "bridges": [
        {
            "ip": "192.168.1.xxx",
            "key": "xxxxxxxx-xxxx-xx",
            "name": "Living Room",
            "deviceDefaults": {
                "stopButton": true,
                "invertOpenClose": true
            },
            "devices" : [
                {
                    "mac": "x1x1x1x1x1x1x1x1",
                    "name": "Left Curtain",
                    "invertOpenClose": false
                },
                {
                  "mac": "X2X2X2X2X2X2X2X2",
                  "name": "Right Curtain"
                }
            ]
        }
    ],
    "platform": "MotionBlinds"
}

The above example configures a single bridge. By default, all the devices that will be loaded from this bridgge will include a "Stop" button (that will enable you to "stop" the blind while it's opening/closing) and the open/close notions will be inverted. Two of the loaded devices (identified by their MAC address) also have dedicated settings, namely:

• "name" - A user friendly name (when not configured, the device's MAC will be used)
• "invertOpenClose" - The "Left Curtain" was installed "upside down" and therefore we need to invert it's orientation.

Here's a list of all the possible settings per bridge

Setting	type	required	Description
ip	string	required	The IP address of the bridge (it is recommended to fix this IP in your network router)
key	string	required	The API key for the bridge (can be found by tapping multiple times on the Settings -> About MOTION page in the MotionBlinds app
name	string	optional	A user friendly name for the bridge (defaults to the bridge's IP)
deviceDefaults.stopButton	boolean	optional	Some apps/interfaces don't enable the user to stop the current operation of the blind. When true a Stop button will be added to the accessory that will enable you to do that (default: false)
deviceDefaults.invertOpenClose	boolean	optional	Sometimes the default orientation of the blind doesn't fit your needs (e.g. Is 100% considered closed or open?). Toggling this settings will change the orientation of the blind to your likings (default: false)
devices	array	optional	An array of per-device settings for further customisation.

Here's a list of the settings available per-device:

Setting	type	required	Description
mac	string	required	The MAC address of the device (serves as the identifier of the device)
name	string	optional	A user friendly name for the device (defaults to its MAC address)
stopButton	boolean	optional	Enables overriding the default deviceDefaults.stopButton per device
invertOpenClose	boolean	optional	Enables overriding the default deviceDefaults.invertOpenClose per device