Wake up devices connected to your local network from anywhere using Raspberry Pi.
- Button [GPIO17]: Enables/disables the board
- Button [GPIO27]: Powers off the operating system.
- LED [GPIO22]: Indicates that the operating system has successfully booted up.
- LED [GPIO04]: Indicates that internet connection is available.
- LED [GPIO05]: Indicates that a wol request has been received or when the operating system has started.
- LED [GPIO26]: Indicates an error or when the operating system is being powered off.
- GPIO06: Connected to a pull-up resistor and used to check if the board is connected to the device or not.
- wiringPi
- pthread
| Pi Pin | wiringPi |
|---|---|
| GPIO04 | 7 |
| GPIO05 | 21 |
| GPIO06 | 22 |
| GPIO17 | 0 |
| GPIO22 | 3 |
| GPIO26 | 25 |
| GPIO27 | 2 |
For more information about Pi 2 Model B pins mapping check: Raspberry Pi 2 Model B Pinout
The compiled binary in the server folder when executed will start a UDP Socket server listening on port 5649 for incoming wol requests.
- To listen for requests as soon as the Raspberry Pi device has powered on, we need to run the server at startup.
One way to do that is to add a command to the end of the/etx/rc.localfile just before theexit 0line:
/path/to/socket/server/directory/server >> /var/log/wol-errors 2>&1 &
This command will run the script on startup using sudo privilage and save the outputs into a log file saved in /var/log/wol-errors.
2. To be able to connect to this server remotely, port-forwarding needs to be configured on the router to forward traffic on UDP port 5649 to Raspberry Pi.
3. The server needs the broadcast ip address for the local network on which Raspberry Pi is connected to. The broadcast ip need to be added into the wol.conf file. For example:
broadcast ip = 192.168.1.255
- To send wol requests, a connection needs to be established first and then a magic packet needs to be sent. Once received the server will forward it to the broadcasting ip found in
wol.confwhich in turn will be forwarded to the destination device matching theMACaddress found in the packet. Then if the destination device is configured with the wake-on-lan feature enabled, it will boot up.
A magic packet is a broadcast frame containing 6 bytes of all 255 (FF FF FF FF FF FF), followed by 16 repititions of the destination's MAC address. The total length of the packet is 102 bytes.
For example to send a magic packet to a netword device with a MAC address of B0:36:81:C4:C3:9F, the following magic packet needs to be sent:
FF FF FF FF FF FF B0 36 81 C4 C3 9F B0 36 81 C4 C3 9F B0 36 81 C4 C3 9F B0 36 81 C4 C3 9F
B0 36 81 C4 C3 9F B0 36 81 C4 C3 9F B0 36 81 C4 C3 9F B0 36 81 C4 C3 9F B0 36 81 C4 C3 9F
B0 36 81 C4 C3 9F B0 36 81 C4 C3 9F B0 36 81 C4 C3 9F B0 36 81 C4 C3 9F B0 36 81 C4 C3 9F
B0 36 81 C4 C3 9F B0 36 81 C4 C3 9F B0 36 81 C4 C3 9F
Provides a user interface over the web to send wol requests to Raspberry Pi. The web server was mainly intended for testing.
To be able to access the website remotely, port-forwarding settings need to be configured on the router to allow incoming traffic on port 80 to be forwarded to Raspberry Pi.
- A running http server such as Apache.
- A compiled wol-cli binary added to web server directory with the name "wol".
MIT License
Copyright (c) 2021 AR Cheikhmeri
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.