WF_PsPollEnable Function

Microchip TCP/IP Stack

Microchip TCP/IP Stack Help
WF_PsPollEnable Function
C
void WF_PsPollEnable(
    BOOL rxDtim
);
Description

Enables PS Poll mode. PS-Poll (Power-Save Poll) is a mode allowing for longer battery life. The MRF24W coordinates with the Access Point to go to sleep and wake up at periodic intervals to check for data messages, which the Access Point will buffer. The listenInterval in the Connection Algorithm defines the sleep interval. By default, PS-Poll mode is disabled. 

When PS Poll is enabled, the WF Host Driver will automatically force the MRF24W to wake up each time the Host sends Tx data or a control message to the MRF24W. When the Host message transaction is complete the MRF24W driver will automatically re-enable PS Poll mode. 

When the application is likely to experience a high volume of data traffic then PS-Poll mode should be disabled for two reasons:

  1. No power savings will be realized in the presence of heavy data traffic.
  2. Performance will be impacted adversely as the WiFi Host Driver continually activates and deactivates PS-Poll mode via SPI messages.
Preconditions

MACInit must be called first.

Parameters
Parameters 
Description 
rxDtim 
TRUE listens at the DTIM interval and FALSE listens at the CASetListenInterval 
Returns

None.

Remarks

None.

Microchip TCP/IP Stack 5.42.08 - June 15, 2013
Copyright © 2012 Microchip Technology, Inc.  All rights reserved.