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

Controller types

Z31BRLLightController (Light)

This is the default mapping for this controller:

  • 1 click → Toggle
  • Right turn → Brighten up (1 step)
  • Left turn → Dim down (1 step)

This is an example configuration:

  module: controllerx
  class: Z31BRLLightController
  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.


  • 1002 → 1 click
  • 2002 → Right turn
  • 3002 → Left turn


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