mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-14 04:46:49 +00:00
Add docs for the new Kuler Sky integration (#15410)
Co-authored-by: Paulus Schoutsen <paulus@home-assistant.io>
This commit is contained in:
parent
cf843e0368
commit
41b73a6049
46
source/_integrations/kulersky.markdown
Normal file
46
source/_integrations/kulersky.markdown
Normal file
@ -0,0 +1,46 @@
|
|||||||
|
---
|
||||||
|
title: Kuler Sky
|
||||||
|
description: Instructions for integrating Brightech Kuler Sky Bluetooth floor lamps with Home Assistant.
|
||||||
|
ha_category:
|
||||||
|
- Light
|
||||||
|
ha_iot_class: Local Polling
|
||||||
|
ha_release: '1.0.0'
|
||||||
|
ha_domain: kulersky
|
||||||
|
ha_codeowners:
|
||||||
|
- '@emlove'
|
||||||
|
ha_config_flow: true
|
||||||
|
---
|
||||||
|
|
||||||
|
This integration connects Brightech Kuler Sky floor lamps to Home Assistant.
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
|
||||||
|
This integration can be configured using the integrations page in Home Assistant.
|
||||||
|
|
||||||
|
Menu: **Configuration** -> **Integrations**.
|
||||||
|
|
||||||
|
Click on the `+` sign to add an integration and search for **Kuler Sky**.
|
||||||
|
|
||||||
|
The integration will scan for nearby Bluetooth devices, and ask you to select your lamp.
|
||||||
|
|
||||||
|
## Additional information for Home Assistant Core on Python environments
|
||||||
|
|
||||||
|
This integration requires `pybluez` to be installed. On Debian based installs, run:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo apt install bluetooth
|
||||||
|
```
|
||||||
|
|
||||||
|
Before you get started with this integration, please note that:
|
||||||
|
|
||||||
|
- Requires access to the Bluetooth stack, see [Rootless Setup section](#rootless-setup) for further information
|
||||||
|
|
||||||
|
## Rootless Setup
|
||||||
|
|
||||||
|
Normally accessing the Bluetooth stack is reserved for `root`, but running programs that are networked as `root` is a bad security wise. To allow non-root access to the Bluetooth stack we can give Python 3 and `hcitool` the missing capabilities to access the Bluetooth stack. Quite like setting the setuid bit (see [Stack Exchange](https://unix.stackexchange.com/questions/96106/bluetooth-le-scan-as-non-root) for more information).
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo apt-get install libcap2-bin
|
||||||
|
sudo setcap 'cap_net_raw,cap_net_admin+eip' `readlink -f \`which python3\``
|
||||||
|
sudo setcap 'cap_net_raw+ep' `readlink -f \`which hcitool\``
|
||||||
|
```
|
Loading…
x
Reference in New Issue
Block a user