openhab-docs/_bindings/wemo/readme.md

123 lines
4.6 KiB
Markdown

---
id: wemo
label: Belkin Wemo
title: Belkin Wemo - Bindings
type: binding
description: "This binding integrates the [Belkin WeMo Family](http://www.belkin.com/us/Products/c/home-automation/)."
since: 2x
logo: images/addons/wemo.png
install: auto
---
<!-- Attention authors: Do not edit directly. Please add your changes to the appropriate source repository -->
{% include base.html %}
# Belkin Wemo Binding
This binding integrates the [Belkin WeMo Family](http://www.belkin.com/us/Products/c/home-automation/).
The integration happens either through the WeMo-Link bridge, which acts as an IP gateway to the ZigBee devices or through WiFi connection to standalone devices.
## Supported Things
The WeMo Binding supports the Socket, Insight, Lightswitch, Motion and Maker devices, as well as the WeMo-Link bridge with WeMo LED bulbs.
## Discovery
The WeMo devices are discovered through UPnP discovery service in the network. Devices will show up in the inbox and can be easily added as Things.
## Binding Configuration
The binding does not need any special configuration
## Thing Configuration
For manual Thing configuration, one needs to know the UUID of a certain WeMo device.
In the thing file, this looks e.g. like
```
wemo:socket:Switch1 [udn="Socket-1_0-221242K11xxxxx"]
```
For a WeMo Link bridge and paired LED Lights, please use the following Thing definition
```
Bridge wemo:bridge:Bridge-1_0-231445B01006A0 [udn="Bridge-1_0-231445B010xxxx"] {
MZ100 94103EA2B278xxxx [ deviceID="94103EA2B278xxxx" ]
MZ100 94103EA2B278xxxx [ deviceID="94103EA2B278xxxx" ]
}
```
## Channels
Devices support some of the following channels:
| Channel Type ID | Item Type | Description |
|-----------------|------------------------|--------------|----------------- |------------- |
| motionDetection | Switch | On if motion is detected, off otherwise. (Motion Sensor only) |
| lastMotionDetected | DateTime | Representing the Date and Time when the last motion was detected. (Motion Sensor only) |
| state | Switch | This channel controls the actual binary State of a Device or represents Motion Detection. |
| lastChangedAt | DateTime | Representing the Date and Time the device was last turned on or of. |
| lastOnFor | Number | Time in seconds an Insight device was last turned on for. |
| onToday | Number | Time in seconds an Insight device has been switched on today. |
| onTotal | Number | Time in seconds an Insight device has been switched on totally. |
| timespan | Number | Time in seconds over which onTotal applies. Typically 2 weeks except first used. |
| averagePower | Number | Average power consumption in Watts.
| currentPower | Number | Current power consumption of an Insight device. 0 if switched off. |
| energyToday | Number | Energy in Wh used today. |
| energyTotal | Number | Energy in Wh used in total. |
| standbyLimit | Number | Minimum energy draw in W to register device as switched on (default 8W, configurable via WeMo App). |
| brightness | Number | Brightness of a WeMo LED. |
## Full Example
demo.things:
```
wemo:socket:Switch1 [udn="Socket-1_0-221242K11xxxxx"]
wemo:motion:Sensor1 [udn="Sensor-1_0-221337L11xxxxx"]
Bridge wemo:bridge:Bridge-1_0-231445B010xxxx [udn="Bridge-1_0-231445B010xxxx"] {
MZ100 94103EA2B278xxxx [ deviceID="94103EA2B278xxxx" ]
MZ100 94103EA2B278xxxx [ deviceID="94103EA2B278xxxx" ]
}
```
demo.items:
```
Switch DemoSwitch { channel="wemo:socket:Switch1:state" }
Switch LightSwitch { channel="wemo:lightswitch:Lightswitch1:state" }
Switch MotionSensor { channel="wemo:Motion:Sensor1:motionDetection" }
Switch MotionDetected { channel="wemo:Motion:Sensor1:lastMotionDetected" }
Number InsightPower { channel="wemo:insight:Insight1:currentPower" }
Number InsightLastOn { channel="wemo:insight:Insight1:lastOnFor" }
Number InsightToday { channel="wemo:insight:Insight1:onToday" }
Number InsightTotal { channel="wemo:insight:Insight1:onTotal" }
Switch LED1 { channel="wemo:MZ100:Bridge-1_0-231445B010xxxx:94103EA2B278xxxx:state" }
Dimmer dLED1 { channel="wemo:MZ100:Bridge-1_0-231445B010xxxx:94103EA2B278xxxx:brightness" }
Switch LED2 { channel="wemo:MZ100:Bridge-1_0-231445B010xxxx:94103EA2B278xxxx:state" }
Dimmer dLED2 { channel="wemo:MZ100:Bridge-1_0-231445B010xxxx:94103EA2B278xxxx:brightness" }
```
demo.sitemap:
```
sitemap demo label="Main Menu"
{
Frame label="WeMo" {
Switch item=DemoSwitch
Switch item=LightSwitch
Switch item=MotionSensor
Number item=InsightPower
Number item=InsightLastOn
Number item=InsightToday
Number item=InsightTotal
Switch item=LED1
Slider item=dLED1
Switch item=LED2
Slider item=dLED2
}
}
```