From 59910792eeb8cb4f703b7b308be94ef37bada110 Mon Sep 17 00:00:00 2001 From: Avi Miller Date: Thu, 27 Oct 2022 09:06:27 +1100 Subject: [PATCH] Add sensor entities to the LIFX docs (#24551) Co-authored-by: Franck Nijhof Co-authored-by: J. Nick Koston --- source/_integrations/lifx.markdown | 22 +++++++++++++++++----- 1 file changed, 17 insertions(+), 5 deletions(-) diff --git a/source/_integrations/lifx.markdown b/source/_integrations/lifx.markdown index e08eccf471e..750e21d560c 100644 --- a/source/_integrations/lifx.markdown +++ b/source/_integrations/lifx.markdown @@ -66,16 +66,28 @@ To determine whether or not a HEV cycle is currently running, Home Assistant exp | `power` | Start a HEV cycle (`True`) or stop a cycle (`False`). | `duration` | Duration (in seconds) for the HEV cycle. The default duration of two hours (7200 seconds) is used if this attribute is omitted. -## Applying themes +## Sensors -You can apply a pre-defined theme to a LIFX multizone device using the Theme configuration entity either manually via the drop-down box on the device configuration screen in the UI or by calling the `select.select_option` service in an automation or script. +The following sensors are available depending on the LIFX model: -When starting a hardware-based move effect, you can specify a theme using the `lifx.effect_move` service. See below for more information about this service. +| Sensor | Description | +| ------ | ----------- | +| Clean cycle | Indicates whether a HEV cycle is currently active on a LIFX Clean bulb | +| Infrared brightness | Controls the infrared brightness amount on a LIFX Nightvision bulb | +| RSSI | Indicates the current WiFi signal strength on any LIFX bulb (disabled by default) | + +Note that these sensors are only updated every 30 seconds and may not reflect the current state if changes are made externally to Home Assistant. + +## Themes + +Home Assistant provides a collection of predefined themes for LIFX multizone lights, each designed to mimic the theme of the same name from the LIFX smartphone app. + +To apply a theme interactively, use the theme selection drop-down box found on the device configuration screen. + +To apply a theme as part of an automation, use the `select.select_option` service call. You can also apply a theme when calling the `lifx.effect_move` service. See the **Light effects** section below for more details, including how to set a custom theme for that effect. The following themes are available: `autumn`, `blissful`, `cheerful`, `dream`, `energizing`, `epic`, `exciting`, `focusing`, `halloween`, `hanukkah`, `holly`, `independence_day`, `intense`, `mellow`, `peaceful`, `powerful`, `relaxing`, `santa`, `serene`, `soothing`, `sports`, `spring`, `tranquil`, `warming`. -Each theme should closely match the theme of the same name in the LIFX smartphone app but may not be identical. - ## Light effects The LIFX platform supports several software-controlled light effects and one hardware based effect. You can start these effects with default options by using the `effect` attribute of the normal [`light.turn_on`](/integrations/light/#service-lightturn_on) service, for example like this: