Allows layers to be applied to lights. Useful for multiple levels of notifications and restoring states.
For example: If I want outdoor lights that are a dim white at night, I would add a scene at layer 0 (the lowest.) If something at night happens such as a home security system being triggered while I'm away, an automation would insert an alarm scene at a higher layer and be visible over the night time scene. Now if somehow the sun rises while the alarm scene is scening, to prevent an automation from turning the lights off, one would remove the night time scene from the bulbs' layers resulting in the alarm scene to still be active. When that scene is removed, the lights would look for the next lowest layer and turn off due to absence of a layer. Layers can endlessly be stacked and mixed to render smarter lighting scenes.
Example configuration.yaml entry:
lighting_manager:
entities:
- light.porch_light_1
- light.porch_light_2
- light.foh_light_1
- light.foh_light_2
- light.foh_light_3
Apply a scene at a specified layer. All lights managed by lighting manager and in the specified scene will be updated with priority states. Any unmanaged lights and other entities will be updated as if scene.apply was called.
| Parameter | Description |
|---|---|
| entity_id | Entity ID of scene to be inserted. |
| layer_id | Layer ID. Used when removing or overriding layers. |
| priority | Layer priority. Higher values will appear before lower. |
Apply lighting attributes to a light entity or group at a specified priority. If a light is specified and is not managed, nothing will happen. When a group is specified, any unmanaged lights within the group will be updated to reflect the new state.
| Parameter | Description |
|---|---|
| entity_id | Entity ID of light. |
| priority | Layer priority. Higher values will appear before lower. |
| id | Layer ID. Used when removing the state from layers. |
| attributes | A dictionary of light state attributes to be applied. |
Remove a layer by id from entity id of a light or group. If not entity id is specified, layer or scene will be removed from all managed lights.
| Parameter | Description |
|---|---|
| entity_id | Entity ID of light or group. |
| id | Layer ID to be removed. |