# 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)