Home Assistant integration for BLE based keepsimple or HappyLighting lights.
Supports controlling BLE based lights controllable through the keepsimple or HappyLighting apps.
Note: Restart is always required after installation.
HACS (recommended)
Installation can be done through HACS custom repository.
You can manually clone this repository inside config/custom_components/keepsimple.
For example, from Terminal plugin:
cd /config/custom_components
git clone https://github.com/sysofwan/ha-keepsimple keepsimple
After installation, you should find keepsimple under the Configuration -> Integrations -> Add integration.
The setup step includes discovery which will list out all keepsimple lights discovered. The setup will validate connection by toggling the selected light. Make sure your light is in-sight to validate this.
The setup needs to be repeated for each light.
- Discovery: Automatically discover keepsimple based lights without manually hunting for Bluetooth MAC address
- On/Off/RGB/Brightness support
- Live state polling: External control (i.e. IR remote) state changes will reflect in Home Assistant
- Emulated RGB brightness: Supports adjusting brightness of RGB lights
- Multiple light support
Light modes (blinking, fading, etc) is not yet supported.
- Light connection may fail a few times after Home Assistant reboot. The integration will usually reconnect and the issue will resolve itself.
- After toggling lights, Home Assistant may not reflect state changes for up to 30 seconds. This is due to a lag in keepsimple status API.
Add the following to configuration.yml to show debugging logs. Please make sure to include debug logs when filing an issue.
See logger intergration docs for more information to configure logging.
logger:
default: warn
logs:
custom_components.keepsimple: debugThis integration will not be possible without the awesome work of reverse engineering and documenting the keepsimple BLE protocol here.