Busch Jaeger ZLL Switch - dresden-elektronik/deconz-rest-plugin GitHub Wiki

How to set up rockers of Busch-Jaeger ZLL switches

The ZLL switches from Busch-Jaeger come with up to four rockers. By default you can program each rocker through the Phoscon UI using rules.

This will be sufficient for most users. However some advanced users might want to increase the reliability of some of the rockers by using direct bindings. This way the lights can still be controlled through that switch even when the deCONZ gateway is down.

Recommended configuration for average users

The switch is fully supported by the Phoscon UI out of the box. This means you can program it like any other switch. Simply add it through the UI and be happy. This is the recommended way for average users.

Advanced configuration with ZigBee direct bindings

:warning: You should understand the concepts of direct bindings before going this way. You should also know how to explore the REST API.

Setting up the switch through the Phoscon UI is straightforward and works instantly. However it has one downside: The switch will not work when deCONZ is not running. This basically applies to all switches which are set up this way, independent from the brand.

If you want to increase the reliability of some of your switches, you can use ZigBee direct bindings, so the switch is talking directly to your lights without involving deCONZ at all.

Use the default binding group

By default deCONZ automatically creates one ZigBee group for the entire switch (direct binding). The group is set up for all rockers, so you can directly get started to use direct binding with it:

  1. Find the group which has been created automatically for the device (either through an app like "Hue Essentials" or through the REST API)
    • You might also be able to do that through the old Web UI
  2. Assign the group to the lights you want to control from the switch.

This is what you will get:

  • As soon as you start pressing the buttons on the rocker, one scene per button will be created automatically within that group
  • You can use an app like "Hue Essentials" to change the scenes. Do not delete them (renaming is fine)!
  • This will only be useful if you only want to control one light group with the switch. If you want to control lights independently which each rocker through direct bindings, you need to change the group bindings.

Custom group bindings

It is also possible to assign each rocker to a different ZigBee group, so you can use each rocker for controlling completely different lights. We'll use an example here to make the required steps clearer.

Let's assume you have a 4 gang switch called "Kitchen Switch". The group which is created automatically for this switch is called "RM01 51" and has the group ID 22. In this example we want to achieve the following:

  • Use the group "RM01 51" only for the top rocker
  • Create a new group "Kitchen Switch Second Rocker" for the second rocker
  • Create an empty dummy group "Dummy" for the remaining two rockers, so they can be programmed through DeCONZ

Required steps:

  1. Create a new group "Kitchen Switch Second Rocker". In this example we'll assume it has ID 23.
  2. Open the deCONZ desktop app (the Qt app).
  3. Make sure that "Panels" -> "Show Bind Dropbox" is enabled.
  4. You'll see your switch as "Kitchen Switch" with two dots behind it's name. Click the second dot to show the cluster list.
  5. Your "Kitchen Switch" will be of type "Light Link Color scene controller" and will contain 4 scene controller endpoints (if it's a switch with 4 rockers). Each scene controller endpoint represents a rocker.
  6. We'll leave the top rocker unchanged. This means it will bind to the group "RM01 51" which was created automatically.
  7. Remove the group binding from the other rockers like this:
    1. Drag the scenes cluster from the second scene controller to the binding dropbox as Source
    2. In the binding dropbox, select group and enter 0x0016 as the Destination group (this is group ID 22 in hexadecimal)
    3. Click the Unbind button to remove that group from the scenes cluster
    4. Repeat the steps for the 3rd and 4th scene controllers
  8. Create a new group binding for your second rocker with the "Kitchen Switch Second Rocker" group:
    1. Drag the scenes cluster from the second scene controller to the binding dropbox as Source
    2. In the binding dropbox, select group and enter 0x0017 as the Destination group (this is group ID 23 in hexadecimal)
    3. Click the Bind button
  9. Press all of the buttons on the switch once, so DeCONZ can update the group list (especially the devicemembership attribute) and scenes.
  10. Your second rocker is now bound to group ID 23 ("Kitchen Switch Second Rocker").
  11. You can set up the scenes for each rocker in an app like "Hue Essentials".
  12. The remaining rockers will also need to be assigned to a group, otherwise you won't get any events from them in DeCONZ. Bind the empty dummy group to them (you can reuse this empty dummy for all switches).

screenshot

:warning: The battery-operated wall switches only accept bind/unbind requests when pushing a button directly after clicking bind/unbind.