Philips Hue Dimmer Switch

The Philips Hue Dimmer Switch provides four programmable buttons. These can be used in rules which are processed by the gateway.

Each button supports short and long press events which allows uses cases like calling a scene and push dim with just one button.

Top level attributes

Name Value
type ZHASwitch
modelid RWL020 or RWL021
manufacturername Philips
{
    "config": {
        "battery": 100,
        "on": true,
        "reachable": true
    },
    "manufacturername": "Philips",
    "modelid": "RWL021",
    "name": "Couch switch",
    "state": {
        "buttonevent": 1002,
        "lastupdated": "2018-09-06T14:19:23"
    },
    "swversion": "5.45.1.16265",
    "type": "ZHASwitch",
    "uniqueid": "00:17:88:01:10:38:d3:03-02-fc00"
}

The data returned by the Get sensors request contains all attributes for the switch.

Config attributes

Name Type Description
on Bool Whether the switch is operational
reachable Bool read-only True when the switch is reachable in the network
battery Number read-only 0–100 Battery state in percent

State attributes

Name Type Description
buttonevent1 Number read-only The last buttonevent, null if no button was pressed yet
lastupdated String read-only Last time the sensor state was updated
  1. The buttonevent attribute can be used to build automations via Rules endpoint in order to trigger arbitrary actions like calling a scene, turn lights on/off and much more.

Button events

Button Event Description
1
  • 1002
  • 1001
  • 1003
  • short press
  • long press start
  • long press stop
2
  • 2002
  • 2001
  • 2003
  • short press
  • long press start
  • long press stop
3
  • 3002
  • 3001
  • 3003
  • short press
  • long press start
  • long press stop
4
  • 4002
  • 4001
  • 4003
  • short press
  • long press start
  • long press stop

As alternative to rules which are processed by the gateway, button events are also forwarded as push messages from the Websocket interface and therefore allow 3rd party applications to handle the event in realtime without polling.

image/svg+xml Execute Reset 1 2 3 4 6 5 CR2032 3V PHILIPS SETUP PHILIPS 1 2 3 4 1 2 3 4 5 6 1 2 3 4 5 6 1 2 3 4 1 2 90° 180° 3 2 1 CR2032 image/svg+xml