m2m_wifi_wps

Functions
NMI_API sint8	m2m_wifi_wps (uint8 u8TriggerType, const char *pcPinNumber)

Detailed Description

Asynchronous WPS triggering function. This function is called for the WINC to enter the WPS (Wi-Fi Protected Setup) mode. The result is passed to the Wi-Fi notification callback with the event M2M_WIFI_REQ_WPS.

Function Documentation

m2m_wifi_wps()

NMI_API sint8 m2m_wifi_wps	(	uint8	u8TriggerType,
		const char *	pcPinNumber
	)

Parameters

[in]	u8TriggerType	WPS Trigger method. Could be: WPS_PIN_TRIGGER Push button method WPS_PBC_TRIGGER Pin method
[in]	pcPinNumber	PIN number for WPS PIN method. It is not used if the trigger type is WPS_PBC_TRIGGER. It must follow the rules stated by the WPS standard.

Warning

This function is not allowed in AP or P2P modes.

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 m2m_wifi_init.
• The event M2M_WIFI_REQ_WPS must be handled in the callback to receive the WPS status.
• The WINC device MUST be in IDLE or STA mode. If AP or P2P mode is active, the WPS will not be performed.
• The m2m_wifi_handle_events MUST be called periodically to receive the responses in the callback.

See also

tpfAppWifiCb m2m_wifi_init M2M_WIFI_REQ_WPS tenuWPSTrigger tstrM2MWPSInfo

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 WPS is triggered .

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

void wifi_event_cb(uint8 u8WiFiEvent, void * pvMsg)
{
 switch(u8WiFiEvent)
    {
 case M2M_WIFI_REQ_WPS:
        {
 tstrM2MWPSInfo  *pstrWPS = (tstrM2MWPSInfo*)pvMsg;
 if(pstrWPS->u8AuthType != 0)
            {
                printf("WPS SSID           : %s\n",pstrWPS->au8SSID);
                printf("WPS PSK            : %s\n",pstrWPS->au8PSK);
                printf("WPS SSID Auth Type : %s\n",pstrWPS->u8AuthType == M2M_WIFI_SEC_OPEN ? "OPEN" : "WPA/WPA2");
                printf("WPS Channel        : %d\n",pstrWPS->u8Ch + 1);
 
 // establish Wi-Fi connection
 m2m_wifi_connect((char*)pstrWPS->au8SSID, (uint8)m2m_strlen(pstrWPS->au8SSID),
                    pstrWPS->u8AuthType, pstrWPS->au8PSK, pstrWPS->u8Ch);
            }
 else
            {
                printf("(ERR) WPS Is not enabled OR Timed out\n");
            }
        }
 break;
 
 default:
 break;
    }
}

int main()
{
 tstrWifiInitParam   param;
 
    param.pfAppWifiCb   = wifi_event_cb;
 if(!m2m_wifi_init(&param))
    {
 // Trigger WPS in Push button mode.
 m2m_wifi_wps(WPS_PBC_TRIGGER, NULL);
 
 while(1)
        {
 m2m_wifi_handle_events(NULL);
        }
    }
}