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);
 }
 }
}

WINC1500 IoT Software APIs: m2m_wifi_get_connection_info

WINC1500 IoT Software API

Functions

Detailed Description

Function Documentation

◆ m2m_wifi_get_connection_info()

Example

Get in touch