m2m_wifi_handle_events

Functions
NMI_API sint8	m2m_wifi_handle_events (void *arg)

Detailed Description

Synchronous M2M event handler function, responsible for handling interrupts received from the WINC firmware. Application developers should call this function periodically in-order to receive the events that are to be handled by the callback functions implemented by the application.

Function Documentation

m2m_wifi_handle_events()

NMI_API sint8 m2m_wifi_handle_events

(

void *

arg

)

Handle the varios events received from the WINC board. Whenever an event happen in the WINC board (e.g. Connection, Disconnection , DHCP .. etc), WINC will interrupt the host to let it know that a new event has occured. The host driver will attempt to handle these events whenever the host driver decides to do that by calling the "m2m_wifi_handle_events" function. It's mandatory to call this function periodically and independantly of any other condition. It's ideal to include this function in the main and the most frequent loop of the host application.

Precondition

Prior to receiving events, the WINC driver should have been successfully initialized by calling the m2m_wifi_init function.

Warning

Failure to successfully complete this function indicates bus errors and hence a fatal error that will prevent the application from proceeding.

Returns

The function returns M2M_SUCCESS for successful interrupt handling and a negative value otherwise.