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

[knx] add color channel to knx binding docu (#14114) 

add color channel to knx binding docu
This commit is contained in:
Michael Geramb 2022-12-30 19:46:58 +01:00 committed by GitHub
parent 5881cf0cbe
commit 256bc81feb
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 29 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
bundles/org.openhab.binding.knx/README.md
View File

@ -1,4 +1,3 @@
# KNX Binding # KNX Binding
The openHAB KNX binding allows to connect to [KNX Home Automation](https://www.knx.org/) installations. The openHAB KNX binding allows to connect to [KNX Home Automation](https://www.knx.org/) installations.
@ -102,6 +101,15 @@ Note: After changing the DPT of already existing Channels, openHAB needs to be r
| position | Group address of the absolute position | 5.001 | | position | Group address of the absolute position | 5.001 |
| increaseDecrease | Group address for relative movement | 3.007 | | increaseDecrease | Group address for relative movement | 3.007 |
##### Channel Type "color"
| Parameter | Description | Default DPT |
|------------------|----------------------------------------|-------------|
| hsb | Group address for color | 232.600 |
| switch | Group address for the binary switch | 1.001 |
| position | Group address of the absolute position | 5.001 |
| increaseDecrease | Group address for relative movement | 3.007 |
##### Channel Type "rollershutter" ##### Channel Type "rollershutter"
| Parameter | Description | Default DPT | | Parameter | Description | Default DPT |
@ -158,6 +166,15 @@ If from the KNX bus a `GroupValueRead` telegram is sent to a *-control Channel,
| increaseDecrease | Group address for relative movement | 3.007 | | increaseDecrease | Group address for relative movement | 3.007 |
| frequency | Increase/Decrease frequency in milliseconds in case the binding should handle that (0 if the KNX device sends the commands repeatedly itself) | 0 | | frequency | Increase/Decrease frequency in milliseconds in case the binding should handle that (0 if the KNX device sends the commands repeatedly itself) | 0 |
##### Channel Type "color-control"
| Parameter | Description | Default DPT |
|------------------|----------------------------------------|-------------|
| hsb | Group address for color | 232.600 |
| switch | Group address for the binary switch | 1.001 |
| position | Group address of the absolute position | 5.001 |
| increaseDecrease | Group address for relative movement | 3.007 |
##### Channel Type "rollershutter-control" ##### Channel Type "rollershutter-control"
| Parameter | Description | Default DPT | | Parameter | Description | Default DPT |
@ -294,6 +311,7 @@ Bridge knx:ip:bridge [
readInterval=3600 readInterval=3600
] { ] {
Type switch : demoSwitch "Light" [ ga="3/0/4+<3/0/5" ] Type switch : demoSwitch "Light" [ ga="3/0/4+<3/0/5" ]
Type color : demoColorLight "Color" [ hsb="6/0/10+<6/0/11", switch="6/0/12+<6/0/13", position="6/0/14+<6/0/15", increaseDecrease="6/0/16+<6/0/17" ]
Type rollershutter : demoRollershutter "Shade" [ upDown="4/3/50+4/3/51", stopMove="4/3/52+4/3/53", position="4/3/54+<4/3/55" ] Type rollershutter : demoRollershutter "Shade" [ upDown="4/3/50+4/3/51", stopMove="4/3/52+4/3/53", position="4/3/54+<4/3/55" ]
Type contact : demoContact "Door" [ ga="1.019:<5/1/2" ] Type contact : demoContact "Door" [ ga="1.019:<5/1/2" ]
Type number : demoTemperature "Temperature" [ ga="9.001:<5/0/0" ] Type number : demoTemperature "Temperature" [ ga="9.001:<5/0/0" ]
@ -321,6 +339,7 @@ knx.items:
```java ```java
Switch demoSwitch "Light [%s]" <light> { channel="knx:device:bridge:generic:demoSwitch" } Switch demoSwitch "Light [%s]" <light> { channel="knx:device:bridge:generic:demoSwitch" }
Color demoColorLight "Color [%s]" <light> { channel="knx:device:bridge:generic:demoColorLight" }
Dimmer demoDimmer "Dimmer [%d %%]" <light> { channel="knx:device:bridge:generic:demoDimmer" } Dimmer demoDimmer "Dimmer [%d %%]" <light> { channel="knx:device:bridge:generic:demoDimmer" }
Rollershutter demoRollershutter "Shade [%d %%]" <rollershutter> { channel="knx:device:bridge:generic:demoRollershutter" } Rollershutter demoRollershutter "Shade [%d %%]" <rollershutter> { channel="knx:device:bridge:generic:demoRollershutter" }
Contact demoContact "Front Door [%s]" <frontdoor> { channel="knx:device:bridge:generic:demoContact" } Contact demoContact "Front Door [%s]" <frontdoor> { channel="knx:device:bridge:generic:demoContact" }
@ -334,13 +353,14 @@ knx.sitemap:
```perl ```perl
sitemap knx label="KNX Demo Sitemap" { sitemap knx label="KNX Demo Sitemap" {
Frame label="Demo Elements" { Frame label="Demo Elements" {
Switch item=demoSwitch Switch item=demoSwitch
Switch item=demoRollershutter Slider item=demoDimmer
Text item=demoContact Colorpicker item=demoColorLight
Text item=demoTemperature Default item=demoRollershutter
Slider item=demoDimmer Text item=demoContact
Text item=demoString Text item=demoTemperature
Text item=demoDatetime Text item=demoString
Text item=demoDatetime
} }
} }
@ -361,6 +381,7 @@ Bridge knx:serial:bridge [
Thing device generic { Thing device generic {
Type switch-control : controlSwitch "Control Switch" [ ga="3/3/10+<3/3/11" ] // '<' signs are allowed but will be ignored for control Channels Type switch-control : controlSwitch "Control Switch" [ ga="3/3/10+<3/3/11" ] // '<' signs are allowed but will be ignored for control Channels
Type dimmer-control : controlDimmer "Control Dimmer" [ switch="3/3/50+3/3/48", position="3/3/46", increaseDecrease="3/3/49", frequency=300 ] Type dimmer-control : controlDimmer "Control Dimmer" [ switch="3/3/50+3/3/48", position="3/3/46", increaseDecrease="3/3/49", frequency=300 ]
Type color : controlColorLight "Color" [ hsb="6/0/10", switch="6/0/12", position="6/0/14",
Type rollershutter-control : controlRollershutter "Control Rollershutter" [ upDown="3/4/1+3/4/2", stopMove="3/4/3", position="3/4/4" ] Type rollershutter-control : controlRollershutter "Control Rollershutter" [ upDown="3/4/1+3/4/2", stopMove="3/4/3", position="3/4/4" ]
Type number-control : controlNumber "Control Number" [ ga="1/2/2" ] Type number-control : controlNumber "Control Number" [ ga="1/2/2" ]
Type string-control : controlString "Control String" [ ga="1/4/2" ] Type string-control : controlString "Control String" [ ga="1/4/2" ]