added migrated 2.x add-ons
Signed-off-by: Kai Kreuzer <kai@openhab.org>
This commit is contained in:
65
bundles/org.openhab.binding.somfymylink/README.md
Normal file
65
bundles/org.openhab.binding.somfymylink/README.md
Normal file
@@ -0,0 +1,65 @@
|
||||
# Somfy myLink Binding
|
||||
|
||||
This binding supports the [Somfy myLink](https://www.somfysystems.com/en-us/products/1811403/mylink-) device for control of Somfy RTS blinds/shades.
|
||||
|
||||
## Supported Things
|
||||
|
||||
Currently these things are supported:
|
||||
|
||||
- bridge (Somfy MyLink bridge, which can discover roller shades and scenes)
|
||||
- roller shades (UP, DOWN, STOP control of a roller shade).
|
||||
|
||||
This binding has been tested with myLink firmware 5.23.
|
||||
|
||||
## Discovery
|
||||
|
||||
To start a discovery:
|
||||
|
||||
- install this binding
|
||||
- open Paper UI
|
||||
- add a new thing in menu Configuration/Things
|
||||
- choose SomfyMyLink Binding and select Somfy MyLink Bridge
|
||||
- enter it's IP Address and system id. The system id This can be found in the integration settings -> Control4 section of your My Link app
|
||||
|
||||
If the supplied ip address and system id are correct, the automatic discovery starts immediately and detected roller shades appear in Paper UI inbox.
|
||||
|
||||
## Thing Configuration
|
||||
|
||||
### mylink
|
||||
|
||||
| Parameter | Parameter ID | Required/Optional | Description |
|
||||
|------------------|-------------------|-------------------|-------------|
|
||||
| IP or Hostname | ipAddress | Required | Hostname or IP Address of the myLink device |
|
||||
| System Id | systemId | Required | The system id configured on the myLink device |
|
||||
|
||||
### shade
|
||||
|
||||
| Parameter | Parameter ID | Required/Optional | Description |
|
||||
|------------------|-------------------|-------------------|-------------|
|
||||
| Target ID | targetId | Required | Address of shade in the Somfy system |
|
||||
|
||||
### scene
|
||||
|
||||
| Parameter | Parameter ID | Required/Optional | Description |
|
||||
|------------------|-------------------|-------------------|-------------|
|
||||
| Scene ID | sceneId | Required | Address of scene in the Somfy system |
|
||||
|
||||
## Channels
|
||||
|
||||
The following channels are supported by the binding. Note that specific weather station models may support only some or all of these channels.
|
||||
|
||||
| Channel ID | Item Type | Description |
|
||||
|---------------------------------|-------------------------|---------------------------------------------------------------|
|
||||
| shadeControl | Rollershutter | Device control (UP, DOWN, STOP) |
|
||||
| scenelist | String | Comma-separated list of scenes of form sceneId=sceneName |
|
||||
| button | Switch | Button to trigger a scene or rule |
|
||||
|
||||
## Example
|
||||
|
||||
### Things
|
||||
|
||||
```
|
||||
Bridge somfymylink:mylink:mylink1 "myLink Bridge" @ "Office" [ ipAddress="192.168.1.1", systemId="mysystemidhere" ] {
|
||||
Thing shade shade1 "Living Room" [ targetId="CC114A21.1" ]
|
||||
}
|
||||
```
|
||||
Reference in New Issue
Block a user