Picture Controller types Integrations
  • Light (W2049LightController; 350ms delay)
z2m, deconz, zha

Controller types

W2049LightController (Light)

This is the default mapping for this controller:

  • Click 🔆 → Turn on
  • Click 🔅 → Turn off
  • Click < → Color temp down / Left color wheel (1 step)
  • Click > → Color temp up / Right color wheel (1 step)
  • Hold 🔆 → Brighten up
  • Hold 🔅 → Dim down
  • Hold < → Color temp down / Left color wheel
  • Hold > → Color temp up / Right color wheel

This is an example configuration:

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

Note

This controller fires "on" action when arrows are held as well as the hold arrow action. So this means that when long pressing the arrows, the light(s) will turn on before changing the color.

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

  • "on" → Click 🔆
  • "off" → Click 🔅
  • arrow_left_click → Click <
  • arrow_right_click → Click >
  • brightness_move_up → Hold 🔆
  • brightness_move_down → Hold 🔅
  • brightness_stop → Release 🔆/🔅
  • arrow_left_hold → Hold <
  • arrow_left_release → Release <
  • arrow_right_hold → Hold >
  • arrow_right_release → Release >

deCONZ

  • 1002 → Click 🔆
  • 2002 → Click 🔅
  • 3002 → Click <
  • 4002 → Click >
  • 1001 → Hold 🔆
  • 1003 → Release 🔆
  • 2001 → Hold 🔅
  • 2003 → Release 🔅
  • 3001 → Hold <
  • 3003 → Release <
  • 4001 → Hold >
  • 4003 → Release >

ZHA

  • on → Click 🔆
  • off → Click 🔅
  • press_257_13_0 → Click <
  • press_256_13_0 → Click >
  • move_with_on_off_0_83 → Hold 🔆
  • move_1_83 → Hold 🔅
  • hold_3329_0 → Hold <
  • hold_3328_0 → Hold >
  • stop → Release 🔆 or 🔅
  • release → Release < or >

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