public/openhab-addons
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

[velux] fix bugs with Somfy devices, and switch devices (#9245)

Browse Source 
* [velux] add data type to config params in readme
* [velux] eliminate mvn warning
* [velux] fix Somfy bugs: uniqueindex = serial number or name
* [velux] fix inconsistent switch state logic
* [velux] cosmetics on BRIDGE_THING_TYPE_UID

Signed-off-by: Andrew Fiddian-Green <software@whitebear.ch>
This commit is contained in:
Andrew Fiddian-Green
2020-12-08 17:20:14 +00:00
committed by GitHub
parent d2e5c3e7dd
commit ce5d5ca61d
8 changed files with 129 additions and 97 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
bundles/org.openhab.binding.velux/README.md
View File

@@ -82,17 +82,17 @@ These types of Thing only supported in the Velux Bridge in API version two or hi
These types of Thing are configured by means of their serial number in the hub.
In addition there are some optional Configuration Parameters.
| Configuration Parameter | Default | Required | Description |
|-------------------------|------------------------|:--------:|-------------------------------------------------------------------|
| serial | | Yes | Serial number of the io-homecontrol device in the hub. |
| name | | No | (Optional) name of the io-homecontrol device in the hub. |
| inverted | false | No | (Optional) the position is inverted (i.e. 0% translates to 100%). |
| Configuration Parameter | Default | Type | Required | Description |
|-------------------------|---------|---------|:--------:|----------------------------------------------------------------------------------------|
| serial | | custom | Yes | Serial number of the device in the hub (custom format 00:00:00:00:00:00:00:00) |
| name | | text | No | Name of the device in the hub. |
| inverted | false | boolean | No | The `position` and `state` (if available) are inverted (i.e. 0% <-> 100%, OFF <-> ON). |
Notes:
1. To enable a complete inversion of all parameter values (i.e. for Velux windows), use the property `inverted` or add a trailing star to the eight-byte serial number. For an example, see below at item `Velux DG Window Bathroom`.
2. Somfy devices do not provide a valid serial number to the Velux KLF200 gateway. The bridge reports a registration of the serial number 00:00:00:00:00:00:00:00. Therefore the binding implements a fallback to allow an item specification with a actuator `name` instead of actuator serial number whenever such an invalid serial number occurs. For an example, see below at item `Velux OG Somfy Shutter`.
2. Somfy devices do not provide a valid serial number to the Velux KLF200 gateway. In this case you should enter the default `serial` number 00:00:00:00:00:00:00:00, and in addition enter the `name` parameter; this is the name that you gave to the actuator when you first registered it in the KLF200 Bridge. For an example, see below at item `Velux OG Somfy Shutter`.
### Thing Configuration for "scene"
@@ -100,10 +100,10 @@ The Velux Bridge in API version one (firmware version 0.1.1.*) allows activating
So besides the bridge, only one real Thing type exists, namely "scene".
This type of Thing is configured by means of its scene name in the hub.
| Configuration Parameter | Default | Required | Description |
|-------------------------|------------------------|:--------:|-----------------------------------------------------------------------|
| sceneName | | Yes | Name of the scene in the hub. |
| velocity | | No | The speed at which the scene will be executed (deafult, silent, fast) |
| Configuration Parameter | Default | Type | Required | Description |
|-------------------------|-----------|------|:--------:|-----------------------------------------------------------------------------|
| sceneName | | text | Yes | Name of the scene in the hub. |
| velocity | 'default' | text | No | The speed at which the scene will be executed ('default', 'silent', 'fast') |
### Thing Configuration for "vshutter"
@@ -112,10 +112,10 @@ So besides the bridge, this binding provides a virtual rollershutter Thing consi
Therefore the respective Item definition contains multiple pairs of rollershutter levels each followed by a scene name.
The virtual shutter Thing must be configured with pairs of level (0..10%) combined with the appropriate scene names (text) as follows.
| Configuration Parameter | Default | Required | Description |
|-------------------------|------------------------|:--------:|-----------------------------------------------------------|
| sceneLevels | | Yes | <Level1>,<Scene1>,<Level2>,<Scene2>,.... |
| currentLevel | 0 | No | Inverts any device values. |
| Configuration Parameter | Default | Type | Required | Description |
|-------------------------|---------|---------|:--------:|-----------------------------------------|
| sceneLevels | | text | Yes | {Level1},{Scene1},{Level2},{Scene2},.. |
| currentLevel | 0 | integer | No | Inverts any device values (0..100). |
## Supported Channels for Thing Types