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]" }