WINC1500 IoT Software APIs: m2m_wifi_default_connect

WINC1500 IoT Software API

WINC1500 IoT Software APIs  19.5.2
WINC Software API Reference Manual
m2m_wifi_default_connect

Functions

NMI_API sint8 m2m_wifi_default_connect (void)
 

Detailed Description

Asynchronous Wi-Fi connection function. An application calling this function will cause the firmware to correspondingly connect to the last successfully connected AP from the cached connections. A failure to connect will result in a response of M2M_WIFI_RESP_DEFAULT_CONNECT indicating the connection error as defined in the structure tstrM2MDefaultConnResp. Possible errors are: The connection list is empty M2M_DEFAULT_CONN_EMPTY_LIST or a mismatch for the saved AP name M2M_DEFAULT_CONN_SCAN_MISMATCH. only difference between this function and m2m_wifi_connect, is the connection parameters. Connection using this function is expected to connect using cached connection parameters.

Function Documentation

◆ m2m_wifi_default_connect()

NMI_API sint8 m2m_wifi_default_connect ( void  )

Connect to the last successfully connected AP from the cached connections.

Precondition
Prior to connecting, the WINC driver should have been successfully initialized by calling the m2m_wifi_init function.
Warning
This function must be called in station mode only. It's important to note that successful completion of a call to m2m_wifi_default_connect() does not guarantee success of the WIFI connection, and a negative return value indicates only locally-detected errors.
See also
m2m_wifi_connect
Returns
The function returns M2M_SUCCESS for successful operations and a negative value otherwise.
Generated on Thu Jan 26 2017 22:15:21 for WINC1500 IoT Software APIs by   doxygen 1.8.13