Introduction
About REST
Getting started
Find the gateway
Supported devices
- Phoscon
- Philips Hue
- IKEA Trådfri
- Xiaomi
- Busch Jaeger
- Jung
- GIRA
- Ubisys
- Paulmann
- Paul Neuhaus
- Heiman
API Endpoints
Configuration
Groups
Lights
Rules
Scenes
Schedules
Sensors
Touchlink
Websocket
Misc
Polling
Error handling
Authorization

dresden elektronik Scene Switch

The dresden elektronik Scene Switch provides six programmable buttons. These can be used in rules which are processed by the gateway.

Further the switch can be used standalone in order to control lights directly, even when the gateway is not powered.

Top level attributes

Name	Value
type	ZHASwitch
modelid	Scene Switch
manufacturername	dresden elektronik

    {
        "config": {
            "group": "20100",
            "on": true,
            "reachable": true
        },
        "manufacturername": "dresden elektronik",
        "modelid": "Scene Switch",
        "name": "Living Room Switch",
        "state": {
            "buttonevent": 4002,
            "lastupdated": "2018-12-08T01:28:49"
        },
        "swversion": "02010026",
        "type": "ZHASwitch",
        "uniqueid": "00:21:2e:ff:ff:01:27:ed-01-1000"
    }

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

Config attributes

Name	Type	Description
group	Number read-only	Identifier of the group that the switch controls in Standalone mode
on	Bool	Whether the switch is operational
reachable	Bool read-only	True when the switch is reachable in the network

State attributes

Name	Type	Description
buttonevent¹	Number read-only	The last buttonevent, null if no button was pressed yet
lastupdated	String read-only	Last time the sensor state was updated

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

	Event	Description	Group command
1	1002 1001 1003	short press long press start long press stop	on start dim up stop dim up
2	2002 2001 2003	short press long press start long press stop	off start dim down stop dim down
3	3002	short press	call scene 1
4	4002	short press	call scene 2
5	5002	short press	call scene 3
6	6002	short press	call scene 4

The behaviour of group commands is described in the Standalone mode section.

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.

Standalone mode

Lights which are assigned to config.group via the Groups endpoint will be directly controlled by the switch. That means even if the gateway is not powered all lights in that group can still be controlled by the switch.

When a button is pressed the group commands listed in the Button events table below will be send.

Note

The group can be kept empty and only commands configured via rules might be used. It is strongly adviced to not mix rule based commands and standalone mode at the same time, since group commands will be send in any case.