openhab-docs/_addons_bindings/deconz

id	label	title	type	description	since	install
deconz	Dresden Elektronik deCONZ	Dresden Elektronik deCONZ - Bindings	binding	The Zigbee binding currently does not support the Dresden Elektronik Raspbee and Conbee Zigbee dongles.	2x	auto

{% include base.html %}

Dresden Elektronik deCONZ Binding

The Zigbee binding currently does not support the Dresden Elektronik Raspbee and Conbee Zigbee dongles. The manufacturer provides a companion app called deCONZ together with the mentioned hardware. deCONZ offers a documented real-time channel that this binding makes use of to bring support for all paired Zigbee sensors and switches.

deCONZ also acts as a HUE bridge. This binding is meant to be used together with the HUE binding which makes the lights and plugs available.

Supported Things

There is one bridge (deconz) that manages the connection to the deCONZ software instance. These things are supported:

Thing name	Description	Channels
presencesensor	Any presence sensor	presence
powersensor	Any power sensor	power
switch	Any switch	buttonevent
lightsensor	A light sensor	lightlux
temperaturesensor	A temperature sensor	temperature
daylightsensor	The deCONZ artificial daylight sensor	value,light

Discovery

deCONZ software instances are discovered automatically in the same subnet. Sensors, switches are discovered as soon as a deconz bridge Thing comes online.

Thing Configuration

Important: You need to authorize 3rd party applications in deCONZ for the bridge Thing to successfully connect. The Online/Offline status of the bridge Thing will tell you, when to enable the authorization process.

These configuration values need to be provided:

Config	Description	Type	Default
host	Host address (hostname/ip:port) of deCONZ interface	string	n/a
apikey	Authorization API key (optional, can be filled automatically)	string	n/a

Channels

Overview of provided channels for presencesensor:

Channel ID	Description	Read/Write	Values
presence	Switch type	r	ON/OFF for presence/no-presence

Overview of provided channels for powersensor:

Channel ID	Description	Read/Write	Values
power	Current power usage in Watts	r	Number value

Overview of provided channels for switch:

Channel ID	Description	Payload	Values
buttonevent	This channel is triggered on a button event.	The button event number	Number value

Overview of provided channels for lightsensor:

Channel ID	Description	Read/Write	Values
lightlux	Current light illuminance in Lux	r	Number value

Overview of provided channels for temperaturesensor:

Channel ID	Description	Read/Write	Values
temperature	Current temperature	r	Number value

Overview of provided channels for daylightsensor:

Channel ID	Description	Read/Write	Values
value	A number that represents the sun position: Dawn is around 130, sunrise at 140, sunset at 190, and dusk at 210	r	Number value
light	A light level	r	Daylight,Sunset,Dark

Full Example

Things file

Bridge deconz:deconz:homeserver [ host="192.168.1.3", apikey="ABCDEFGHIJ" ] {
    presencesensor livingroom-presence          [ id="1" ]
    temperaturesensor livingroom-temperature    [ id="2" ]
}

Items file

Switch  Livingroom_Presence     "Presence: [%s]"          {channel="deconz:presencesensor:homeserver:livingroom-presence:presence"}
Number  Livingroom_Temperature  "Temperature: [%.1f °C]"  {channel="deconz:temperaturesensor:homeserver:livingroom-temperature:temperature"}