This page is part of archived documentation for openHAB 3.3. Go to the current stable version
# Herzborg Binding
This binding supports smart curtain motors by Herzborg (http://www.herzborg.com/pro_list.aspx?TypeID=1 (opens new window))
# Supported Things
herzborg
A bridge thing that connects to a RS485 serial bus.curtain
A curtain motor thing that can be controlled via theherzborg
bridge .
The binding was developed and tested using DT300TV-1.2/14 type motor; others are expected to be compatible
# Discovery
Due to nature of serial bus being used, no automatic discovery is possible.
# Thing Configuration
# Serial Bus Bridge (id "serial_bus")
Parameter | Meaning |
---|---|
port | Serial port name to use |
Herzborg devices appear to use fixed 9600 8n1 communication parameters, so no other parameters are needed
# Curtain Motor Thing (id "curtain")
Parameter | Meaning |
---|---|
address | Address of the motor on the serial bus. |
poll_interval | Polling interval in seconds |
# Channels
channel | type | description | Read-only |
---|---|---|---|
position | RollerShutter | Controls position of the curtain. Position reported back is in percents; 0 - fully closed; 100 - fully open | N |
mode | String | Reports current motor mode: | Y |
0 - Stop | |||
1 - Open | |||
2 - Close | |||
3 - Setting | |||
reverse | Switch | Reverses direction when switched on | N |
handStart | Switch | Enable / disable hand start function | N |
extSwitch | String | External (low-voltage) switch mode: | N |
1 - dual channel biased switch | |||
2 - dual channel rocker switch | |||
3 - DC246 electronic switch | |||
4 - single button cyclic switch | |||
hvSwitch | String | Main (high-voltage) switch mode: | N |
0 - dual channel biased switch | |||
1 - hotel mode(power on while card in) | |||
2 - dual channel rocker switch |
All the channels are read-write
# Example
herzborg.things:
Bridge herzborg:serial_bus:my_herzborg_bus [ port="/dev/ttyAMA1" ]
{
Thing herzborg:curtain:livingroom [ address=1234, poll_interval=1 ]
}
herzborg.items:
Rollershutter LivingRoom_Window {channel="herzborg:curtain:livingroom:position"}
herzborg.sitemap:
Frame label="Living room curtain"
{
Switch item=LivingRoom_Window label="Control" mappings=["DOWN"="Close", "STOP"="Stop", "UP"="Open"]
Slider item=LivingRoom_Window label="Position [%d %%]" minValue=0 maxValue=100
}
Caught a mistake or want to contribute to the documentation? Edit this page on GitHub (opens new window)