WM_StartDCF

Syntax

#include <nitro/wm.h>

WMErrCode WM_StartDCF(
        WMCallbackFunc  callback ,
        WMDcfRecvBuf*   recvBuf ,
        u16             recvBufSize
);

Arguments

callback Specifies the callback function to be called when the notification of the status for the asynchronous process is sent or when the asynchronous process completes. This callback is called from within the interrupt handler.
recvBuf Pointer to the data receive buffer. Because the ARM7 processor writes directly to the buffer, be careful of coherency with the cache.
recvBufSize Size of the data receive buffer.

Return Values

Returns the results of the WMErrCode enumerated type process.

Description

Starts infrastructure mode communications. This function is only executable when the WM is in the CHILD state. If the return value is WM_ERRCODE_OPERATING, a callback is generated after the communication mode change process is complete. The WM changes to the DCF CHILD state. A callback is also generated when the data is received in the infrastructure mode.

Notes

The recvBuf data is forcibly stored in the internal cache. To avoid overwriting surrounding memory regions, be sure to pass data that is 32-byte aligned.
See the Wireless Communication Library Manual (AboutWirelessManager.pdf) for additional details.

See Also

WM_SetDCFData, WM_EndDCF

Revision History

2008/12/17 Added a note about how data passed in arguments is forcibly cached internally.
2005/06/08 Added the fact that the callback is called from the interrupt handler.
2004/10/22 Changed the type of return values.
2004/08/02 Standardized structure names.
2004/07/29 Added to Description.
2004/07/23 Initial version.


CONFIDENTIAL