added migrated 2.x add-ons
Signed-off-by: Kai Kreuzer <kai@openhab.org>
This commit is contained in:
96
bundles/org.openhab.binding.elerotransmitterstick/README.md
Normal file
96
bundles/org.openhab.binding.elerotransmitterstick/README.md
Normal file
@@ -0,0 +1,96 @@
|
||||
# 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"]
|
||||
```
|
||||
Reference in New Issue
Block a user