Zigbee2MQTT

Philips 929003017102

Model929003017102
VendorPhilips
DescriptionHue wall switch module
Exposesbattery, action, device_mode, linkquality
PicturePhilips 929003017102

Notes

Pairing

Press the reset Button for ten seconds to reset the device - the red LED flashes one time confirming the reset. Then short the pins of input one.
The red LED begins to flash every two seconds indicating pairing mode.

Directly control Zigbee groups

It's possible to configure this switch to directly control Zigbee groups. In this way the switch can control e.g. a group of light bulbs even when Zigbee2MQTT is not running. To accomplish this in the Zigbee2MQTT frontend:

  1. Go to the Groups tab and create a new group if it does not already exist. Add devices to the groups which you want to be controlled by this switch.
  2. Add this device to the group.
  3. Click on this device and go to the Bind tab. Uncheck all clusters except manuSpecificPhilips and OnOff (so only manuSpecificPhilips and OnOff are checked) and click Unbind in the row where destination is Coordinator.
  4. In the blank row at the bottom select endpoint 1 as the source endpoint, the group as the destination, tick OnOff and click bind.

Notes:

  • The device needs to be awake to respond to changes so you will need to trigger the switch to wake it up before assigning to the group or changing the bindings.
  • This device does not support direct binding (to a device instead of a group).
  • After doing this, no actions will be send to the coordinator anymore. To revert this (and stop the switch from directly controlling the group), press the yellow reconfigure button in the About tab.
  • Actions are only send for input 1 of the device, for input 2 no actions will be send (so a double rocker is not supported).

Exposes

Battery (numeric)

Remaining battery in %, can take up to 24 hours before reported.. 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: left_press, left_press_release, right_press, right_press_release, left_hold, left_hold_release, right_hold, right_hold_release, toggle.

Device mode (enum)

Value can be found in the published state on the device_mode property. To read (/get) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"device_mode": ""}. To write (/set) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set with payload {"device_mode": NEW_VALUE}. The possible values are: single_rocker, single_push_button, dual_rocker, dual_push_button.

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.