m2m_wifi_get_connection_info

Functions
NMI_API sint8	m2m_wifi_get_connection_info (void)

Detailed Description

Asynchronous connection status retrieval function, retrieves the status information of the currently connected AP. The result is passed to the Wi-Fi notification callback through the event M2M_WIFI_RESP_CONN_INFO. Connection information is retrieved from the structure tstrM2MConnInfo.

Function Documentation

m2m_wifi_get_connection_info()

sint8 m2m_wifi_get_connection_info

(

void

)

Retrieve the current Connection information. The result is passed to the Wi-Fi notification callback with M2M_WIFI_RESP_CONN_INFO.

Precondition

• A Wi-Fi notification callback of type tpfAppWifiCb MUST be implemented and registered at startup. Registering the callback is done through passing it to the initialization m2m_wifi_init function.
• The event M2M_WIFI_RESP_CONN_INFO must be handled in the callback to receive the requested connection info.

Connection Information retrieved:

-Connection Security
-Connection RSSI
-Remote MAC address
-Remote IP address

and in case of WINC station mode the SSID of the AP is also retrieved.

Warning

-In case of WINC AP mode or P2P mode, ignore the SSID field (NULL string).

See also

M2M_WIFI_RESP_CONN_INFO, tstrM2MConnInfo

Returns

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

Example

The code snippet shows an example of how wi-fi connection information is retrieved .

#include "m2m_wifi.h"
#include "m2m_types.h"


void wifi_event_cb(uint8 u8WiFiEvent, void * pvMsg)
{
 switch(u8WiFiEvent)
    {
 case M2M_WIFI_RESP_CONN_INFO:
        {
 tstrM2MConnInfo     *pstrConnInfo = (tstrM2MConnInfo*)pvMsg;
 
            printf("CONNECTED AP INFO\n");
            printf("SSID                : %s\n",pstrConnInfo->acSSID);
            printf("SEC TYPE            : %d\n",pstrConnInfo->u8SecType);
            printf("Signal Strength     : %d\n", pstrConnInfo->s8RSSI); 
            printf("Local IP Address    : %d.%d.%d.%d\n", 
                pstrConnInfo->au8IPAddr[0] , pstrConnInfo->au8IPAddr[1], pstrConnInfo->au8IPAddr[2], pstrConnInfo->au8IPAddr[3]);
        }
 break;

 case M2M_WIFI_REQ_DHCP_CONF:
        {
 // Get the current AP information.
 m2m_wifi_get_connection_info();
        }
 break;
 default:
 break;
    }
}

int main()
{
 tstrWifiInitParam   param;
 
    param.pfAppWifiCb   = wifi_event_cb;
 if(!m2m_wifi_init(&param))
    {
 // connect to the default AP
 m2m_wifi_default_connect();
 
 while(1)
        {
 m2m_wifi_handle_events(NULL);
        }
    }
}