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.

Source

CLIP sensors