Samples Binding Config
This page contains samples for binding configurations. These samples are sorted by binding.
- How to - KNX basic configuration
- How to send Date and Time from NTP to KNX
- How to use KNX data types 2.xxx Priority Control
- How to use KNX scenes
- How to get temperatures from OW-SERVER via HTTP binding
- How to get humidity from OW-SERVER via HTTP binding
- How to get contact from OW-SERVER via HTTP binding
- How to turn on/off a switch from OW-SERVER via HTTP binding
- How to read the status from a OneWire sensor DS2413 (2 port I/O)
- How to get data from Kostal Piko solar inverter via HTTP binding
- How to send commands to Telldus Tellstick
- How to get power on a TV connected to HDMI with exec binding and update the status automatically
The openhab.cfg file
- The easiest way of configuring a KNX binding is by connecting in ROUTER mode. To do so, enable this:
knx:type=ROUTER. If you cannot use the ROUTER mode, set it to TUNNEL, but you must then configure the IP:knx:ip=<IP of the KNX-IP module>
The items file
The items may include the KNX group address to use them. They might be actively read by openHAB or not. They look like this:
-
Number Lighting_Room_Sensor "Lighting in the Room [Lux](%.2f)" <switch> (Room,Lighting) { knx = "<0/1/1" }: This is a sensor item. It uses the 0/1/1 group address and openHAB will ask for its value periodically because there is a "<" sign before the address. It is a number item, called Lighting_Room_Sensor, and belongs to Room and Lighting groups. -
Switch Light_Room_Table "Table Light" (Room, Lights) { knx = "<0/1/10+0/1/30"}: This is a switch item that has two addresses. openHAB may responds to events in any of them, but may actively read the first one.
This example sends the current date and time from the NTP to the KNX binding
DateTime Date "Date & Time [%1$td.%1$tm.%1$tY %1$tT]" { ntp="Europe/Berlin:de_DE", knx="11.001:0/0/1, 10.001:0/0/2" }
Items:
0/0/1 is the GA for Date
0/0/2 is the GA for Time
Additional information on date and time formatting can be found here
Starting with version 1.6.0 KNX data types 2.xxx are supported. This examples shows the usage of DPT 2.001 "Switch Control".
item definition:
Number item2_001 "2.001 Switch Control" { knx="2.001:1/2/3"}
sitemap definition:
Selection item=item2_001 mappings=[ 0="priority override disabled (off)", 1="priority override disabled (on)", 2="priority override: off", 3="priority override: on" ]
or
Switch item=item2_001 mappings=[ 0="priority override disabled (off)", 1="priority override disabled (on)", 2="priority override: off", 3="priority override: on" ]
KNX devices differ in the ways scenes can be activated and learned (programmed). Some devices require a bit trigger using data point type 1.022 "DPT_SCENE_AB", which will activate either scene A or B. These devices can be used as follows (starting with version 1.6.0):
item definition:
Number item1_022 "1.022 SCENE AB" { knx="1.022:1/2/3"}
sitemap definition:
Selection item=item1_022 mappings=[ 0="Scene A", 1="Scene B" ]
or
Switch item=item1_022 mappings=[ 0="Scene A", 1="Scene B" ]
Some devices require a byte using data point type 18.001 "DPT_SCENE_CONTROL", which will activate or learn one of 64 possible scenes. Adding 128 to the scene number to allow switching to learn mode. Example: "activate Scene 2" requires value 1, "learn Scene 2" requires value 129 These devices can be used as follows (starting with version 1.6.0):
item definition:
Number item18_001 "Scene Control" {knx="18.001:1/2/3"}
sitemap definition:
Selection item=item18_001 mappings=[ 0="Scene 1", 1="Scene 2", 2="Scene 3", 3="Scene 4", 128="learn Scene 1", 129="learn Scene 2", 130="learn Scene 3" ]
or
Switch item=d18_001 mappings=[0="Scene 1", 1="Scene 2", 2="Scene 3", 128="learn Scene 1", 129=" learn Scene 2", 130="learn Scene 3"]
If you have a device requiring 17.001 DPT_SCENE_NUMBER for selecting or indicating scenes, then use one of the above mentioned examples and replace 18.001 with 17.001. Additionally, remove all "learn" mappings.
Requirements:
- OW-SERVER with Ethernet
- DS18B20-Sensors (or DS18S20) connected via 1-wire-bus
Instructions:
-
Go to http://
<ow-server-IP>/devices.htm and look for the ROMId-Value -
Add an Number-Item to your items-configuration like this one
// Example:
Number Temp_Kitch "Küche [°C](%.1f)" { http="<[Units=\"Centigrade\">(.*?)</Temperature>.*)](http://192.168.1.16/details.xml:60000:REGEX(.*?<ROMId>A7000002CC4D2228</ROMId>.*?<Temperature)" }
Replace the ip address and the ROMId-value with your data.
Device: OW-ENV-TH (EDS0065)
Example:
Number Humidity "Humidity [%.1f %%]" { http="<[http://192.168.1.16/details.xml:5000:REGEX(.*?<ROMId>C30010000027767E</ROMId>.*?<Humidity Units=\"PercentRelativeHumidity\">(.*?)</Humidity>.*)]" }
Device: D2C (DS2406)
Example:
Number Door "Door [MAP(contact.map):%d]" { http="<[http://192.168.1.16/details.xml:5000:REGEX(.*?<ROMId>BD0000009D93DC12</ROMId>.*?<InputLevel_A>(.*?)</InputLevel_A>.*)]" }
You may want to change the query-interval (here 5000ms) to a few seconds. You can get the value for InputLevel_B, too. ;)
contact.map:
0=open
1=close
-=UNKNOWN
Device: D2C (DS2406)
Example:
Switch Lamp "Switch [MAP(switch.map):%d]" { http="<[http://192.168.1.16/details.xml:5000:REGEX(.*?<ROMId>BD0000009D93DC12</ROMId>.*?<InputLevel_B>(.*?)</InputLevel_B>.*)]" }
This only reads the state of the switch.
switch.map:
1=ON
0=OFF
-=undefiniert
To turn the switch on or off you need to define two rules: rule "Turn Lamp on" when Item Lamp changed to ON then sendHttpGetRequest("http://192.168.1.16/devices.htm?rom=BD0000009D93DC12&variable=FlipFlop_B&value=0") end
rule "Turn Lamp off"
when
Item Lamp changed to OFF
then
sendHttpGetRequest("http://192.168.1.16/devices.htm?rom=BD0000009D93DC12&variable=FlipFlop_B&value=1")
end
item definition:
Number WindowContact1 "Window 1 is [MAP(contact.map):%s]" (All) { onewire = "3C.16AA13000000#sensed.A" }
Number WindowContact2 "Window 2 is [MAP(contact.map):%s]" (All) { onewire = "3C.16AA13000000#sensed.B" }
sitemap definition:
Text item=WindowContact1
Text item=WindowContact2
map file contact.map
1=closed
0=opened
Sample output for this definition would then be "Window 1 is opened" or "Window 2 is closed".
/* AC power */
Number Solar_Aktuell "current photo-voltaic power [%.0f W]" <inverter> { http="<[http://pvserver:[email protected]/index.fhtml:60000:REGEX(.*?aktuell</td>.*?([0-9]*)</td>.*)]" }
/* Energy */
Number Solar_Gesamt "total energy (runtime) [%.0f kWh]" <energy> { http="<[http://pvserver:[email protected]/index.fhtml:60000:REGEX(.*?Gesamtenergie</td>.*?(\\d*)</td>.*)]" }
Number Solar_Tagesenergie "total energy (per day) [%.2f kWh]" <energy> { http="<[http://pvserver:[email protected]/index.fhtml:60000:REGEX(.*Tagesenergie</td>.*?([0-9\\.]*)</td>.*)]" }
/* photo-voltaic inverter */
/* the following samples are not verified yet! Update comming soon */
Number Solar_PVG_Str1_Spannung "String 1 Spannung [%.0f V]" { http="<[http://pvserver:[email protected]/index.fhtml:60000:REGEX(.*?String 1</u></td>.*?Spannung</td>.*? (.*?)</td>.*)]" }
Number Solar_PVG_Str1_Strom "String 1 Strom [%.2f A]" { http="<[http://pvserver:[email protected]/index.fhtml:60000:REGEX(.*?String 1</u></td>.*?Strom</td>.*? (.*?)</td>.*)]" }
Number Solar_PVG_Str2_Spannung "String 2 Spannung [%.0f V]" { http="<[http://pvserver:[email protected]/index.fhtml:60000:REGEX(.*?String 2</u></td>.*?Spannung</td>.*? (.*?)</td>.*)]" }
Number Solar_PVG_Str2_Strom "String 2 Strom [%.2f A]" { http="<[http://pvserver:[email protected]/index.fhtml:60000:REGEX(.*?String 2</u></td>.*?Strom</td>.*? (.*?)</td>.*)]" }
/* Ausgangsleistung */
Number Solar_AL_L1_Spannung "L1 Spannung[%.0f V]" { http="<[http://pvserver:[email protected]/index.fhtml:60000:REGEX(.*?L1</u></td>.*?Spannung.*?Spannung</td>.*? (.*?)</td>.*)]" }
Number Solar_AL_L1_Leistung "L1 Leistug [%.0f W]" { http="<[http://pvserver:[email protected]/index.fhtml:60000:REGEX(.*?L1</u></td>.*?Leistung</td>.*? (.*?)</td>.*)]" }
Number Solar_AL_L2_Spannung "L2 Spannung [%.0f V]" { http="<[http://pvserver:[email protected]/index.fhtml:60000:REGEX(.*?L2</u></td>.*?Spannung.*?Spannung</td>.*? (.*?)</td>.*)]" }
Number Solar_AL_L2_Leistung "L2 Leistug [%.0f W]" { http="<[http://pvserver:[email protected]/index.fhtml:60000:REGEX(.*?L2</u></td>.*?Leistung</td>.*? (.*?)</td>.*)]" }
Number Solar_AL_L3_Spannung "L3 Spannung [%.0f V]" { http="<[http://pvserver:[email protected]/index.fhtml:60000:REGEX(.*?L3</u></td>.*?Spannung</td>.*? (.*?)</td>.*)]" }
Number Solar_AL_L3_Leistung "L3 Leistug [%.0f W]" { http="<[http://pvserver:[email protected]/index.fhtml:60000:REGEX(.*?L3</u></td>.*?Leistung</td>.*? (.*?)</td>.*)]" }
Make sure you replace "password" with your password and edit the ip address!
This a simple example of how to command your tellstick devices from Openhab. For event triggered inbound integration, check the Integration with other applications page.
Please note that if you use the inbound integration you must name you item td_device_<number> where <number> is the tellstick device enumeration as listed from command: tdtool -l. Obviously you also need to change enumeration after --on and --off in the exec binding.
Item definition:
Switch td_device_5 "Tellstick device 5" {exec=">[ON:tdtool --on 5] >[OFF:tdtool --off 5]"}
This is an example of how to power on a TV connected to the openhab server via HDMI. First you have to install cec-client utility on your host (you can see more details in [page)
The next thing is use the exec and the samsung binding (I can't switch on the TV with the samsung binding, and I can't switch off with the cec-client). My item definition shows like:
Switch TV_GF_Living_TV_power "Power" (GF_Living_TV) { exec="ON:/usr/local/bin/samsungTvStart.sh, OFF:/bin/true", samsungtv="OFF:Livingroom:KEY_POWEROFF, ON:Livingroom:KEY_POWERON" }
And the script /usr/local/bin/samsungTvStart.sh is
echo 'on 0' | cec-client -s
The next thing is automatically check and update the status. I use a shell script that I run every minute with cron. The script /usr/local/bin/samsungTvCheck.sh is
#!/bin/bash
OH_URL=[OPENHAB_URL]
OH_USER=[OPENHAB_USER]
OH_PASS=[OPENHAB_PASS]
OH_ITEM=[OPENHAB_ITEM]
RESULT=`echo pow 0 | cec-client -d 1 -s | grep "power status:" | awk '{ print $3; }'`
case $RESULT in
on)
curl --user $OH_USER:$OH_PASS --max-time 2 --connect-timeout 2 --header "Content-Type: text/plain" --request PUT --data "ON" $OH_URL/rest/items/$OH_ITEM/state
exit 0
;;
*)
curl --user $OH_USER:$OH_PASS --max-time 2 --connect-timeout 2 --header "Content-Type: text/plain" --request PUT --data "OFF" $OH_URL/rest/items/$OH_ITEM/state
exit 1
esac
and you can add a line to your cron (in linux systems) with the command
crontab -e
*/1 * * * * /usr/local/bin/samsungTvCheck.sh
Note that you have to change OPENHAB_URL, [OPENHAB_PASS and [OPENHAB_ITEM] according to your installation. This script update the status of the item, and you can see if your childs has switch on the tv ;)