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

Controller types

HueSmartButtonLightController (Light)

This is the default mapping for this controller:

  • Click → Toggle
  • Hold → Brightness up/down with direction changes

This is an example configuration:

  module: controllerx
  class: HueSmartButtonLightController
  controller: < controller_id >
  integration: < deconz >
  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.


  • 1000 → Click
  • 1001 → Hold
  • 1002 → Click release
  • 1003 → Hold release


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