openhab-addons/bundles/org.openhab.binding.elerotransmitterstick

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"]