From dc4517db93b7edd8d186c18e8292a38dda353f07 Mon Sep 17 00:00:00 2001 From: Jay Tuckey Date: Sat, 13 Feb 2021 21:34:57 +0930 Subject: [PATCH] Update nanoleaf documentation with examples (#16537) Co-authored-by: Franck Nijhof --- source/_integrations/nanoleaf.markdown | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/source/_integrations/nanoleaf.markdown b/source/_integrations/nanoleaf.markdown index 796d7f8633f..38e4f8b6160 100644 --- a/source/_integrations/nanoleaf.markdown +++ b/source/_integrations/nanoleaf.markdown @@ -12,7 +12,7 @@ ha_platforms: ### Configuration Sample -The `nanoleaf` platform allows you to control [Nanoleaf Light Panels](https://nanoleaf.me) from Home Assistant. +The Nanoleaf integration allows you to control [Nanoleaf Light Panels](https://nanoleaf.me) from Home Assistant. Note that for full control of Nanoleaf devices, particularly effects, make sure they are set up as instructed on this page and not as a HomeKit device. The preferred way to set up this platform is by enabling the [discovery component](/integrations/discovery/). Make sure to press and hold the *ON* button for 5 seconds (the LED will start flashing) on your Nanoleaf Lights while Home Assistant is starting. @@ -50,3 +50,7 @@ name: 4. The output should include the auth token like *{"auth_token":"xxxxxxxxxxxxxxxxxxxxx"}*, copy the resulting token into your configuration If you get a 403 Forbidden message, you probably did not press the *ON* button long enough. The time-frame to get a valid token is only 30 seconds, so you have to be quick to issue the curl request. + +### Using the Nanoleaf Device + +The Nanoleaf device is a standard light, so can be used with standard Home Assistant Light services for automations and scripts. For full details see the [Light Integrations Page.](/integrations/light/) Of particular interest for Nanoleaf devices is using the `effect` in service calls, to choose the pattern/effect that the lights display.