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 |