Fork me on GitHub

pimatic-raspbee by Kosta (treban) | github | npm

pimatic-raspbee

build status version downloads license

This plugin provides a raspbee interface for pimatic.

!! This plugin is still in beta state !!

Features

  • Auto-discover devices, groups and sensors
  • Support for motion sensors
  • Support for remote controls and switches
  • Support for temperature, humidity, pressure and much more sensors
  • Control lights
  • Control groups
  • Controle scenes
  • Observe changes over websocket

Prerequisite

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

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

Installation

Just activate the plugin in your pimatic config. The plugin manager automatically installs the package with his dependencys.

Configuration

You can 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. Then make a device discovery in pimatic.

Supported devices

  • RaspBeeLightDevices There are three typs of light devices:

    • Dimmer only
    • Color temperature
    • RGB
  • RaspBeeSwitch

  • RaspBeeDimmerGroup

  • RaspBeeGroupScenes The scenes are associated with the groups and are represented by a button device. After each restart of pimatic all scenes are updated.

  • RaspBeeMotionSensor

The motion sensor is like a normal presence sensor. You can configure an optional auto-reset time in milliseconds. The sensor has an optional lux attribute.

  • RaspBeeMultiSensor Devices with more than one sensor are represented as multidevices.

  • RaspBeeWaterSensor

  • RaspBeeLightSensor

  • RaspBeeContactSensor

  • RaspBeeSwitchSensor

  • RaspBeeRemoteControlNavigator

This device represents a 5 button remote control and is like a normal button device. There a predefined buttons which are useable in rules with this format: raspbee_deviceid_button possible button are: power / up / down / left / right / longpower / longright / longleft / longup / longdown

ActionProvider

  • "activate group scene "

  • "set color temp to "

  • "set color rgb to "

Example: set color temp Light 1 to 10 and set color rgb Light 3 to #121212 and activate group scene All-ON

ChangeLog

  • 0.0.2 : First public version
  • 0.0.3 : BUGFIX #1
  • 0.0.4 : BUGFIX
  • 0.0.5 : New features and BUGFIX
    • MultiSensor devices
    • Scenes
  • 0.0.6 : HOTFIX
  • 0.0.7 : New features and BUGFIX
    • Actionprovider for scenes and light color / rgb
    • Scenes are now a standalone device as a button device
  • 0.0.8 : New features and BUGFIX
    • WebSocket keep alive
    • support for wall plug
    • Fix for #16 & #21
    • debug output for device discovery
    • xAttributeOptions
    • pressureAttribute in hPa instead kPa
  • 0.0.9 : HOTFIX
  • 0.0.10 : add device type smart plug

    Contributors

  • kosta

  • sweebee
  • mwittig

Plugin Config Options

RaspBee plugin config options
OptionDescriptionDefault
debug
boolean
Enabled debug messages
false
ip
string
IP address from the deconz rest api
port
string
port from the deconz rest api
80
apikey
string
api key
""

Device Config Options

raspbee

RaspBeeSystem

Control Center Device properties
OptionDescriptionDefault
messagecount
integer
Message count to display
10

RaspBeeMotionSensor

RaspBee MotionSensor
OptionDescriptionDefault
deviceID
string
Raspbee device id
resetTime
integer
Reset time in seconds
60
sensorIDs
array of integers
All the ids of the sensors
[]

RaspBeeContactSensor

RaspBee ContactSensor
OptionDescriptionDefault
deviceID
integer
Raspbee device id
resetTime
integer
Optional auto reset time in milli seconds
0
inverted
boolean
Invert open/close state of contact device.
false

RaspBeeLightSensor

RaspBee LightSensor
OptionDescriptionDefault
deviceID
integer
Raspbee device id

RaspBeeSwitchSensor

RaspBee SwitchSensor
OptionDescriptionDefault
deviceID
integer
Raspbee device id
resetTime
integer
Auto reset time in milliseconds
100

RaspBeeWaterSensor

RaspBee WaterSensor
OptionDescriptionDefault
deviceID
integer
Raspbee device id

RaspBeeRemoteControlNavigator

RaspBee MotionSensor
OptionDescriptionDefault
deviceID
integer
Raspbee device id

RaspBeeSwitch

Raspbee Switch Device
OptionDescriptionDefault
deviceID
integer
Raspbee address

RaspBeeDimmer

Raspbee Dimmer Light Device
OptionDescriptionDefault
deviceID
integer
Raspbee address
transtime
integer
Raspbee transtime
5

RaspBeeCT

Raspbee Color Temperature Light Device
OptionDescriptionDefault
deviceID
integer
Raspbee address
transtime
integer
Raspbee transtime
5

RaspBeeRGB

Raspbee Color Temperature Light Device
OptionDescriptionDefault
deviceID
integer
Raspbee address
transtime
integer
Raspbee transtime
5

RaspBeeDimmerGroup

Raspbee Dimmer Light Device
OptionDescriptionDefault
deviceID
integer
Raspbee address
transtime
integer
Raspbee transtime
5

RaspBeeMultiSensor

Raspbee Multi sensor
OptionDescriptionDefault
deviceID
string
Raspbee address
sensorIDs
array of integers
All the ids of the sensors
supportsHumidity
boolean
does this sensor measure humidity?
false
supportsPressure
boolean
does this sensor measure pressure?
false
temperatureAcronym
string
temperature acronym
"T"
humidityAcronym
string
humidity acronym
"H"
pressureAcronym
string
pressure acronym
"P"

RaspBeeGroupScenes

RaspBeeScenes
OptionDescriptionDefault
deviceID
integer
Raspbee address
buttons
array of objects
Scene buttons
Elements
pimatic-raspbee is written by Kosta (treban)