Skip to content

HueDimmer

Picture Controller types Integrations
  • Zigbee2MQTT (z2m)
  • deCONZ (deconz)
  • ZHA (zha)

Notes

In case of working with z2m the device needs to be flagged as legacy: false as Zigbee2MQTT documentation recommends.

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.

Light

Class: HueDimmerController

Default delay: 350ms

Default mapping:

Zigbee2MQTT deCONZ ZHA Predefined actions
on_press_release 1002 on_short_release on
on_hold 1001 on_hold hold_color_up
on_hold_release, up_hold_release, down_hold_release, off_hold_release 1003, 2003, 3003, 4003 off_long_release, down_long_release, up_long_release, on_long_release release
up_press_release 2002 up_short_release click_brightness_up
up_hold 2001 up_hold hold_brightness_up
down_press_release 3002 down_short_release click_brightness_down
down_hold 3001 down_hold hold_brightness_down
off_press_release 4002 off_short_release off
off_hold 4001 off_hold hold_color_down 
example_app:
  module: controllerx
  class: HueDimmerController
  integration: z2m
  controller: sensor.my_controller_action
  light: light.my_entity_id

example_app:
  module: controllerx
  class: HueDimmerController
  integration:
    name: z2m
    listen_to: mqtt
  controller: my_controller
  light: light.my_entity_id

example_app:
  module: controllerx
  class: HueDimmerController
  integration: deconz
  controller: my_controller
  light: light.my_entity_id

example_app:
  module: controllerx
  class: HueDimmerController
  integration: zha
  controller: 00:11:22:33:44:55:66:77:88
  light: light.my_entity_id

Zigbee2MQTT Light

Class: HueDimmerZ2MLightController

Default mapping:

Zigbee2MQTT Predefined actions
on_press_release on
on_hold hold_colortemp_up
on_hold_release, up_hold_release, down_hold_release, off_hold_release release
up_press_release click_brightness_up
up_hold hold_brightness_up
down_press_release click_brightness_down
down_hold hold_brightness_down
off_press_release off
off_hold hold_colortemp_down 
example_app:
  module: controllerx
  class: HueDimmerZ2MLightController
  integration: z2m
  controller: sensor.my_controller_action
  light: my_entity_id

example_app:
  module: controllerx
  class: HueDimmerZ2MLightController
  integration:
    name: z2m
    listen_to: mqtt
  controller: my_controller
  light: my_entity_id