jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-19 15:26:59 +00:00
Code Issues Packages Projects Releases Wiki Activity

Add event entities to Lutron (#31841)

Browse Source
This commit is contained in:
Joost Lekkerkerker 2024-04-23 11:55:21 +02:00 committed by GitHub
parent abdab9afa1
commit 5d32bf5abb
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 3 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
source/_integrations/lutron.markdown
View File

@ -3,6 +3,7 @@ title: Lutron
description: Instructions on how to use Lutron devices with Home Assistant. description: Instructions on how to use Lutron devices with Home Assistant.
ha_category: ha_category:
- Cover - Cover
- Event
- Fan - Fan
- Hub - Hub
- Light - Light
@ -17,6 +18,7 @@ ha_domain: lutron
ha_platforms: ha_platforms:
- binary_sensor - binary_sensor
- cover - cover
- event
- fan - fan
- light - light
- scene - scene
@ -51,15 +53,7 @@ If you are using RadioRA2 software version 12 or later, the default `lutron` use
## Keypad buttons ## Keypad buttons
Individual buttons on keypads are not represented as entities. Instead, they fire events called `lutron_event` whose payloads include `id`, `action`, and `uuid` attributes. Keypad buttons actions are provided in event entities.
The `id` attribute includes the name of the keypad and the name of the button, normalized the same way entity names are. For example, if the keypad is called "Kitchen Keypad" and the button is called "Dinner" the event's `id` will be `kitchen_keypad_dinner`. If the button has not been assigned a name by the Lutron system installer then the button will have a name of "Unknown Button". In this case the `id` will be suffixed with the underlying Lutron button number and will be of the form `kitchen_keypad_unknown_button_1`. The `uuid` is available to distinguish buttons with the same name on one keypad.
The `action` attribute varies depending on the button type.
For raise/lower buttons (dimmer buttons, shade controls, etc.) there will be two values, `pressed` and `released`, fired when the button is pressed and when it's released, respectively.
For single-action buttons (scene selection, etc.), `action` will be `single`, and there will only be one event fired. This is a limitation of the Lutron controller which doesn't give Home Assistant any way of knowing when a single-action button is released.
## Keypad LEDs ## Keypad LEDs