This page is part of archived documentation for openHAB 2.5. Go to the current stable version

# RWE SmartHome Binding v1

This binding allows openHAB to be integrated RWE SmartHome (opens new window) software previous to version 2.0. It uses an unofficial interface, which is limited in some cases, as explained below. As the interface has some delay and polling is needed to receive all changes from the RWE SmartHome Central (SHC), it may take one or two seconds until a device finally responds. However, this is tolerable in most cases as time critical rules can be done in the RWE Smarthome Central itself.

# Limitations

  1. This binding only works with the "old" RWE SmartHome software and will NOT WORK anymore with the RWE 2.0 Software (released on 01.09.2016). Do not update your RWE Software if you still like to use this binding!
  2. This binding is based on an unofficial interface, which may be changed or even closed by RWE at any time.
  3. The binding only runs with TLSv1, which is default until Java 1.7. If you use Java 1.8, you have to add -Djdk.tls.client.protocols=TLSv1 to the java command in your start.sh/start.bat (opens new window) file. In openHAB 2, the java command is somewhere at the end of runtime/karaf/bin/karaf.

Warning: Using TLSv1 as mentioned above can cause troubles for other bindings that rely on a newer TLS version.

# Binding Configuration

This binding can be configured in the file services/rwesmarthome.cfg.

Property Default Required Description
host Yes IP address of the RWE SmartHome server
username Yes user name for the RWE SmartHome server
password Yes password for the RWE SmartHome server
alive.interval 300 No interval in seconds to check if the communication with the RWE SmartHome server is still alive. If no message receives from the RWE Smarthome server, the binding restarts.
binding.changed.interval 15 No interval in seconds to wait after the binding configuration has changed before the device states will be reloaded from the RWE SHC.

# Example

host=192.168.0.2
username=myuser
password=mysecretpassword

# Item Configuration

All items use the format

rwe="id=<logical-device-id>,param=<parameter>"}

where <logical-device-id> is a unique number for each logical device (e.g. 2951a048-1d21-5caf-d866-b63bc00280f4) and <parameter> is the desired parameter of the device. A thermostat for example has a 'settemperature' and a 'operationmodeauto' to choose from.

As the IDs are internal numbers and not visible in the RWE software, the binding outputs a list of found devices including the supported parameters to the openHAB console/logfile. For the ease of use and a quick startup, it even outputs an example item-config for each item, which can easily be copied into the *.items config file.

The following parameters are available:

Property Item Type Description
contact Contact Window/Door contact
temperature Number Temperature sensor
settemperature Number Desired temperature of a thermostat
operationmodeauto Switch Operationmode of a thermostat
humidity Number Humidity sensor
luminance Number Luminance sensor
switch Switch Switch state, e.g. wall plug
dimmer Dimmer Dimmer
dimmerinverted Dimmer Dimmer with inverted values
rollershutter Rollershutter Rollershutter
rollershutterinverted Rollershutter Rollershutter with inverted values, recommended!
smokedetector String State of a smokedetector
alarm Switch Siren of a smokedetector
variable Switch Variable as defined in SHC
totalenergy Number Total energy consumption in kWh of a PowerControl/EnergyControl (since 1.9.0)
energypermonthinkwh Number energy consumption per month in kWh of a PowerControl/EnergyControl (since 1.9.0)
energypermonthineuro Number energy consumption in EUR of a PowerControl/EnergyControl (since 1.9.0)
energyperdayinkwh Number energy consumption per day in kWh of a PowerControl/EnergyControl (since 1.9.0)
energyperdayineuro Number energy consumption in EUR of a PowerControl/EnergyControl (since 1.9.0)
powerinwatt Number current power consumption in Watts of a PowerControl/EnergyControl (since 1.9.0)

Supported (confirmed) devices and corresponding parameters are:

  • RWE SmartHome Bewegungsmelder innen (WMD): luminance only, movement only via variable, see examples.
  • RWE SmartHome Heizkörperthermostat (RST): temperature, settemperature, operationmodeauto, humidity
  • RWE SmartHome Rauchmelder (WSD): smokedetector, alarm
  • RWE SmartHome Tür-/Fenstersensor (WDS): contact
  • RWE SmartHome Unterputz-Dimmer (ISD2): dimmer, dimmerinverted
  • RWE SmartHome Unterputz-Lichtschalter (ISS2): switch
  • RWE SmartHome Unterputz-Rollladensteuerung (ISR2): rollershutter, rollershutterinverted
  • RWE SmartHome Wandsender (WSC2): only indirect via variable, see examples.
  • RWE SmartHome Zwischenstecker (PSS): switch
  • RWE SmartHome Zwischenstecker aussen (PSSOz): switch
  • RWE SmartHome Zwischenstecker dimmbar (PSD): dimmer, dimmerinverted
  • RWE SmartHome Power Control (since 1.9.0): totalenergy, energypermonthinkwh, energypermonthineuro, energyperdayinkwh, energyperdayineuro, powerinwatt
  • RWE SmartHome Power Control Solar (since 1.9.0): totalenergy, energypermonthinkwh, energypermonthineuro, energyperdayinkwh, energyperdayineuro, powerinwatt
  • RWE SmartHome Energy Control (since 1.9.0): totalenergy, energypermonthinkwh, energypermonthineuro, energyperdayinkwh, energyperdayineuro, powerinwatt

Unconfirmed but probably supported devices and corresponding parameters are (please report and confirm, if you own one of the following devices and they are working):

  • RWE SmartHome Bewegungsmelder aussen (WMDO): luminance only, movement only via variable, see examples
  • RWE SmartHome Fernbedienung (BRC8): only indirect via variable, see examples
  • RWE SmartHome Raumthermostat (WRT): temperature, settemperature, operationmodeauto, humidity
  • RWE SmartHome Unterputz-Sender (ISC2): only indirect via variable, see examples

# Examples

Replace the example-id with the IDs of your devices. You can find the ID of your devices in the openHAB log file or console when the RWE Smarthome binding starts.

items/rwesmarthomedemo.items

Contact rweContact "Window livingroom [MAP(de.map):%s]" <contact> {rwe="id=2951a048-1d21-5caf-d866-b63bc00280f4,param=contact"}
Number rweHumidity "Humidity livingroom [%.1f %%]" <temperature> {rwe="id=2951a048-1d21-5caf-d866-b63bc00280f4,param=humidity"}
Number rweLuminance "Luminance corridor [%d %%]" <slider> {rwe="id=2951a048-1d21-5caf-d866-b63bc00280f4,param=luminance"}
Number rweSettemp "Settemp living [%.1f °C]" <temperature> {rwe="id=2951a048-1d21-5caf-d866-b63bc00280f4,param=settemperature"}
Number rweTemp "Temp living [%.1f °C]" <temperature> {rwe="id=2951a048-1d21-5caf-d866-b63bc00280f4,param=temperature"}
Switch rweAlarm "Alarm corridor" <siren> {rwe="id=2951a048-1d21-5caf-d866-b63bc00280f4,param=alarm"}
Switch rweSettempOpMode "Settemp living auto" <temperature> {rwe="id=2951a048-1d21-5caf-d866-b63bc00280f4,param=operationmodeauto"}
Switch rweSmokeDetector "Smokedetector corridor" <fire> {rwe="id=2951a048-1d21-5caf-d866-b63bc00280f4,param=smokedetector"}
Switch rweSwitch "Light corridor" <switch> {rwe="id=2951a048-1d21-5caf-d866-b63bc00280f4,param=switch"}
Switch rweVariable "Variable TEST" <switch> {rwe="id=2951a048-1d21-5caf-d866-b63bc00280f4,param=variable"}
Rollershutter rweRollershutter "Rollershutter living [%d %%]" <rollershutter> {rwe="id=2951a048-1d21-5caf-d866-b63bc00280f4,param=rollershutterinverted"}
Dimmer rweDimmer "Light [%d %%]" <slider> {rwe="id=2951a048-1d21-5caf-d866-b63bc00280f4,param=dimmer"}
Number rweEnergyConsumptionTotal "EnergyConsumption total [%.3f kWh]" <energy> {rwe="id=2951a048-1d21-5caf-d866-b63bc00280f4,param=totalenergy"}
Number rweEnergyConsumptionMonthKWh "EnergyConsumption per month [%.3f kWh]" <energy> {rwe="id=2951a048-1d21-5caf-d866-b63bc00280f4,param=energypermonthinkwh"}
Number rweEnergyConsumptionMonthEuro "EnergyConsumption per month [%.2f €]" <energy> {rwe="id=2951a048-1d21-5caf-d866-b63bc00280f4,param=energypermonthineuro"}
Number rweEnergyConsumptionDayKWh "EnergyConsumption per day [%.3f kWh]" <energy> {rwe="id=2951a048-1d21-5caf-d866-b63bc00280f4,param=energyperdayinkwh"}
Number rweEnergyConsumptionDayEuro "EnergyConsumption per day [%.2f €]" <energy> {rwe="id=2951a048-1d21-5caf-d866-b63bc00280f4,param=energyperdayineuro"}
Number rwePowerConsumption "PowerConsumption [%.2f W]" <energy> {rwe="id=2951a048-1d21-5caf-d866-b63bc00280f4,param=powerinwatt"}

# Solutions/examples for not directly supported devices

Some devices like a simple pushbutton (e.g. "Wandsender WSC2") or a motion detector are not sent over the interface and thus not directly reachable by the binding. However, there are workarounds based on variables and RWE profiles, which allow using even those devices with openHAB.

The general idea is to exchange the state of a device via a variable. To do this, you have to create a variable in the RWE software and change the state of the variable by an RWE event profile. As the variable state is sent to OpenHAB, you can use an openHAB rule to react.

Note: Because of the delay of the interface it is not recommended to use this solution for time critical applications like switching your lights on when you press the button next to the door. You should implement time critical rules directly in the RWE software and use OpenHAB for the more sophisticated things. 😉

# Workarround for pushbuttons

Works with the following devices:

  • RWE SmartHome Wandsender (WSC2)
  • RWE SmartHome Unterputz-Sender (ISC2)
  • RWE SmartHome Fernbedienung (BRC8)
  1. Create a variable for each button, e.g. "SwitchLivingBtn1" and so on.
  2. Create an event profile in the RWE software: if the upper button of the device is pushed, set variable "SwitchLivingBtn1" to ON for one second (activate the automatic switch-off after one second).
  3. Create an OpenHAB item for the variable: Switch rweSwitchLivingBtn1 "Switch Btn1" <switch> {rwe="id=2951a048-1d21-5caf-d866-b63bc00280f4,param=variable"} (use the id of your specific variable "SwitchLivingBtn1", which you can find in the openhab.log at startup of the binding.
  4. Create an OpenHAB rule to react:
rule "Toggle TV if button 1 is pressed"
when
	Item rweSwitchLivingBtn1 changed to ON
then
	if(TV.state == ON)
		TV.sendCommand(OFF)
	else
		TV.sendCommand(ON)
end

# Workaround for motiondetectors

Works with the following devices:

  • RWE SmartHome Bewegungsmelder innen (WMD)
  • RWE SmartHome Bewegungsmelder aussen (WMDO)

The solution is mainly the same as for pushbuttons (see above). Simply set the auto-off-time in the RWE profile to a longer period, e.g. 1 minute. Now the variable is on, when a motion occurs until there is no motion any more for about a minute.