====== WOL (Wake-On-Lan) ======

===== Introduction =====

This document mainly introduces WOL. You will learn how to enable WOL and wake up through WOL. The first part of the document describes the usage under Ubuntu, and the second part describes the usage under Android.

<WRAP info >
Wake-On-LAN (WOL) is a protocol standard that allows your PC/Smartphone to turn on a computer via your local network.
</WRAP>

===== Ubuntu =====

==== Get Ethernet MAC Address ====

The Mac address is pasted onto the back of your SBC:

<tabbox VIM2> 
{{/products:sbc:common:configurations:wol-vim2.png?600|wol-vim2}}
<tabbox VIM3/3L> 
{{/products:sbc:common:configurations:wol-vim3.png?600|wol-vim3}}
<tabbox VIM4> 
{{/products:sbc:common:configurations:wol-vim4.png?600|wol-vim4}}
<tabbox Edge1> 
{{/products:sbc:common:configurations:wol-edge.jpg?600|wol-edge}}
</tabbox>

If the sticker has peeled-off, you can use following Terminal commands to get the MAC Address.

On Ubuntu, type ''ifconfig'' on terminal.

```shell
$ ifconfig
eth0      Link encap:Ethernet  HWaddr 98:aa:fc:60:46:de
          inet addr:192.168.1.142  Bcast:192.168.1.255  Mask:255.255.255.0 
          inet6 addr: fe80::9aaa:fcff:fe60:46de/64 Scope: Link
```

HWaddr ''98:aa:fc:60:46:de'' corresponds to your Ethernet MAC address.

==== Enable WOL ====

=== Enable with U-Boot ===


By default Wake-On-LAN is disabled. So you’ll have to use the [[/products/sbc/common/development/kbi|Khadas Bootloader Instructions (KBI)]]to enable it.

```shell
kvim2# kbi trigger wol w 1

```

If you want to check the WOL status, you can input:

```shell
kvim2# kbi trigger wol r
boot wol: enable
```

=== Enable with Ubuntu ===

You can enable WOL via the ''Applications''->''Wake On LAN Setting''.

{{products:sbc:common:configurations:vim2-ubuntu-wol1.png|vim2-ubuntu-wol1}}

Select WOL mode.

{{products:sbc:common:configurations:vim2-ubuntu-wol2.png|vim2-ubuntu-wol2}}

==== Testing WOL ====

After doing the steps above, you can test the WOL function.

  - Connect with a LAN.
  - Power off.
  - Attempt to wake up, via a Ubuntu device on the same LAN.
    - Install the wakeonlan tool. \\ ```shell
$ sudo apt-get install wakeonlan
```
    - Wake up your VIM2 using it’s MAC Address. \\ ```shell
$ wakeonlan 98:aa:fc:60:46:de
```

===== See Also =====

[[/products/sbc/common/development/kbi|KBI(Khadas Bootloader Instructions)]]