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

# myStrom Binding

This extension adds support for the myStrom devices. As of today only the Smart Plug, Bulb and the Motionsensor are implemented.

# Supported Things

This bundle adds the following thing types:

Thing ThingTypeID Description
myStrom Smart Plug mystromplug A myStrom smart plug
myStrom Bulb mystrombulb A myStrom bulb
myStrom Motion Sensor mystrompir A myStrom PIR motion sensor

According to the myStrom API documentation all request specific to the myStrom Bulb are also work on the LED strip.

# Discovery

This extension does not support autodiscovery. The things need to be added manually.

# Thing Configuration

The following parameters are valid for all thing types:

Parameter Type Required Default if omitted Description
hostname string yes localhost The IP address or hostname of the myStrom smart plug
refresh integer no 10 Poll interval in seconds. Increase this if you encounter connection errors
apiToken string no Specifies the API Token, if required.

# Properties

In addition to the configuration a myStrom thing has the following properties. The properties are updated during initialize. Disabling/enabling the thing can be used to update the properties.

Property-Name Description
version Current firmware version
type The type of the device (i.e. bulb = 102)
ssid SSID of the currently connected network
ip Current ip address
mask Mask of the current network
gateway Gateway of the current network
dns DNS of the current network
static Whether or not the ip address is static
connected Whether or not the device is connected to the internet
mac The mac address of the bridge in upper case letters without delimiter

# Channels

Channel ID Item Type Read only Description Thing types supporting this channel
switch Switch false Turn the device on or off mystromplug, mystrombulb
power Number:Power true The currently delivered power mystromplug, mystrombulb
energy-consumed-since-last-call Number:Energy true The watt seconds / Energy consumed since last call. Useful for accurate data logging and analysis mystromplug
temperature Number:Temperature true The temperature at the plug mystromplug, mystrompir
color Color false The color we set the bulb to (mode 'hsv') mystrombulb
colorTemperature Dimmer false The color temperature of the bulb in mode 'mono' (percentage) mystrombulb
brightness Dimmer false The brightness of the bulb in mode 'mono' mystrombulb
ramp Number:Time false Transition time from the light’s current state to the new state. [ms] mystrombulb
mode String false The color mode we want the Bulb to set to (rgb, hsv or mono) mystrombulb
light Dimmer true The brightness of the Room. mystrompir
motion Switch true Motionstatus of the sensor mystrompir

# Full Example

# Thing Configuration

Thing mystrom:mystromplug:d6217a31 "Plug" [hostname="hostname|ip"]

# Item Configuration

Switch              PlugSwitch                      "Plug"                      {channel="mystrom:mystromplug:d6217a31:switch"}
Number:Temperature  PlugTemperature                 "Temperature: [%.1f °C]"    {channel="mystrom:mystromplug:d6217a31:temperature"}  
Number:Power        PlugPower                       "Power: [%.1f W]"           {channel="mystrom:mystromplug:d6217a31:power"}
Number:Energy       PlugEnergyConsumedSinceLastCall "Ws: [%.1f Ws]"             {channel="mystrom:mystromplug:d6217a31:energy-consumed-since-last-call"} 

# Sitemap Configuration

Frame label="myStrom Plug" { 
    Switch item=PlugSwitch
    Text item=PlugTemperature
    Text item=PlugPower
}