WM_EnableForListening 

Syntax

#include <nitro/wm.h>

WMErrCode WM_EnableForListening( WMCallbackFunc callback, BOOL blink );

Arguments

callback Designates the callback function to call when the asynchronous process completes. This callback is called from within the interrupt handler.
blink Specifies TRUE if the power LED is flashing at variable speed.

Return Values

Returns the results of the WMErrCode enumerated type process.

Description

Puts the wireless hardware enabled in receive-only mode. If this function's return value is WM_ERRCODE_OPERATING, a callback will be called after the wireless hardware enable process completes. This function can only be called when the WM is in the READY state. After completion, the WM will move to the STOP state. To start communications after this function is called, you must use WM_PowerOn to start providing power to the wireless hardware.

Unlike WM_Enable, operations that require transmitting wireless signals will not be available if this function is used for initialization. In exchange, it is possible to make the power LED stop flashing. Scanning in passive mode and measuring channel availability are examples of operations that do not require transmitting wireless signals.

See Also

WM_Enable, WM_Init, WM_PowerOn, WM_PowerOff, WM_Disable, WM_Finish, WM_InitializeForListening, WM_End

Revision History

2007/11/12 Initial version.


CONFIDENTIAL