Binding #

Ongoing discussion about this feature can be found here: https://github.com/Koenkk/zigbee2mqtt/issues/782

Zigbee has support for binding which makes it possible that devices can directly control each other without the intervention of Zigbee2MQTT or any home automation software.

When to use this #

A use case for this is e.g. the TRADFRI wireless dimmer. Binding the dimmer directly to a bulb or group has the following advantages:

Commands #

Binding can be configured using the following topics:

Binding specific endpoint #

This is not applicable for most users

By default, the first endpoint is taken. In case your device has multiple endpoints (e.g. left and right), the following can be done to specify an endpoint:

It is also possible to specify the endpoints in numeric form both for source and target (e.g. zigbee2mqtt/bridge/bind/my_switch/3).

Binding a remote to a group #

Binding a remote to a group allows a remote to directly control a group of devices without intervention of Zigbee2MQTT.

When we for example have an IKEA E1743 remote called my_remote and two bulbs called bulb_1 and bulb_2, we can control the 2 bulbs with the remote by putting them in the same group and binding the remote to it.

To do this execute the following steps:

  1. Create a new group in configuration.yaml and give it a friendly_name (see Groups). In this example we will set the friendly_name to my_group.
  2. Add the 2 bulbs to the group by sending the following two MQTT messages.
    • zigbee2mqtt/bridge/group/my_group/add with payload bulb_1
    • zigbee2mqtt/bridge/group/my_group/add with payload bulb_2
  3. Bind the remote to the group by sending the following MQTT message.
    • zigbee2mqtt/bridge/bind/my_remote with payload my_group

Devices #

Not all devices support this, it basically comes down to the Zigbee implementation of the device itself. Check the device specific page for more info (can be reached via the supported devices page)

Report #

When using this feature you are probably also interested in using the report feature. This allows you to get state changes when e.g. a bulb state changes by a bound dimmer. Read more about it here Report.