mirror of
https://github.com/openhab/openhab-addons.git
synced 2025-01-10 23:22:02 +01:00
82 lines
3.4 KiB
Markdown
82 lines
3.4 KiB
Markdown
|
# TouchWand Binding
|
||
|
|
|
||
|
|
Touchwand Wanderfull™ Hub basic is a plug & play Z-Wave based controller that uses Wi-Fi and Bluetooth to easily connect all smart home components.
|
||
|
|
TouchWand products are compatible with most major Z-Wave products, IP controlled devices and KNX devices, providing the ideal solution for building all-inclusive full-featured smart homes.
|
||
|
|
[TouchWand.com](http://www.touchwand.com)
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
## Supported Things
|
||
|
|
|
||
|
|
This binding supports switches, shutters dimmers and wall controllers configured in Touchwand Wanderfull™ Hub Controller.
|
||
|
|
|
||
|
|
## Control
|
||
|
|
|
||
|
|
1. **switch** - control - ON/OFF
|
||
|
|
2. **shutter** - control - UP/DOWN/STOP
|
||
|
|
3. **dimmer** - control - ON/OFF/BRIGHTNESS
|
||
|
|
4. **wallcontroller** - control - LONG/SHORT
|
||
|
|
|
||
|
|
## Discovery
|
||
|
|
|
||
|
|
After adding TouchWand Hub the auto discovery will add all switches dimmers and shutters to the inbox.
|
||
|
|
|
||
|
|
## Bridge Configuration
|
||
|
|
|
||
|
|
**Touchwand Wanderfull™** Hub Controller need to be added manually by IP address. The controller requires **username** and **password**
|
||
|
|
|
||
|
|
| Parameter | Description | Units | required |
|
||
|
|
|-------------------|-----------------------------------------------------------------------|---------|----------|
|
||
|
|
| username | Touchwand hub username | string | yes |
|
||
|
|
| password | Touchwand hub password | string | yes |
|
||
|
|
| ipAddress | Touchwand hub hotname or IP address | string | yes |
|
||
|
|
| port | Management port (default 80) | integer | no |
|
||
|
|
| statusrefresh | Unit status refresh interval in seconds | integer | no |
|
||
|
|
| addSecondaryUnits | If the controller is primary, add secondary controllers units as well | bool | no |
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
## Thing Configuration
|
||
|
|
|
||
|
|
No thing configuration is needed
|
||
|
|
|
||
|
|
## Full Example
|
||
|
|
|
||
|
|
### touchwand.things
|
||
|
|
|
||
|
|
Things can be defined manually
|
||
|
|
The syntax for touchwand this is
|
||
|
|
|
||
|
|
```xtend
|
||
|
|
Thing <binding_id>:<type_id>:<thing_id> "Label" @ "Location"
|
||
|
|
```
|
||
|
|
|
||
|
|
Where <thing_id> is the unit id in touchwand hub.
|
||
|
|
|
||
|
|
```
|
||
|
|
Bridge touchwand:bridge:1921681116 [ipAddress="192.168.1.116", username="username" , password="password"]{
|
||
|
|
Thing switch 408 "Strairs light"
|
||
|
|
Thing switch 411 "South Garden light"
|
||
|
|
Thing dimmer 415 "Living Room Ceiling dimmer"
|
||
|
|
Thing switch 418 "Kitchen light"
|
||
|
|
Thing shutter 345 "Living Room North shutter"
|
||
|
|
Thing shutter 346 "Living Room South shutter"
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
### touchwand.items
|
||
|
|
|
||
|
|
```
|
||
|
|
/* Shutters */
|
||
|
|
Rollershutter Rollershutter_345 "Living Room North shutter" {channel="touchwand:shutter:1921681116:345:shutter"}
|
||
|
|
Rollershutter Rollershutter_346 "Living Room South shutter" {channel="touchwand:shutter:1921681116:346:shutter"}
|
||
|
|
```
|
||
|
|
|
||
|
|
```
|
||
|
|
/* Switches and Dimmers */
|
||
|
|
Switch Switch_408 "Strairs light" {channel="touchwand:switch:1921681116:408:switch"}
|
||
|
|
Switch Switch_411 "South Garden light" {channel="touchwand:switch:1921681116:411:switch"}
|
||
|
|
Dimmer Switch_415 "Living Room Ceiling dimmer" {channel="touchwand:switch:1921681116:415:switch"}
|
||
|
|
Switch Switch_418 "South Garden light" {channel="touchwand:switch:1921681116:418:switch"}
|
||
|
|
```
|