Skip to content

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:

ThingThingTypeIDDescription
myStrom Smart PlugmystromplugA myStrom smart plug
myStrom BulbmystrombulbA myStrom bulb
myStrom Motion SensormystrompirA 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:

ParameterTypeRequiredDefault if omittedDescription
hostnamestringyeslocalhostThe IP address or hostname of the myStrom smart plug
refreshintegerno10Poll interval in seconds. Increase this if you encounter connection errors
apiTokenstringnoSpecifies 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-NameDescription
versionCurrent firmware version
typeThe type of the device (i.e. bulb = 102)
ssidSSID of the currently connected network
ipCurrent ip address
maskMask of the current network
gatewayGateway of the current network
dnsDNS of the current network
staticWhether or not the ip address is static
connectedWhether or not the device is connected to the internet
macThe mac address of the bridge in upper case letters without delimiter

Channels ​

Channel IDItem TypeRead onlyDescriptionThing types supporting this channel
switchSwitchfalseTurn the device on or offmystromplug, mystrombulb
powerNumber:PowertrueThe currently delivered powermystromplug, mystrombulb
energy-consumed-since-last-callNumber:EnergytrueThe watt seconds / Energy consumed since last call. Useful for accurate data logging and analysismystromplug
temperatureNumber:TemperaturetrueThe temperature at the plugmystromplug, mystrompir
colorColorfalseThe color we set the bulb to (mode 'hsv')mystrombulb
colorTemperatureDimmerfalseThe color temperature of the bulb in mode 'mono' (percentage)mystrombulb
brightnessDimmerfalseThe brightness of the bulb in mode 'mono'mystrombulb
rampNumber:TimefalseTransition time from the light’s current state to the new state. [ms]mystrombulb
modeStringfalseThe color mode we want the Bulb to set to (rgb, hsv or mono)mystrombulb
lightDimmertrueThe brightness of the Room.mystrompir
motionSwitchtrueMotionstatus of the sensormystrompir

Full Example ​

Thing Configuration ​

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

Item Configuration ​

dsl
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 ​

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