Devices

This page provides an overview of the devices supported by homebridge-hue.

1. Introduction

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.

2. Overview

Device	Bridge Resource	HomeKit Service
Hue motion sensor	ZLLPresence sensor ZLLLightLevel sensor ZLLTemperature 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 group LightSource group light	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 OccupancySensor
Hue bridge	Geofence sensor	AccessoryInformation OccupancySensor
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)

3. Notes

Hue Motion Sensor

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.

Hue Tap / Hue Dimmer Switch

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.

Light

On/Off plug-in unit

Multisource Luminaire

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.

Wireless Ballast

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.

Hue Bridge

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.