Zigbee2MQTT

Busch-Jaeger 6735/6736/6737

Model6735/6736/6737
VendorBusch-Jaeger
DescriptionZigbee Light Link power supply/relay/dimmer/wall-switch
Exposeslight (state, brightness), switch (state), action, linkquality
PictureBusch-Jaeger 6735/6736/6737

Notes

Pairing

  1. If there are blinking LEDs wait until they don’t blink anymore — the device is in some mode we don’t want it to be.
  2. Press both buttons of the top row (or sole row for Model 6735) until the LEDs gleam permanently. They will blink alternately at first but keep the buttons pressed until really both lights are constantly illuminated. Then release the buttons. The LEDs should still glow.
  3. Now press both buttons again briefly. After about 1..2 seconds they will fade-glow; and your bridge should now instantly find it.

Known issues

Bottom row of 4-gang device not bound

It may occur that the bottom row of the 4-gang device 6737 does not work like the other ones, i.e. does not emit the actions (see related discussion #7009open in new window). The reason is not fully understood yet, however it can be worked around by unbinding all four endpoints and re-binding them manually one after another:

Source EPDestinationDestination EPClusters
10Coordinator1LevelCtrl (only for power supply or battery-operated wall switch)
11Coordinator1LevelCtrl
12Coordinator1LevelCtrl
13Coordinator1LevelCtrl

*[EP]: Endpoint

Single endpoint can only be bound to one destination

By default all bindings should be set up so the device reports button events through Zigbee2MQTT (except top row for dimmers/relays). You may also define custom bindings, but please keep in mind that each source endpoint may only be bound to one destination endpoint. So if you want to change the default binding for an endpoint (which corresponds to a button row) this is the recommended way:

  1. Unbind current destination of the particular endpoint
  2. Create a ZigBee group for the binding partners
  3. Bind the switch endpoint to the ZigBee group

You should also use a ZigBee group even if you only want to bind to a single light! This way Zigbee2MQTT will continue to publish the button events, even without an explicit binding to the coordinator.

Duplicate events for battery-operated control panel

The battery-operated wall switch might be sending duplicate action events. In this case you may want to set up debouncing for the device:

'0xd85devicemac':
  debounce: 0.2
  debounce_ignore:
    - action:

This introduces a tiny lag after each button press, but you can get rid of the duplicate events if they are occuring in your environment.

Battery-operated control panel is very hard to wake up for configuration

The battery-operated devices are extremely power efficient. After pressing a button they go to deep sleep almost immediately. Therefore it can be quite hard to send a new configuration or to change bindings.

For the 2-row and 4-row devices the following procedure has proven to be a good option:

  1. Press both buttons of the top row until the LEDs gleam permanently.
  2. Press a button in the bottom row at the same time as sending an Unbind request through Zigbee2MQTT for any row. This may take multiple attempts to succeed.
  3. Important: Keep this endpoint/row unbound until you are done configuring the device!
  4. Configure the endpoints/bindings according to your needs. For sending a new configuration you need to wake up the device again. Press the button in the bottom (unbound) row and this will keep the device awake for about 2 seconds.

For single-row devices re-inserting the battery in the very right moment might be required when reconfiguring the switches.

Home Assistant: device discovered both as light and switch

If you are using Home Assistant auto-discovery you'll notice that the device is discovered both as a light entity and as a switch entity.

Always use the light entity! The switch entity is only there for historic (compatibility) reasons and can be safely ignored. The main issue with the switch entity is that it does not update it's state when the Busch-Jaeger device is controlled directly through it's top-row rockers.

Action values

This device sends the following action values in its payload:

Left buttons(long-hold-release)Right buttons
off_row_1
brightness_step_down_row_1		brightness_stop_row_1on_row_1
brightness_step_up_row_1
off_row_2
brightness_step_down_row_2		brightness_stop_row_2on_row_2
brightness_step_up_row_2
off_row_3
brightness_step_down_row_3		brightness_stop_row_3on_row_3
brightness_step_up_row_3
off_row_4
brightness_step_down_row_4		brightness_stop_row_4on_row_4
brightness_step_up_row_4

Briefly pressing and releasing a button triggers the off_row_X resp. on_row_X actions for the given row, long-pressing triggers the brightness_step_down_row_X/brightness_step_up_row_X state respectively (after about one second). When releasing the button after a long-press action, a brightness_stop_row_X will be issued with no distinction between the left or right button. Note that the action payload may be different when you have set the legacy flag for the device (not recommended).

Depending on the device configuration not all actions may be sent.

Options

How to use device type specific configuration

  • transition: Controls the transition time (in seconds) of on/off, brightness, color temperature (if applicable) and color (if applicable) changes. Defaults to 0 (no transition). The value must be a number with a minimum value of 0

  • state_action: State actions will also be published as 'action' when true (default false). The value must be true or false

  • legacy: Set to false to disable the legacy integration (highly recommended), will change structure of the published payload (default true). The value must be true or false

Exposes

Light (relay endpoint)

This light supports the following features: state, brightness.

  • state: To control the state publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set with payload {"state_relay": "ON"}, {"state_relay": "OFF"} or {"state_relay": "TOGGLE"}. To read the state send a message to zigbee2mqtt/FRIENDLY_NAME/get with payload {"state_relay": ""}.
  • brightness: To control the brightness publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set with payload {"brightness_relay": VALUE} where VALUE is a number between 0 and 254. To read the brightness send a message to zigbee2mqtt/FRIENDLY_NAME/get with payload {"brightness_relay": ""}.

Moving/stepping

Instead of setting a value (e.g. brightness) directly it is also possible to:

  • move: this will automatically move the value over time, to stop send value stop or 0.
  • step: this will increment/decrement the current value by the given one.

The direction of move and step can be either up or down, provide a negative value to move/step down, a positive value to move/step up. To do this send a payload like below to zigbee2mqtt/FRIENDLY_NAME/set

NOTE: brightness move/step will stop at the minimum brightness and won't turn on the light when it's off. In this case use brightness_move_onoff/brightness_step_onoff

{
  "brightness_move": -40, // Starts moving brightness down at 40 units per second
  "brightness_move": 0, // Stop moving brightness
  "brightness_step": 40 // Increases brightness by 40
}

Switch

The current state of this switch is in the published state under the state property (value is ON or OFF). To control this switch publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set with payload {"state": "ON"}, {"state": "OFF"} or {"state": "TOGGLE"}. To read the current state of this switch publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"state": ""}.

Action (enum)

Triggered action (e.g. a button click). Value can be found in the published state on the action property. It's not possible to read (/get) or write (/set) this value. The possible values are: row_1_on, row_1_off, row_1_up, row_1_down, row_1_stop, row_2_on, row_2_off, row_2_up, row_2_down, row_2_stop, row_3_on, row_3_off, row_3_up, row_3_down, row_3_stop, row_4_on, row_4_off, row_4_up, row_4_down, row_4_stop.

Linkquality (numeric)

Link quality (signal strength). Value can be found in the published state on the linkquality property. It's not possible to read (/get) or write (/set) this value. The minimal value is 0 and the maximum value is 255. The unit of this value is lqi.