This is project is a custom component for supporting Casambi Lights in Home Assistant. The component integrates with casambi through its Cloud API. All lights will be automatically discovered. The light state is sent to Home Assistant mainly by websocket, but this integration also polls Casambis REST API periodically. Home Assistant can be integrated with Google Home, Amazon Alexa and much more.
It uses a separate library (also written by me), link to library project: https://github.com/olofhellqvist/aiocasambi
| OEM | Fixture Model | Comment |
|---|---|---|
| OLIGO | GRACE PL HA TW | Integration do not support two dimmers, hardware is needed in order to develop support for controls': [{'name': 'dimmer0', 'type': 'Dimmer', 'value': 0.0}, {'name': 'dimmer1', 'type': 'Dimmer', 'value': 0.0} |
| OLIGO | CURVED | Support for light with two dimmers (up and down light) is currently limited. Both dimmers are controlled simultaneously with one light entity in Home Assistant, no separate control implemented as of today (see #54). |
These modes are implemented:
- on/off
- brightness
- color temperature
- rgb
- rgbw
Distribution/Vertical is supported by using casambi.light_turn_on service, see screenshot below:
- Home Assistant
- Request developer api key from Casambi: https://developer.casambi.com/
- Setup a site: https://support.casambi.com/support/solutions/articles/12000041325-how-to-create-a-site
- Running Casambi app with gateway enabled: https://support.casambi.com/support/solutions/articles/12000017046-how-to-enable-a-gateway-for-a-network-
- Setup HACS https://hacs.xyz/
- HACS -> Integrations ->
+-> Casambi -> Download - Restart home assistant (you have installed a custom plugin).
- Go to Settings -> "Devices & Services" -> Add integration -> Casambi
- Follow the setup flow.
Just place the directory "casambi" in to your 'custom_components' folder.
Set logging to debug mode for integration and aiocasambi (library that the integration uses):
logger:
default: info
logs:
homeassistant.components.casambi: debug
custom_components.casambi: debug
aiocasambi: debug
Links to what needs to be done next: https://developers.home-assistant.io/docs/integration_quality_scale_index/ , https://developers.home-assistant.io/docs/creating_component_code_review/ and https://developers.home-assistant.io/docs/creating_platform_code_review/ .
- https://github.com/hellqvio86/aiocasambi - The Asynchronous I/O Casambi library that this project uses
- https://github.com/hellqvio86/casambi - Casambi python library
- https://github.com/awahlig/homebridge-casambi Homebridge plugin for Casambi
- https://github.com/lkempf/casambi-bt-hass Home Assistant integration for Casambi with Bluetooth support
- Olof Hellqvist - Initial work
This project is licensed under the MIT License - see the LICENSE.md file for details
This custom component is neither affiliated with nor endorsed by Casambi.