Picture Controller types Integrations
  • Light (ZB5122LightController; 350ms delay)

Controller types

ZB5122LightController (Light)

This is the default mapping for this controller:

  • Click light on → Turn on
  • Click light off → Turn off
  • Hold light on → Brighten up
  • Hold light off → Dim down
  • Click RGB → Change xy color (1 step)
  • Hold RGB → Change xy color (loop)
  • Click CW → Change color temp (1 step)
  • Hold CW → Change color temp (toggle mode)

This is an example configuration:

  module: controllerx
  class: ZB5122LightController
  controller: < controller_id >
  integration: < zha >
  light: < light entity >


Here you will see the actions that the controller fires when pressing or holding the buttons. In case of z2m it shows the state that the sensor takes. In case of deconz it shows the event id (or gesture) and for zha it shows the command concatenated with the args.


  • "on" → Click light on
  • "off" → Click light off
  • hold_brightness_up → Hold light on
  • hold_brightness_down → Hold light off
  • stop → Release light on or off
  • move_to_color → Click RGB
  • move_hue → Hold RGB
  • stop_move_hue → Release RGB
  • move_to_color_temp → Click CW
  • move_color_temp → Hold CW
  • stop_move_step → Release CW
  • recall_0_1 → Click clapperboard


When using words like "on" and "off" in the YAML configuration, you will need to wrap them up with quotation marks ("), otherwise they will be parsed as boolean variables (True and False).