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

Controller types

HueDimmerController (Light)

This is the default mapping for this controller:

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

This is an example configuration:

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

Note

In case of working with z2m and wanting to use the multiclick functionality, then you need to make sure to remove from the device specific (devices.yaml) the `multiple_press_timeout` option. In case of deCONZ, all the click actions are mapped with X002 actions, so when the button is released after being clicked.

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-press → Click "I"
  • on-hold → Hold "I"
  • on-hold-release → Release "I"
  • up-press → Click 🔆
  • up-hold → Hold 🔆
  • up-hold-release → Release 🔆
  • down-press → Click 🔅
  • down-hold → Hold 🔅
  • down-hold-release → Release 🔅
  • off-press → Click "O"
  • off-hold → Hold "O"
  • off-hold-release → Release "O"

deCONZ

  • 1000 → Click "I"
  • 1001 → Hold "I"
  • 1002 → Click release "I"
  • 1003 → Hold release "I"
  • 2000 → Click 🔆
  • 2001 → Hold 🔆
  • 2002 → Click release 🔆
  • 2003 → Hold release 🔆
  • 3000 → Click 🔅
  • 3001 → Hold 🔅
  • 3002 → Click release 🔅
  • 3003 → Hold release 🔅
  • 4000 → Click "O"
  • 4001 → Hold "O"
  • 4002 → Click release "O"
  • 4003 → Hold release "O"

ZHA

  • on_short_release → Click "I"
  • on_hold → Hold "I"
  • on_long_release → Release "I"
  • up_short_release → Click 🔆
  • up_hold → Hold 🔆
  • up_long_release → Release 🔆
  • down_short_release → Click 🔅
  • down_hold → Hold 🔅
  • down_long_release → Release 🔅
  • off_short_release → Click "O"
  • off_hold → Hold "O"
  • off_long_release → Release "O"

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