Philips 929003017102

   
Model 929003017102
Vendor Philips
Description Hue wall switch module
Exposes battery, action, device_mode, linkquality
Picture Philips 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:

  1. In the Zigbee2MQTT frontend go to the switch -> Bind tab. Uncheck all clusters except manuSpecificPhilips (so only manuSpecificPhilips is checked) and click Unbind in the row where destination is Coordinator. If this fails, wake-up the switch by triggering it and try again.
  2. Go to the Logs tab and trigger the switch, this will log the group ID which this switch controls: 
     MQTT publish: topic 'zigbee2mqtt/0x001788010cc53971', payload '{"action":"toggle","action_group":16606,"battery":100,"linkquality":110}'

    The group ID in this example is 16606.

  3. Go to the Groups tab and create a new group with the ID from the previous step. Add devices to the groups which you like to be controlled by this switch.

Notes:

  • This device does not support direct binding (to a device instead of a group) and you cannot change the group ID it controls.
  • 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.