From 4ac3c4c92d71823c5596a48a32a0547c7091d7a0 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Wed, 5 Feb 2020 00:45:38 -0800 Subject: [PATCH] Document brightness step for light.turn_on (#11973) * Document brightness step * Clarify light.toggle service --- source/_integrations/light.markdown | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/source/_integrations/light.markdown b/source/_integrations/light.markdown index 64cce7036d9..f5f2aad10f0 100644 --- a/source/_integrations/light.markdown +++ b/source/_integrations/light.markdown @@ -36,6 +36,8 @@ Most lights do not support all attributes. You can check the integration documen | `color_name` | yes | A human-readable string of a color name, such as `blue` or `goldenrod`. All [CSS3 color names](https://www.w3.org/TR/css-color-3/#svg-color) are supported. | `brightness` | yes | Integer between 0 and 255 for how bright the light should be, where 0 means the light is off, 1 is the minimum brightness and 255 is the maximum brightness supported by the light. | `brightness_pct`| yes | Alternatively, you can specify brightness in percent (a number between 0 and 100), where 0 means the light is off, 1 is the minimum brightness and 100 is the maximum brightness supported by the light. +| `brightness_step` | yes | Change brightness by an amount. Should be between -255..255. +| `brightness_step_pct` | yes | Change brightness by a percentage. Should be between -100..100. | `flash` | yes | Tell light to flash, can be either value `short` or `long`. | `effect`| yes | Applies an effect such as `colorloop` or `random`. @@ -87,7 +89,6 @@ Turns one or multiple lights off. ### Service `light.toggle` -Toggles the state of one or multiple lights using [groups]({{site_root}}/integrations/group/). -Takes the same arguments as [`turn_on`](#service-lightturn_on) service. +Toggles the state of one or multiple lights. Takes the same arguments as [`turn_on`](#service-lightturn_on) service. -*Note*: If `light.toggle` is used for a group of lights, it will toggle the individual state of each light. +*Note*: If `light.toggle` is used for a group of lights, it will toggle the individual state of each light. If you want the lights to be treated as a single light, use [Light Groups](/integrations/light.group/) instead.