loginToken

To obtain a loginToken, point your browser to https://dss.local:8080/json/system/requestApplicationToken?applicationName=openHAB

Store the result in openhab.cfg file

After receiving the application token you need to enable it in your digitalSTROM configurator under System -> Zugriffsberechtigung

Binding Configuration

The binding can be configured in the file services/digitalstrom.cfg.

Property

Default

Required

Description

uri

Yes

The hostname and port of the digitalSTROM server (dSS); eg. https://dss.local:8080

connectTimeout

4000

No

The connect timeout (in milliseconds)

loginToken

No

A token to allow login without a username and password; required if user and password settings are not specified

password

dssadmin

No

The username to use for login; required if loginToken setting is not specified

readTimeout

10000

No

The read timeout (in milliseconds)

refreshinterval

1000

No

The refresh interval (in milliseconds)

user

dssadmin

No

The password to use for login; required if loginToken setting is not specified

Note: if the loginToken, user, and password settings are all specified, the loginToken will be used for login.

Item Configuration

Item bindings must conform to the following format:

digitalstrom="<key1>:<value1>[#<keyN>:<valueN>]"

See examples below.

The following keys are supported:

dsid // digitalSTROM device id; the shorter dsid, known as S.N: xxxxxxxx (8 letters), is also supported
dsmid // digitalSTROM meter id (dSM)
consumption // optional for metering
timeinterval // timeinterval to initiate a metering job
context // in some cases use context:
zoneid // only in combination with a NumberItem or StringItem for apartment or zone calls
groupid // only in combination with a NumberItem or StringItem for apartment or zone calls

The following are the supported values for the consumption key:

ACTIVE_POWER // in use with a device or meter -> current power consumption (w)
OUTPUT_CURRENT // only in use with a device -> amperage (mA)
ELECTRIC_METER // only in use with a meter (wh)

The following are the supported values for the context key:

slat // important if it's a roller shutter: to have a item to control the slats
awning // important for roller shutter: if it's a marquee/awning to show the right icon -> open-close
apartment // in combination with a NumberItem or StringItem to make apartment calls
zone // in combination with a NumberItem or StringItem to make zone calls

Selection item=Apartment_Scene label="Apartment Scene Selection" mappings=[65=Panik, 72=Gehen] // here you have to use a valid sceneID
Switch item=Zone_Scene label="Room Scene" mappings=[14=On, 13=Off] // here you have to use a valid sceneID

Consumption

To poll and/or persist/visualize the curent power consumption (ACTIVE_POWER), use StringItems or NumberItems.