To contribute to this page, edit the following file

Philips 324131092621 #

Model	324131092621
Vendor	Philips
Description	Hue dimmer switch
Exposes	battery, action, linkquality
Picture

Notes #

Pairing #

Factory reset the Hue dimmer switch by pressing and holding the setup button on the back for 10 seconds.

Restart the Hue dimmer switch by holding all 4 buttons of the Hue dimmer switch. You can let go when the light on the front flashes red/green briefly.

Using the dimmer to reset a Hue light bulb #

To use the Hue dimmer switch to factory reset a Hue light bulb see HOWTO: Factory reset a Hue bulb. After resetting the bulb will automatically connect. This method also works for Philips Hue Lightstrips. Hue dimmer switch can also be used to factory reset Ikea Trådfri light bulbs using the same method described above.

Binding #

If you want to bind the dimmer to a (Hue) lamp you’ll have to bind it to the lamp through MQTT and unbind it from the coordinator. Use the dimmer as source and a literal coordinator as target for that.

Device type specific configuration #

How to use device type specific configuration

• multiple_press_timeout: Controls how long (in seconds) subsequent key presses may be apart and still count as one event. The default is 250ms (0.25).

Troubleshooting #

Resetting the device #

• Method 1: Press all four buttons for 4 seconds. When the light turns green, release the buttons. The device will flash green and red alternatively after which it will reconnect to the network.
• Method 2: Use a needle or paperclip to press the reset button on the back for 10 seconds. The behavior is similar to method 1

Device refuses actions #

If actions (e.g. applying zigbee2mqtt/bridge/request/device/remove to a dimmer) result in timeouts, perform a reset (see above) and apply the action right after the device announced itself in the network.

Device announces itself but the buttons don’t work #

The dimmer appears to be working normally and the logs in Zigbee2MQTT look good. However, nothing happens when a button is pressed (no light, no log message in Zigbee2MQTT). In this case:

• Reset the device
• Use zigbee2mqtt/bridge/request/device/remove to remove the device from the network (this should result in a “left the network” log message)
• Allow joining of new devices in Zigbee2MQTT
• Reset the device again
• Wait for it to pair again. The device should now be operational.

Device type specific configuration #

How to use device type specific configuration

• legacy: Set to false to disable the legacy integration (highly recommended!) (default: true)

OTA updates #

This device supports OTA updates, for more information see OTA updates.

Exposes #

Battery (numeric) #

Remaining battery in %. Value can be found in the published state on the battery property. It’s not possible to read (/get) or write (/set) this value. The minimal value is 0 and the maximum value is 100. The unit of this value is %.

Action (enum) #

Triggered action (e.g. a button click). Value can be found in the published state on the action property. It’s not possible to read (/get) or write (/set) this value. The possible values are: on-press, on-hold, on-hold-release, up-press, up-hold, up-hold-release, down-press, down-hold, down-hold-release, off-press, off-hold, off-hold-release.

Linkquality (numeric) #

Link quality (signal strength). Value can be found in the published state on the linkquality property. It’s not possible to read (/get) or write (/set) this value. The minimal value is 0 and the maximum value is 255. The unit of this value is lqi.

Manual Home Assistant configuration #

Although Home Assistant integration through MQTT discovery is preferred, manual integration is possible with the following configuration:

sensor:
  - platform: "mqtt"
    state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
    availability_topic: "zigbee2mqtt/bridge/state"
    value_template: "{{ value_json.battery }}"
    unit_of_measurement: "%"
    device_class: "battery"
    state_class: "measurement"

sensor:
  - platform: "mqtt"
    state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
    availability_topic: "zigbee2mqtt/bridge/state"
    value_template: "{{ value_json.action }}"
    enabled_by_default: true
    icon: "mdi:gesture-double-tap"

sensor:
  - platform: "mqtt"
    state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
    availability_topic: "zigbee2mqtt/bridge/state"
    value_template: "{{ value_json.linkquality }}"
    unit_of_measurement: "lqi"
    enabled_by_default: false
    icon: "mdi:signal"
    state_class: "measurement"

sensor:
  - platform: "mqtt"
    state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
    availability_topic: "zigbee2mqtt/bridge/state"
    icon: "mdi:update"
    value_template: "{{ value_json['update']['state'] }}"
    enabled_by_default: false

binary_sensor:
  - platform: "mqtt"
    state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
    availability_topic: "zigbee2mqtt/bridge/state"
    payload_on: true
    payload_off: false
    value_template: "{{ value_json.update_available}}"
    enabled_by_default: false