Files
zigbee2mqtt/docs/information/groups.md
T
Koen Kanters d3f705162d Group support #15 (#745)
* Start on group support. #15

* Implement publishing to zigbee groups. https://github.com/Koenkk/zigbee2mqtt/issues/15

* Complete first version of group support.

* Fix tests.
2018-12-22 00:07:53 +01:00

832 B

Groups

Zigbee2mqtt has support for Zigbee groups. By using Zigbee groups you can control multiple devices simultaneously.

Configuration

Add the following to your configuration.yaml.

groups:
  # ID, each group should have a different numerical ID
  '1':
    # Name which will be used to control the group
    friendly_name: group_1

Adding a device to a group

Send an MQTT message to zigbee2mqtt/bridge/groups/[GROUP_FRIENDLY_NAME]/add with payload DEVICE_FRIENDLY_NAME

Remove a device from a group

Send an MQTT message to zigbee2mqtt/bridge/groups/[GROUP_FRIENDLY_NAME]/remove with payload DEVICE_FRIENDLY_NAME

Controlling

To control a group the following topic should be used. The payload is the same as is used for controlling devices.

zigbee2mqtt/group/[GROUP_FRIENDLY_NAME]/set