Skip to content

Elero Transmitter Stick Binding ​

Allows to control Elero rollershutters through a connected Elero Transmitter Stick.

Supported Things ​

ThingsDescriptionThing Type
Elero Transmitter StickRepresents the physical Elero Transmitter Stick connected to a USB portelerostick
Elero ChannelRepresents one of the channels of an Elero Transmitter Stickelerochannel

Discovery ​

Discovery is supported only for Elero Channels. Just press the button in order to put it into your inbox after you have successfully manually created an Elero Transmitter Stick.

Thing Configuration ​

Elero Transmitter Stick ​

ParameterItem TypeDescription
Port NameStringThe serial port name for the USB receiver / LaCrosseGateway. Valid values are e.g. COM1 for Windows and /dev/ttyS0 or /dev/ttyUSB0 for Linux
Update IntervalNumberThe number of seconds to wait before polling a single channel again (default is 30 seconds)

Elero Channel ​

ParameterItem TypeDescription
Channel IDNumberThe ID of one of the 15 channels that are available on the stick (in the range of 1-15)

Channels ​

Elero Channel ​

Channel Type IDItem TypeDescription
controlRollershutterThe channel allowing to control the shutter
statusStringReadonly channel providing a string with status information from the Elero Channel. Possible values are: NO_INFORMATION, TOP, BOTTOM, INTERMEDIATE, VENTILATION, BLOCKING, OVERHEATED, TIMEOUT, START_MOVE_UP, START_MOVE_DOWN, MOVING_UP, MOVING_DOWN, STOPPED, TOP_TILT, BOTTOM_INTERMEDIATE, SWITCHED_OFF, SWITCHED_ON

Control ​

The binding does not support all percentage values as the Elero API does not allow to drive shutter to an exact position. It only accepts the following distinct percentages:

PercentageRollershutter CommandResult
0UProllershutter drives completely up
25-rollershutter drives to the INTERMEDIATE position
75-rollershutter drives to the VENTILATION position
100DOWNrollershutter drives completely down

Status ​

Status values reported by the stick are translated to percentages using the following mapping:

StatusRollershutter Percentage
NO_INFORMATION-
TOP0
BOTTOM100
INTERMEDIATE25
VENTILATION75
BLOCKING50
OVERHEATED50
TIMEOUT50
START_MOVE_UP50
START_MOVE_DOWN50
MOVING_UP50
MOVING_DOWN50
STOPPED50
TOP_TILT50
BOTTOM_INTERMEDIATE50
SWITCHED_OFF50
SWITCHED_ON50

Full Example ​

A typical thing configuration looks like this:

dsl
Bridge elerotransmitterstick:elerostick:0a0a0a0a [ portName="/dev/ttyElero2", updateInterval=5000 ]
Thing elerotransmitterstick:elerochannel:0a0a0a0a:1 (elerotransmitterstick:elerostick:0a0a0a0a) [ channelId=1 ]

A typical item configuration for a rollershutter looks like this:

dsl
Rollershutter Rollershutter1 {channel="elerotransmitterstick:elerochannel:0a0a0a0a:1:control",autoupdate="false" }
String Rollershutter1State  {channel="elerotransmitterstick:elerochannel:0a0a0a0a:1:status" }

A sitemap entry looks like this:

dsl
Selection item=Rollershutter1 label="Kitchen" mappings=[0="open", 100="closed", 25="shading"]