This page is part of archived documentation for openHAB 2.5. Go to the current stable version
# Wake-on-LAN Binding v1
The Wake-on-LAN binding allows you to turn on or wake up a computer by sending it a network message (opens new window).
# Prerequisites
For Windows computers not in a domain, the firewall must be configured properly (allow remote shutdowns) and the DWORD-Regkey LocalAccountTokenFilterPolicy in HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\System must be set to 1.
# Binding Configuration
The Wake-on-LAN binding does not have a configuration file.
# Item Configuration
The syntax for the Wake-on-LAN binding configuration string is explained here:
wol="<broadcast-IP>#<macaddress>"
NOTE: The <broadcast-IP> address is not the one from the machine you want to wake up - this is identified by MAC address. IP is the broadcast IP from the SubNet; Here some examples for a typical C class network: - 192.168.1.255 for the destination IP 192.168.1.10 - or 127.0.0.255 for 127.0.0.15.
Here are some examples of valid binding configuration strings:
wol="192.168.1.255#00:1f:d0:93:f8:b7"
wol="192.168.1.255#00-1f-d0-93-f8-b7"
As a result, your lines in the items file might look like the following:
Switch Network_OpenhabWebsite "openHAB Web" (Status, Network) { wol="192.168.1.255#00:1f:d0:93:f8:b7" }
# Examples
The item binding can be combined with an exec binding to be able to switch the system on and off. The example below works if openHAB is running on a windows host.
Switch networkPC "Computer" (network, gOGBuero) { wol="192.168.10.255#00-DE-AD-BE-EF-00", exec=">[OFF:shutdown -s -m \\\\192.168.10.23 -t 0 -f]" }
The example below is for openHab running on a linux host.
Switch networkPC "Computer" (network, gOGBuero) { wol="192.168.10.255#00-DE-AD-BE-EF-00", exec=">[OFF:net rpc shutdown -C MESSAGE -I 192.168.10.23 -U USER%%PASSWORD -f -t 120]" }