ImperiHome Binding

ImperiHome Binding

Please Note: This binding is in alpha stage; currently available for download via the OpenHAB-Forum.

• Purpose
• Installation
• Configuration
• Items
  • Binding Format
  • Examples

Purpose

The binding will enable you to use the comercial ImperiHome UI.

Installation

Copy the .jar files provided into the ./addons directory of your OH installation.

Page Top

Configuration

The binding provides the API for ImperiHome to load the devices from openHAB and to control it.

Items

Binding Format

{imperihab="room:[#room],label:[#label],type:[#type],watts:[#wattsitem]"}

#room	the room you want the item to appear under in ImperiHome
#label	Optional, the name of the item to appear in ImperiHome, if not specified the name will be the item name replacing _ with " ", so Outside_Porch_Light would become "Outside Porch Light" automatically
#type	Optional, only needed if the type of the device cannot be guessed from the item. It first tries to find the type based on the values it support OpenClose, OnOff, Percentage etc and there's some best guesses for the item names e.g. if item name contains "Humidity" it thinks its a humidity sensor). If none of these work, or if you want to override the type it guesses, you can specify it. Using the device types for imperihome: Device type string Description DevCamera MJPEG IP Camera DevCO2 CO2 sensor DevCO2Alert CO2 Alert sensor DevDimmer Dimmable light DevDoor Door / window security sensor DevElectricity Electricity consumption sensor DevFlood Flood security sensor DevGenericSensor Generic sensor (any value) DevHygrometry Hygro sensor DevLock Door lock DevLuminosity Luminance sensor DevMotion Motion security sensor DevMultiSwitch Multiple choice actuator DevNoise Noise sensor DevPressure Pressure sensor DevRain Rain sensor DevScene Scene (launchable) DevShutter Shutter actuator DevSmoke Smoke security sensor DevSwitch Standard on/off switch DevTemperature Temperature sensor DevThermostat Thermostat DevUV UV sensor DevWind Wind sensor
#wattsitem	Optional, this lets you specify another item to be the "energy" value for an item, e.g. for a z-wave power outlet Switch Item, you can link this to the Number item that has the power reading. Then in imperihome it will show the power usage for that switch.

Page Top

Examples

Number zWaveSensor23_1 "L1 [%.1f W]" <energy> (gZWaveNode23, gPower) {zwave="23:1:command=METER", imperihab="room:Keller,label:Verbrauch L1,type:DevElectricity,watts:zWaveSensor23_1"}
Dimmer zWaveLightOGBedroom "Licht [%d %%]" <light> (gZWaveNode20, gLights, gHomeOGBedroom) {zwave="20:0:command=SWITCH_MULTILEVEL", imperihab="room:Schlafzimmer,label:Licht,type:DevDimmer,watts:zWaveLightOGBedroom"}
Rollershutter zWaveShutterEGLivingroomLeft "Rollladen" <rollershutter> (gZWaveNode16, gHomeShuttersEG, gHomeEGLivingRoom) {zwave="16:0:command=SWITCH_MULTILEVEL", imperihab="room:Wohnraum,label:Rollladen,type:DevShutter,watts:zWaveShutterEGLivingroomLeft"}
Number zWaveSensor2Temperatur "Temperatur EG [%.1f °C]" <temperature> (gZWaveNode2, gTemperature, gHomeEGTV) {zwave="2:3:command=SENSOR_MULTILEVEL, sensor_type=1, sensor_scale=0", imperihab="room:TV,label:Temperatur,type:DevTemperature,watts:zWaveSensor2Temperatur"} 

Page Top