homebridge-abode-lights
v2.0.2
Published
Homebridge plugin for integrating Abode Switches and Dimmers into HomeKit.
Downloads
20
Readme
homebridge-abode-lights
Homebridge plugin that integrates Abode switches and dimmers into HomeKit, as these are not included in their built-in HomeKit support.
This is an unofficial integration not created by or affiliated with Abode Systems, Inc.
Updates with v2.0.0
v2.0.0
introduces the ability to integrate the Abode Color Bulbs, as well as other bulbs that are connected. However, the main focus for the v2.0.0
update is to support the Abode Color Bulbs so there may be some issues with others. Specifically, I know Lifx bulbs can be connected, and the color and color temperature features work, but at the moment, this plugin will treat them as an Abode Color Bulb so they may not meet their full color temperature characteristics.
Known Issues with v2.0.0
There seems to be a bug with the color temperature wheel and the color presets. If you edit a color and then use the temperature tab to change the temperature, the prefix color will retain the original color, but HomeKit will remember it as a color temperature. Selecting this color will change the bulb to the color temperature, but the prefix color will not update. To address this, select the prefix color and select a color from the color wheel.
The Abode API can get overwhelmed when too many requests are sent too rapidly. Abode will return a
400
error with a status code that indicates an error 2191. I catch this error and continue processing. Further requests should process eventually. This is most notable when changing colors or color temperatures.
Installation
If you are new to Homebridge, please first read the Homebridge documentation and installation instructions first.
If you have Homebridge Config UI installed, you can install this plugin by going to the Plugins
tab, searching for homebridge-abode-lights
, and installing it.
If you prefer use the command line, you can do so by running:
npm install -g homebridge-abode-lights
Plugin configuration
To configure this plugin, enter the email and password for your Abode account. You may want to use a dedicated Abode user just for Homebridge.
If you want the plugin to automatically check for removed devices, enter a value (in minutes) for the polling interval. If not, leave it blank.
Note: the plugin will enforce a 5 minute minimum polling interval.
If you choose to configure this plugin directly instead of using Homebridge Config UI, you'll need to add the platform to your config.json
file:
{
"platform": "Abode Lights",
"email": "YOUR_ABODE_ACCOUNT_EMAIL",
"password": "YOUR_ABODE_ACCOUNT_PASSWORD",
"pollingInterval": 5
}
Supported Devices
Currently, this plugin supports the following types of devices:
- Abode Color Bulbs
- Z-Wave Switches (tested with Embrighten indoor and outdoor switches)
- Z-Wave Dimmer Switches (tested with Embrighten (formerly GE) dimmers)
- Lifx bulbs registered with Abode
Automatic Addition and Removal of Devices
The plugin will now automatically add new devices to HomeKit as they are detected.
Unfortunately, Abode does not send out a notification when devices are removed, so instead the plugin will poll Abode at the frequency of config.pollingInterval
and check for removed devices, if the option is set.
Reporting Bugs
I'm sure there are things that I missed in my testing, so please open new issues with any bugs that you find.
Recognition
There are several plugins that were inspirational in this work: