Philips Hue Motion Sensor

The Philips Hue motion sensor combines a motion, light and temperature sensor in one device and is respresented by three separate sensor resources within the REST-API.

The specific attributes for each sensor type are listed below.

Top level attributes

Name Description
type ZHAPresence, ZHALightLevel, ZHATemperature
modelid SML001
manufacturername Philips

Config attributes

All three Philips Hue motion sensor resources (ZHAPresence, ZHALightLevel and ZHATemperature) share the same config attributes as described below, further each sensor has additional config attributes described in the respective sensor section.

Name Type Description
on Bool Whether the sensor is operational
battery Number read-only Battery state in range 0–100 %
alert String

The last alert sent to the device

  • none — stop performing all active alerts
  • select — perform one indication cycle
  • lselect — perform indication cycle for 15 seconds
ledindication1 Bool Turns LED indication for events during normal operation on or off
pending2 List read-only List of config parameters which are not yet committed to sensor
reachable Bool read-only Whether the sensor is reachable in the network
usertest3 Bool Activates or extends usertest mode for 120 seconds
  1. When ledindication is set to false the sensor might still indicate exceptional events — like reset, firmware update and low battery alarm.
  2. As long as config atrributes are listed in pending, their value returned by the REST-API does not take effect and might reflect a previous value.
  3. When usertest is set to true the sensors reports presence detection faster for 120 seconds and indicate events via device LED if applicable. Setting the attribute to false deactivates the usertest.

Presence

The sensor with type ZHAPresence detects motion with adjustable sensitivity.

State attributes

Name Type Description
presence Bool read-only True when presence is detected
lastupdated String read-only Last time the sensor state was updated

Config attributes

Name Type Description
sensitivity Number Sensitivity of the sensor (default 0)
sensitivitymax Number read-only Maximum level for the sensitivity, 2

Example data

{
    "config": {
        "alert": "none",
        "battery": 90,
        "delay": 242,
        "ledindication": false,
        "on": true,
        "pending": [],
        "reachable": true,
        "sensitivity": 0,
        "sensitivitymax": 2,
        "usertest": false
    },
    "manufacturername": "Philips",
    "modelid": "SML001",
    "name": "Floor Motion Sensor",
    "state": {
        "lastupdated": "2018-09-01T16:21:21",
        "presence": true
    },
    "swversion": "6.1.0.18912",
    "type": "ZHAPresence",
    "uniqueid": "00:17:88:01:02:00:21:f4-02-0406"
}

Light level

The sensor with type ZHALightLevel measures the ambient light level.

State attributes

Name Type Description
dark Bool read-only Light level is at or below given dark threshold
daylight Bool read-only Light level is at or above dark threshold (dark + offset)
lightlevel1 Number read-only Light level measured by sensor
lux Number read-only Light level in lux
lastupdated String read-only Last time the sensor state was updated
  1. The lightlevel is specified in logarithmic scale 10000 log10 (lux) + 1. This reflects the perception of the human eye which adjusts to low light levels and small changes and high levels with larger changes.

Config attributes

Name Type Description
tholddark Number Threshold to set dark attribute (default 16000)
tholdoffset Number Threshold for daylight — relative to the tholddark, must be greater 0 (default 7000)

Example data

{
    "config": {
        "alert": "none",
        "battery": 90,
        "ledindication": false,
        "on": true,
        "pending": [],
        "reachable": true,
        "tholddark": 12000,
        "tholdoffset": 7000,
        "usertest": false
    },
    "manufacturername": "Philips",
    "modelid": "SML001",
    "name": "Floor Motion Sensor",
    "state": {
        "dark": true,
        "daylight": false,
        "lastupdated": "2018-09-01T16:20:17",
        "lightlevel": 11068,
        "lux": 13
    },
    "swversion": "6.1.0.18912",
    "type": "ZHALightLevel",
    "uniqueid": "00:17:88:01:02:00:21:f4-02-0400"
}

Temperature

The sensor with type ZHATemperature measures the temperature.

State attributes

Name Type Description
temperature1 Number read-only Current temperature in °C
lastupdated String read-only Last time the sensor state was updated
  1. The temperature is multiplied by 100, therefore 3000 is 30.00 °C.

Config attributes

Name Type Description
offset Number Provides calibration (default 0)

Example data

{
    "config": {
        "alert": "none",
        "battery": 90,
        "ledindication": false,
        "offset": 0,
        "on": true,
        "pending": [],
        "reachable": true,
        "usertest": false
    },
    "manufacturername": "Philips",
    "modelid": "SML001",
    "name": "Floor Motion Sensor",
    "state": {
        "lastupdated": "2018-09-01T16:20:44",
        "temperature": 1901
    },
    "swversion": "6.1.0.18912",
    "type": "ZHATemperature",
    "uniqueid": "00:17:88:01:02:00:21:f4-02-0402"
}