Picture Controller types Integrations
  • Light (SmartThingsButtonLightController; 350ms delay)
  • Media Player (SmartThingsButtonMediaPlayerController; 500ms delay)
z2m, deconz, zha

Controller types

SmartThingsButtonLightController (Light)

This is the default mapping for this controller:

  • 1 click → Toggle
  • 2 clicks → Full brightness
  • Hold the button → 50% brightness

This is an example configuration:

      
example_app:
  module: controllerx
  class: SmartThingsButtonLightController
  controller: < controller_id >
  integration: < z2m, deconz, zha >
  light: < light entity >
      
    

SmartThingsButtonMediaPlayerController (Media Player)

This is the default mapping for this controller:

  • 1 click → Play/Pause
  • 2 clicks → Skip forwards
  • Hold the button → Skip backward

This is an example configuration:

      
example_app:
  module: controllerx
  class: SmartThingsButtonMediaPlayerController
  controller: < controller_id >
  integration: < z2m, deconz, zha >
  media_player: < media_player entity >
      
    

Integrations

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.

Zigbee2MQTT

  • single → 1 click
  • double → 2 clicks
  • hold → Hold the button

deCONZ

  • 1002 → 1 click
  • 1004 → 2 clicks
  • 1001 → Hold the button

ZHA

  • button_single_1_0_0_0 → 1 click
  • button_double_2_0_0_0 → 2 clicks
  • button_hold_3_0_0_0 → Hold the button

💡 NOTE

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