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

# Elero Transmitter Stick Binding

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

# Supported Things

Things Description Thing Type
Elero Transmitter Stick Represents the physical Elero Transmitter Stick connected to a USB port elerostick
Elero Channel Represents one of the channels of an Elero Transmitter Stick elerochannel

# 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

Parameter Item Type Description
Port Name String The 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 Interval Number The number of seconds to wait before polling a single channel again (default is 30 seconds)

# Elero Channel

Parameter Item Type Description
Channel ID Number The ID of one of the 15 channels that are available on the stick (in the range of 1-15)

# Channels

# Elero Channel

Channel Type ID Item Type Description
control Rollershutter The channel allowing to control the shutter
status String Readonly 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:

Percentage Rollershutter Command Result
0 UP rollershutter drives completely up
25 - rollershutter drives to the INTERMEDIATE position
75 - rollershutter drives to the VENTILATION position
100 DOWN rollershutter drives completely down

# status

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

Status Rollershutter Percentage
NO_INFORMATION -
TOP 0
BOTTOM 100
INTERMEDIATE 25
VENTILATION 75
BLOCKING 50
OVERHEATED 50
TIMEOUT 50
START_MOVE_UP 50
START_MOVE_DOWN 50
MOVING_UP 50
MOVING_DOWN 50
STOPPED 50
TOP_TILT 50
BOTTOM_INTERMEDIATE 50
SWITCHED_OFF 50
SWITCHED_ON 50

# Full Example

A typical thing configuration looks like this:

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:

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

A sitemap entry looks like this:

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