pimatic-raspbee

This plugin provides a raspbee interface for pimatic.

Features

• Auto-discover devices, groups and sensors
• Control lights
• Control groups
• Control scenes
• Support for all sensors
• Observe changes over websocket
• Start pairing for new devices
• Backup the deconz config

Prerequisite

You need a rasbpee or conbee device and the deCONZ REST API must be installed and configured.

An other good solution is to run deconz as a docker container.

=> go to the WIKI - there are installation instructions and other useful tips.

Installation

Just activate the plugin over the pimatic webUI. The plugin manager automatically installs the package with his dependencys.

Configuration

You can also load the plugin by adding following in the config.json from your pimatic server:

{
  "plugin": "raspbee",
  "debug": true,
  "active": true,
  "ip": "<deconz ip>",
  "port": "<deconz port>"
}

Usages

To create a connection to the raspbee gateway, the gateway must be unlocked over the deconz UI. check the unlock howto Then make a device discovery in pimatic.

Supported devices

Lights

pimatic Device type	Feature	Deconz Resource Type
RaspBeeSwitch	switch on/off	On/Off plug-in unit & Smart plug
RaspBeeDimmer	switch and dimm light	Dimmable light
RaspBeeCT	change temperature	Color temperature light
RaspBeeRGB	change color	Color light
RaspBeeRGBCT	change color and temperature	Extended color light

HINTs:

There are two color devices. RaspBeeRGB (Color light) emulates the ColorTemperature via a color code. RaspBeeRGBCT (Extended color light) supports native ColorTemperature actions. All lights are detected automatically

Tradfri bulbs do not support hue/sat actions. therefore only RGB values can be set in the rules.

Deconz also does not allow you to adjust the color or brightness when the lamp is off. Use a delay in rules. First switch on the lamp and then set the values.

Groups

pimatic Device type	Feature	Deconz Resource Type
RaspBeeDimmerGroup (DEPRECATED)	switch and dimm	Group
RaspBeeRGBCTGroup (NEW)	change color and temperature	Group
RaspBeeGroupScenes	switch scene on	Group Scenes

I have created a new group device with all color controls.

Sensors

All sensors are represented as a RaspBeeMultiDevice.

The device has 3 arrays.

• associated device IDs
  This array contains all device ID associated to this object.

• support parameter flag
  This array contains all supported ressource types.

• configMap
  During a device discovery, the config map is filled automatically. Customizable values ​​are stored in this config map. A custom config can be written to the API via the button (send config) on the new RaspBeeSystem device.

Supported resource types:

supports parameter flag	Unit	Deconz Resource Type
battery	%	(any battery-powered sensor)
lowbattery	bool	(any IAS Zone sensor)
carbon	bool	ZHACarbonMonoxide
switch	string	ZHASwitch
fire	bool	ZHAFire
humidity	%	ZHAHumidity
temperature	°C	ZHATemperature and any sensor with temperaure support
presence	bool	ZHAPresence
dark	bool	ZHAPresence & ZHALightLevel
lux	lux	ZHALightLevel
daylight	bool	ZHALightLevel
open	bool	ZHAOpenClose
pressure	hPA	ZHAPressure
water	bool	ZHAWater
vibration	bool	ZHAVibration
tampered	bool	(any IAS Zone sensor)
consumption	Wh	ZHAConsumption
power	W	ZHAPower & ZHAConsumption
voltage	V	ZHAPower
current	mA	ZHAPower

The other sensor types are DEPRECATED

but still usable

• RaspBeeMotionSensor
• RaspBeeContactSensor
• RaspBeeLightSensor
• RaspBeeSwitchSensor
• RaspBeeWaterSensor

RaspBeeSystem management device

discover lights & discover sensors

This button starts a light or sensor detection from the deconz api.

create backup

This button creates a local backup of the deconz config.
The target folder is configurable. (default folder is the pimatic-app folder)

send config

This button sends for all devices all config parameter (configMap) to the deconz apikey.

ActionProvider

• "activate group scene -name-"

• "set color temp -name- to -value-"

• "set color rgb -name- to -hexvalue-"

• "dim raspbee -name- to -value-"

Example:
set color temp Light1 to 10 and set color rgb Light2 to #121212 and activate group scene All-ON

Optional a -transtime- can be specified. This allows the changeover to be time-controlled.

Example:
dim raspbee Flur to 100 transition time 2s and set color rgb Light RGB to #FF0000 with transition time 2s

PredicateProvider

• "received from -name- event "2001""

Example: recieved from Switch1 event "2001"

ButtonEvents

	Value	Action
0	x000	Initial Press
1	x001	Hold
2	x002	Release (after press)
3	x003	Release (after hold)
4	x004	Double press
5	x005	Triple press
6	x006	Quadruple press
7	x007	Shake
8	x008	Drop
9	x009	Tilt
10	x010	Many press

CHANGELOG

-> see CHANGELOG

---

Contributors

• kosta
• sweebee
• mwittig