wolz/README.md

Woly

Broadcast Wake on Lan (WoL) magic packet to network devices in the local network.

Installation

Install cargo

cargo install --git <thisRepoUrl>

Usage

woly aa:bb:cc:dd:ee:ff

or define a nickname in woly.conf as

idly=aa:bb:cc:dd:ee:ff

woly idly

Magic Packet

Magic packet is constructed as follows

FF x 6; Mac Address x 16

eg.

FF FF FF FF FF FF
AA BB CC DD EE FF
AA BB CC DD EE FF
AA BB CC DD EE FF
AA BB CC DD EE FF
AA BB CC DD EE FF
AA BB CC DD EE FF
AA BB CC DD EE FF
AA BB CC DD EE FF
AA BB CC DD EE FF
AA BB CC DD EE FF
AA BB CC DD EE FF
AA BB CC DD EE FF
AA BB CC DD EE FF
AA BB CC DD EE FF
AA BB CC DD EE FF
AA BB CC DD EE FF

Target Destination

The magic packet shall be sent to limited broadcast IP - 255.255.255.255 and the Discard Protocol Port 9.

While sending it to targeted IP, for eg. 192.168.0.2 bound to desired mac address of the device might work, it is not reliable as sometimes the ARP cache will not be updated by router due to device being in low power mode and will drop this packet.