Sensors - dresden-elektronik/deconz-rest-plugin GitHub Wiki
Hue Motion Sensor
The Hue API uses three sensor resources for a Hue motion sensor, one for each ZHA cluster (Occupancy sensing, Illuminance measurement, and temperature measurement):
{
"state": {
"presence": false,
"lastupdated": "2017-04-16T09:20:27"
},
"config": {
"on": true,
"battery": 100,
"reachable": true,
"alert": "none",
"ledindication": false,
"usertest": false,
"sensitivity": 2,
"sensitivitymax": 2,
"pending": []
},
"name": "Living Room Motion",
"type": "ZLLPresence",
"modelid": "SML001",
"manufacturername": "Philips",
"swversion": "6.1.0.18912",
"uniqueid": "00:17:88:01:02:xx:xx:xx-02-0406"
}
{
"state": {
"lightlevel": 15136,
"dark": false,
"daylight": true,
"lastupdated": "2017-04-16T11:10:08"
},
"config": {
"on": true,
"battery": 100,
"reachable": true,
"alert": "none",
"tholddark": 12000,
"tholdoffset": 2000,
"ledindication": false,
"usertest": false,
"pending": []
},
"name": "Living Room Light Level",
"type": "ZLLLightLevel",
"modelid": "SML001",
"manufacturername": "Philips",
"swversion": "6.1.0.18912",
"uniqueid": "00:17:88:01:02:xx:xx:xx-02-0400"
}
{
"state": {
"temperature": 1824,
"lastupdated": "2017-04-16T11:13:08"
},
"config": {
"on": true,
"battery": 100,
"reachable": true,
"alert": "none",
"ledindication": false,
"usertest": false,
"pending": []
},
"name": "Living Room Temperature",
"type": "ZLLTemperature",
"modelid": "SML001",
"manufacturername": "Philips",
"swversion": "6.1.0.18912",
"uniqueid": "00:17:88:01:02:xx:xx:xx-02-0402"
}
Hue Dimmer Switch
Hue Tap
Event Code | Button |
---|---|
34 (E_GP_LEVEL_CONTROL_STOP) | 1 (Large) |
16 | 2 (Left) |
17 | 3 (Bottom) |
18 | 4 (Right) |
The Hue tap switches use a different protocol, ZigBee Green Power. They broadcast a ZGP command, that needs to be picked up by a ZGP sink and translated into a regular ZigBee command. Button 1 is meant to be mapped to Off and buttons 2 to 4 to Scene recall. The buttonevent values you see in the API are actually the ZGP command codes. Both the Hue bridge and deCONZ gateway act as ZGP sink, but neither sends out ZigBee commands on receiving a ZGP command.
To use the Tap in a mesh network, ZGP proxies need to forward the ZGP command to the ZGP sink (by unicast). Hue lights can act as ZGP proxy, IKEA and OSRAM lights cannot (look for the green power endpoint in the deCONZ GUI). However, ZGP proxies need to be configured, which deCONZ currently doesn't, meaning Hue tap switches only work when in direct range of the gateway.