# 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"]
Caught a mistake or want to contribute to the documentation? Edit this page on GitHub (opens new window)
← ekey ELRO Connects →