cotugno/zigbee2mqtt
2
Fork 0
mirror of https://github.com/Koenkk/zigbee2mqtt.git synced 2024-11-17 10:58:31 -07:00
Code Issues Packages Projects Releases Wiki Activity
3bb1f0f10b
zigbee2mqtt/docs/information/binding.md
Koen Kanters 92de1ca942
Implement binding feature. #765 #782 (#783) 
* Start on bind implementation. https://github.com/Koenkk/zigbee2mqtt/issues/765

* Finish binding implementation.
2018-12-30 22:42:55 +01:00

1.2 KiB
Raw Blame History

Binding

This is an experimental feature, ongoing discussion 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:

  • Smoothness; this will greatly improve the dimming feedback as the dimmer directly dims the bulb and thus does not have to make the MQTT/home automation software roundtrip.
  • It will work even when home automation software, zigbee2mqtt or the coordinator is down.

Commands

Binding can be configured using the following topics:

  • zigbee2mqtt/bridge/bind/[SOURCE_DEVICE_FRIENDLY_NAME] with payload TARGET_DEVICE_FRIENDLY_NAME will bind the source device to the target device. In the above example, the TRADFRI wireless dimmer would be the source device and the bulb the target device.
  • zigbee2mqtt/bridge/unbind/[SOURCE_DEVICE_FRIENDLY_NAME] with payload TARGET_DEVICE_FRIENDLY_NAME will unbind the devices.