MQTT Scene
The mqtt
scene platform lets you control your MQTT enabled scenes.
Configuration
To enable a MQTT scene in your installation, add the following to your configuration.yaml
file:
# Example configuration.yaml entry
scene:
- platform: mqtt
command_topic: zigbee2mqtt/living_room_group/set
Configuration Variables
A list of MQTT topics subscribed to receive availability (online/offline) updates. Must not be used together with availability_topic
.
The payload that represents the available state.
The payload that represents the unavailable state.
The MQTT topic subscribed to receive availability (online/offline) updates. Must not be used together with availability
.
Icon for the switch.
The payload that represents the available state.
The payload that represents the unavailable state.
The payload that represents on
state. If specified, will be used for both comparing to the value in the state_topic
(see value_template
and state_on
for details) and sending as on
command to the command_topic
.
The maximum QoS level of the state topic. Default is 0 and will also be used to publishing messages.
If the published message should have the retain flag on or not.
Make sure that your topic matches exactly. some-topic/
and some-topic
are different topics.
Examples
In this section, you will find some real-life examples of how to use this sensor.
Full configuration
The example below shows a full configuration for a switch.
# Example configuration.yaml entry
switch:
- platform: mqtt
unique_id: living_room_party_scene
name: "Living Room Party Scene"
command_topic: "home/living_room/party_scene/set"
availability:
- topic: "home/living_room/party_scene/available"
payload_on: "ON"
qos: 0
retain: true
Use with a JSON Payload
The example below shows a configuration using a JSON payload.
# Example configuration.yaml entry
scene:
- platform: mqtt
name: Living Room Blue Scene
unique_id: living_room_blue_scene
command_topic: "home/living_room/set"
payload_on: '{"activate_scene": "Blue Scene"}'