Mistake on this page?
Report an issue in GitHub or email us
Functions
WHD Wi-Fi Power Save API

Wi-Fi functions for WLAN low power modes. More...

Functions

uint32_t whd_wifi_enable_powersave (whd_interface_t ifp)
 Enables powersave mode on specified interface without regard for throughput reduction. More...
 
uint32_t whd_wifi_enable_powersave_with_throughput (whd_interface_t ifp, uint16_t return_to_sleep_delay)
 Enables powersave mode on specified interface while attempting to maximise throughput. More...
 
uint32_t whd_wifi_get_powersave_mode (whd_interface_t ifp, uint32_t *value)
 Get powersave mode on specified interface. More...
 
uint32_t whd_wifi_disable_powersave (whd_interface_t ifp)
 Disables 802.11 power save mode on specified interface. More...
 

Detailed Description

Wi-Fi functions for WLAN low power modes.

Function Documentation

uint32_t whd_wifi_disable_powersave ( whd_interface_t  ifp)

Disables 802.11 power save mode on specified interface.

Parameters
ifpPointer to handle instance of whd interface
Returns
WHD_SUCCESS if power save mode was successfully disabled Error code if power save mode was not successfully disabled
uint32_t whd_wifi_enable_powersave ( whd_interface_t  ifp)

Enables powersave mode on specified interface without regard for throughput reduction.

This function enables (legacy) 802.11 PS-Poll mode and should be used to achieve the lowest power consumption possible when the Wi-Fi device is primarily passively listening to the network

Parameters
ifpPointer to handle instance of whd interface
Returns
WHD_SUCCESS or Error code
uint32_t whd_wifi_enable_powersave_with_throughput ( whd_interface_t  ifp,
uint16_t  return_to_sleep_delay 
)

Enables powersave mode on specified interface while attempting to maximise throughput.

Network traffic is typically bursty. Reception of a packet often means that another packet will be received shortly afterwards (and vice versa for transmit).

In high throughput powersave mode, rather then entering powersave mode immediately after receiving or sending a packet, the WLAN chip waits for a timeout period before returning to sleep.

Parameters
ifpPointer to handle instance of whd interface
return_to_sleep_delayThe variable to set return to sleep delay. return to sleep delay must be set to a multiple of 10 and not equal to zero.
Returns
WHD_SUCCESS if power save mode was successfully enabled Error code if power save mode was not successfully enabled
uint32_t whd_wifi_get_powersave_mode ( whd_interface_t  ifp,
uint32_t *  value 
)

Get powersave mode on specified interface.

Parameters
ifpPointer to handle instance of whd interface
valueValue of the current powersave state PM1_POWERSAVE_MODE, PM2_POWERSAVE_MODE, NO_POWERSAVE_MODE
Returns
WHD_SUCCESS or Error code
Important Information for this Arm website

This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies. If you are not happy with the use of these cookies, please review our Cookie Policy to learn how they can be disabled. By disabling cookies, some features of the site will not work.