From e3eed32e5b09f93329c61d37759a5a40fd593a1a Mon Sep 17 00:00:00 2001 From: Teemu R Date: Wed, 1 Feb 2017 06:18:39 +0100 Subject: [PATCH] Update light.yeelight.markdown (#1757) * Update light.yeelight.markdown * Update light.yeelight.markdown document configuration variables, document music mode. * Update light.yeelight.markdown fix naming of use_music_mode --- source/_components/light.yeelight.markdown | 18 +++++++++++++++--- 1 file changed, 15 insertions(+), 3 deletions(-) diff --git a/source/_components/light.yeelight.markdown b/source/_components/light.yeelight.markdown index deaf332af8a..05b662c839a 100644 --- a/source/_components/light.yeelight.markdown +++ b/source/_components/light.yeelight.markdown @@ -14,6 +14,8 @@ ha_release: 0.32 The `yeelight` light platform allows you to control your Yeelight Wifi bulbs with Home Assistant. +### {% linkable_title Example configuration %} + To enable those lights, add the following lines to your `configuration.yaml` file: ```yaml @@ -22,16 +24,26 @@ light: - platform: yeelight devices: 192.168.1.25: - name: Front Door - 192.168.1.13: name: Living Room + transition: 1000 + use_music_mode: True (defaults to False) + save_on_change: False (defaults to True) + 192.168.1.13: + name: Front Door ``` Configuration variables: - **ip** (*Required*): IP(s) of your wifi bulbs - **name** (*Optional*): A friendly name for the device. +- **transition** (*Optional*, default 350): Smooth transitions over time (in ms). +- **use_music_mode** (*Optional*, default False): Enable music mode. +- **save_on_change** (*Optional*, default True): Saves the bulb state when changed from Home Assistant. +#### {% linkable_title Music mode %} +Per default the bulb limits the amount of requests per minute to 60, a limitation which can be bypassed by enabling the music mode. In music mode the bulb is commanded to connect back to a socket provided by the component and it tries to keep the connection open, which may not be wanted in all use-cases. + +### {% linkable_title Initial setup %}

Before trying to control your light through Home Assistant, you have to setup your bulb using Yeelight app. ( [Android](https://play.google.com/store/apps/details?id=com.yeelight.cherry&hl=fr), [IOS](https://itunes.apple.com/us/app/yeelight/id977125608?mt=8) ). In the bulb property, you have to enable "Developer Mode" Developer mode may only be available with the latest firmware installed on your bulb. Firmware can be updated in the application after connecting the bulb. @@ -39,7 +51,7 @@ Determine your bulb ip (using router, software, ping ...)

-Tests are only made with a YLDP03YL model. Because it's the only hardware developer owns. If you have bugs with another kind of model, you could open an issue on [Home Assistant Github](https://github.com/home-assistant/home-assistant) +This component is tested to work with models YLDP01YL and YLDP03YL. If you have a different model and it is working please let us know.