Reference Manual

Redpine Signals, Inc. Proprietary and Confidential Page 97
RS9116 n-Link Linux and Android
Technical Reference Manual
Version 2.0
18 Wake-On-Wireless LAN
18.1 WoWLAN through onebox_util
The parameters listed below for the Wake-On-Wireless LAN are valid only in Client mode. The <hw_bmiss> parameter
needs to be given as an input during VAP creation inorder to use the WoWLAN feature – refer to the section Configuring
Using onebox_util for details on VAP creation.
• <base_interface>: Base Interface (string like rpine0)
• <src_mac_addr>: This parameter is the 48-bit Source MAC address in hexadecimal format with colon separation,
which is used to filter the Unicast packets received by the device. This parameter is valid only when bit 2 of the
<wowlan_flags> parameter is set to '1'.
• <host_sleep_status>: This parameter informs the device whether the Host is entering sleep state ("1") or exiting sleep
state ("0"). The device will toggle the GPIO_2 (Host Wakeup Interrupt) only when the Host indicates that it is entering
to sleep state.
• <wowlan_flags>: This parameter is a bitmap used to program the device to wake up the Host based on the type of
packets received by it. It is a 16-bit value as explained in the table below. The Host can program multiple bits to "1" at
the same time to enable wakeup on different types of events.
Bit
[15:0]
Description
[15:4]
Reserved.
3
Wake up Host when EAPOL packets are received by the device
2
Wake up Host when Unicast packets from a specific MAC address (specified by <src_mac_addr> are received by
the device
1
Wake up Host when Unicast packets are received by the device
0
Wake up Host for any packet received by the device
Table 11: WoWLAN Flags
The above configuration is used only when you have kept the device in transmit burst mode and has made random
hopping as "enabled".
For more details in "Configuration of device in the transmit burst mode", please refer to the section BT Transmit
Tests.
18.2 WoWLAN using Linux power state machine
Linux supports different power states to handle power management i.e. S3 (suspend), S4 (hibernate) and S5 (poweroff).
WoWLAN can be verified through these power states which is the idle way. Presently only S3 is supported in N-Link Linux
driver. Also WoWLAN configuration is allowed in NL80211 interface only. Enable ONEBOX_CONFIG_WOWLAN in Makefile
to use this feature before building the driver. It supports kernel v3.11 or higher.
18.2.1 Overview
WoWLAN is a power saving technique where device goes to sleep until an explicit trigger is received through WLAN. For
this feature to work station should be connected to an AP and the connection should retain while the system is in
suspend. User shall configure WoWLAN trigger types like magic packet or pattern etc using which he wants to wake up the
system. This trigger packet will be received by the WLAN device through AP. Device firmware shall process the trigger and
check whether it is a valid trigger or not. If it is a valid trigger packet, it will trigger the GPIO of host wake-up. It is the
vendor responsibility to map this GPIO to the platform’s power module.
To verify WoWLAN below steps are needed:
• Configure WoWLAN
• Suspend the system