Document device-specific attributes of tint remote control (#14519)

Co-authored-by: Franck Nijhof <frenck@frenck.nl>
This commit is contained in:
Dan Klaffenbach 2020-09-28 10:43:47 +02:00 committed by GitHub
parent 38885b3a8f
commit d77350ac5a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -105,7 +105,9 @@ Note: deCONZ automatically signals Home Assistant when new sensors are added, bu
## Remote control devices ## Remote control devices
Remote controls (ZHASwitch category) will not be exposed as regular entities, but as events named `deconz_event` with a payload of `id` and `event` and in case of the Aqara Magic Cube also `gesture`. Id will be the device name from deCONZ and Event will be the momentary state of the switch. Gesture is used for some Aqara Magic Cube specific events like: flip 90 degrees, flip 180 degrees, clockwise and counter clockwise rotation. However, a sensor entity will be created that shows the battery level of the switch as reported by deCONZ, named sensor.device_name_battery_level. Remote controls (ZHASwitch category) will not be exposed as regular entities, but as events named `deconz_event` with a payload of `id` and `event`. Id will be the device name from deCONZ and Event will be the momentary state of the switch.
Depending on the device some device-specific attributes may also be included in the payload. In case of the Aqara Magic Cube, an additional `gesture` attribute will be exposed. For the tint remote, the `angle` and `xy` attributes will be included in the payload. Gesture is used for some Aqara Magic Cube specific events like: flip 90 degrees, flip 180 degrees, clockwise and counterclockwise rotation. However, a sensor entity will be created that shows the battery level of the switch, as reported by deCONZ, named sensor.device_name_battery_level.
Typical values for switches, the event codes are 4 numbers where the first and last number are of interest here. Typical values for switches, the event codes are 4 numbers where the first and last number are of interest here.
@ -233,6 +235,30 @@ automation:
{% endraw %} {% endraw %}
#### Changing color through the Müller Licht tint remote control
{% raw %}
```yaml
automation:
- alias: React to color wheel changes
trigger:
- platform: event
event_type: deconz_event
event_data:
id: tint_remote_1
event: 6002
action:
- service: light.turn_on
data:
xy_color:
- '{{ trigger.event.data.xy.0 }}'
- '{{ trigger.event.data.xy.1 }}'
entity_id: light.example_color_light_1
mode: restart
```
{% endraw %}
## Binary Sensor ## Binary Sensor
The following sensor types are supported: The following sensor types are supported: