0.1.2 • Published 7 months ago

@uboness/homebridge-motionblinds v0.1.2

Weekly downloads
-
License
Apache-2.0
Repository
github
Last release
7 months ago

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

SettingtyperequiredDescription
ipstringrequiredThe IP address of the bridge (it is recommended to fix this IP in your network router)
keystringrequiredThe API key for the bridge (can be found by tapping multiple times on the Settings -> About MOTION page in the MotionBlinds app
namestringoptionalA user friendly name for the bridge (defaults to the bridge's IP)
deviceDefaults.stopButtonbooleanoptionalSome 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.invertOpenClosebooleanoptionalSometimes 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)
devicesarrayoptionalAn array of per-device settings for further customisation.

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

SettingtyperequiredDescription
macstringrequiredThe MAC address of the device (serves as the identifier of the device)
namestringoptionalA user friendly name for the device (defaults to its MAC address)
stopButtonbooleanoptionalEnables overriding the default deviceDefaults.stopButton per device
invertOpenClosebooleanoptionalEnables overriding the default deviceDefaults.invertOpenClose per device
0.1.2

7 months ago

0.1.1

7 months ago

0.1.0

10 months ago

0.0.3

10 months ago

0.0.2

10 months ago