homebridge-mysmartblinds-bridge
v3.0.1
Published
Homebrige plugin for mysmartblinds (using hardware bridge)
Downloads
227
Maintainers
Readme
homebridge-mysmartblinds-bridge
Homebridge plugin which communicates with MySmartBlinds through the MySmartBlinds Smart Bridge.
Configure your blinds and bridge with the official iOS or Android app first in order to use this Homebridge plugin.
This plugin is not affiliated with the MySmartBlinds product.
Features
- Uses bridge to auto-detect all blinds setup in the MySmartBlinds app, no need to specify each blind
- Supports blind percentages
- Shows battery level for each blind (updated only when blind is open/closed)
- Issues a low battery indicator if battery is below 20%
- Logging (via Homebridge) of all actions done
- Blinds can close down or up (via config option)
- Polling so that blinds update if changed outside of HomeKit
Notes
- Use the 'MySmartBlinds' app to calibrate a blind if it is not opening perfectly straight
- If switching to
closeUp
it's best to Open all blinds first and then restart Homebridge - If you see duplicate blinds, make sure to delete any 'disconnected'/invalid blinds within the iOS/Android app. (see #23)
- Polling Interval will be ignored if the (auth0) API Rate Limit Policy is reached
Configuration
This easiest way to use this plugin is to use homebridge-config-ui-x.
To configure manually, add to the platforms
section of Homebridge's config.json
after installing the plugin.
Config:
{
"platform": "MySmartBlindsBridge",
"name": "MySmartBlindsBridge",
"username": "<email address>",
"password": "<password>"
}
Field | Description ------------------------|------------ platform | Must always be "MySmartBlindsBridge" name | Best to set to "MySmartBlindsBridge" username | MySmartBlinds app username (usually email address) password | MySmartBlinds app password closeUp | (optional true/false, defaults to false) Blinds close in the upwards position statusLog | (optional true/false, defaults to false) logs position changes allowDebug | (optional true/false, defaults to false) Outputs a lot of debug info to stdout pollingInterval | (optional) Polling Interval (in minutes)
Testing
Use npx homebridge-mysmartblinds-bridge
to test your credentials.
Sponsors
mrferreira89 (reddit user) - primary tester/sponsor and provided project hardware
gregmichael - sponsor and tester
name99-org - sponsor
Code credits
ianlevesque/smartblinds-client - used to understand mysmartblinds bridge API
Nicnl/homebridge-minimal-http-blinds - used as an example of blind accessory
crashtestoz/homebridge-http-window-blinds - also used as an example of blind accessory
homebridge/homebridge-plugin-template - v2.0 rewrite based on this template