Skip to content

Device Accessory

Erik Baauw edited this page Jan 12, 2022 · 4 revisions

Homebridge deCONZ exposes an accessory for each (to be) supported Zigbee or virtual device on a deCONZ gateway.

Currently, no device types are yet supported. All accessories carry a Stateless Programmable Switch service, so they can be monitored from Apple's Home app, and a custom Device Settings service to configure the device at run-time.

Service Description
Stateless Programmable Switch Button with Single Press and Long Press actions.
Device Settings* A service to configure the device.

*) Note that Apple's Home app does not support custom services.

Stateless Programmable Switch Service

The Stateless Programmable Switch service carries the following HomeKit characteristic:

Characteristic RW Description
Programmable Switch Event w Fires a Single Press on receiving a web socket notification, a Long Press when the gateway had been polled.

Device Settings Service

The custom Device Settings service will gain additional characteristics to change how to expose the device, as devices will be supported. A lights device could be exposed as Lightbulb, Outlet, Valve, or Fan. Currently Device Settings carries the following HomeKit characteristics:

Characteristic RW Description
Expose* rw+ Set to Off to blacklist the device, delete the associated accessory, and add a Device Settings service to the gateway accessory.
Log Level* rw+ Sets the log level for this device.
Resource* r The REST API resource(s) for the device.

*) Note that Apple's Home app does not support custom characteristics.
+) Note that only the owner of the HomeKit home can write this characteristic.

Clone this wiki locally