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

Controller types

ZB3009LightController (Light)

This is the default mapping for this controller:

  • Click on/off → Toggle
  • Click red circle → Change color of the bulb to red
  • Click blue circle → Change color of the bulb to blue
  • Click green circle → Change color of the bulb to green
  • Click white circle → Change color temperature
  • Hold white circle → Change color temperature
  • Click three rings → Toggle through white warmth
  • Hold brightness button → Change brightness
  • Click color wheel → Change xy color

This is an example configuration:

  module: controllerx
  class: ZB3009LightController
  controller: < controller_id >
  integration: < z2m >
  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 on/off
  • "off" → Click on/off
  • brightness_move_up → Hold brightness button
  • brightness_move_down → Hold brightness button
  • brightness_stop → Release brightness button
  • color_temperature_move_down → Hold white circle
  • color_temperature_move_up → Hold white circle
  • color_temperature_move → Click white circle
  • color_move → Click red/blue/green button, three wrings button and color wheel


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).