-
-
Notifications
You must be signed in to change notification settings - Fork 92
Devices
This page provides an overview of the devices supported by homebridge-hue.
For each device, the overview table lists the corresponding Hue bridge resource and the HomeKit services that homebridge-hue creates for each resource. Custom services are marked with an asterisk (*). Devices and services marked with a plus (+) are not yet implemented.
Some Hue bridge resources do not correspond to a connected device. These are listed under the Hue bridge device, at the end of the overview. For some of these, like the built-in Daylight
sensor, homebridge-hue creates a separate accessory (with a corresponding AccessoryInformation
service), for others, like schedules, homebridge-hue adds the corresponding services to the Hue bridge accessory. See notes below for details.
Device | Bridge Resource | HomeKit Service |
---|---|---|
Hue motion sensor |
ZLLPresence sensorZLLLightLevel sensorZLLTemperature sensor |
AccessoryInformation MotionSensor LightSensor TemperatureSensor Battery
|
Hue tap |
ZGPSwitch sensor |
AccessoryInformation StatelessProgrammableSwitch StatelessProgrammableSwitch StatelessProgrammableSwitch StatelessProgrammableSwitch HueResource * |
Hue dimmer switch |
ZLLSwitch sensor |
AccessoryInformation StatelessProgrammableSwitch StatelessProgrammableSwitch StatelessProgrammableSwitch StatelessProgrammableSwitch HueResource * Battery
|
Dimmable light Dimmable plug-in unit Color temperature light Color light Extended color light |
light |
AccessoryInformation Lightbulb
|
On/Off plug-in unit | light |
AccessoryInformation Switch
|
Multisource luminaire+ |
Luminaire groupLightSource grouplight |
AccessoryInformation + Lightbulb + Lightbulb + Lightbulb + |
Wireless ballast |
light light |
AccessoryInformation Lightbulb Lightbulb
|
Hue bridge | config |
AccessoryInformation HueBridge * StatelessProgrammableSwitch
|
Hue bridge | schedule |
HueResource * |
Hue bridge | rule |
HueResource * |
Hue bridge | scene | (not supported) |
Hue bridge | resourcelink | (not supported) |
Hue bridge | capabilities | (not supported) |
Hue bridge |
Daylight sensor |
AccessoryInformation LightSensor
|
Hue bridge |
CLIPSwitch sensor |
(not supported) |
Hue bridge |
CLIPOpenClose sensor |
AccessoryInformation ContactSensor
|
Hue bridge |
CLIPPresence sensor |
AccessoryInformation MotionSensor
|
Hue bridge |
Geofence sensor |
AccessoryInformation MotionSensor
|
Hue bridge |
CLIPTemperature sensor |
AccessoryInformation TemperatureSensor
|
Hue bridge |
CLIPHumidity sensor |
AccessoryInformation HumiditySensor
|
Hue bridge |
CLIPLightLevel sensor |
AccessoryInformation LightSensor
|
Hue bridge |
CLIPGenericFlag sensor |
AccessoryInformation Switch
|
Hue bridge |
CLIPGenericStatus sensor |
AccessoryInformation HueStatus * |
Hue bridge |
LightGroup group |
AccessoryInformation Lightbulb (or Switch ) |
Hue bridge |
Room group |
AccessoryInformation Lightbulb (or Switch ) |
A Hue motion sensor is exposed on the Hue bridge as three different sensor resources. Each resource is updated independently, and can be configured independently. The Hue motion sensor battery is exposed under each resource.
Although not advertised, the Hue motion sensor measures temperature as well. This shouldn't come as a surprise, as a passive infrared (PIR) sensor is in fact a thermometer that detects motion based on changes in temperature.
A Hue tap, as well as a Hue dimmer switch, is exposed on the Hue bridge as a single sensor resource. The state.buttonevent
attribute encodes which of the four buttons is pressed, or, in case of the dimmer, held or released.
The four StatelessProgrammableSwitch
services correspond to the four buttons on the tap or dimmer. As of iOS 10.3, the built-in Home app uses these for a programmable switch.
The custom HueSwitch
service holds the sensor attributes that are common to all buttons.
A multisource luminaire contains multiple light modules in a single device. Each light module is exposed on the Hue bridge as a separate light resource. The luminaire itself is exposed as a Luminaire
group resource. When the luminaire has multiple sections, like Up or Down, these are exposed as LightSource
groups.
Currently, homebridge-hue doesn't recognise a multisource luminaire and exposes the corresponding light and group resources as independent devices.
A dresden elektronik FLS-PP lp wireless ballast provides separate control for the colour LEDs vs the white LEDs of the connected lightstrip. It is exposed on the Hue bridge as two different light resources, an Extended color light and a Dimmable light.
A Hue bridge itself is exposed as an accessory, with the following services:
- An
AccessoryInformation
service; - A custom service to control and monitor the polling of the bridge by homebridge-hue, to link new apps, and to touchlink devices;
- A
StatelessProgrammableSwitch
service, tied to the physical button on the bridge; - A custom service for each schedule, to enable/disable the schedule;
- A custom service for each rule, to enable/disable and monitoring the triggering of that rule.
Once homebridge-hue will have changed to homebridge's dynamic accessory model (see issue #4), the bridge accessory will hold the bridge username. This will eliminate the need to edit config.json
.
Home | FAQ | Getting Started | Reference